AnimaCore is an agentic AI desktop OS built around your digital companion

---

🌙 The Vision

• Always-Present Stage: Your character lives on your desktop so she is always in control! She can open, close and switch between windows and most importantly read text in those windows through accessibility tools, not just rely on screenshotting everything~
• System Integration: Hooks fully into the system, from basic stuff like notifications and global shortcuts to fully managing your terminal!
• Context Awareness: Your companion observes desktop activity to respond and interact proactively and she might even take control if you let her (agentic mode)
• Modular Stage Layouts: GTK3/4 widgets, interactively generated backgrounds through artistry module, and window layouts composed dynamically by the character (she will always be on screen most of the time)

🖥️ Development

☕ Prerequisites

• Node.js >= 20.14.0
• pnpm >= 10.0.0

🖱️ Quick Start

pnpm i
pnpm dev:tamagotchi

❔ Troubleshooting

Electron build approvals (pnpm 10+):

pnpm approve-builds # Select 'electron' and confirm

🚙 Roadmap

• Brain
  • Artistry: Native image generation pipelines (Replicate, ComfyUI)
  • Proactivity: Define triggers for autonomous companion interactions (heartbeats)
  • Multi-tier memory: AnimaVault
    • Per-character memory scoping that works with witnesses (multiple-character sharing the screen)
• Ears
  • Client-side speech recognition & talking detection
• Mouth
  • OpenAI-compatible speech providers with voice discovery
• Body
  • VRM support
    • LLM-driven expression controls, auto-blink and auto-look-at
    • LLM-driven emotions and idle-loops
  • Live2D support
    • LLM-driven expression controls
• Desktop Stage
  • Multiple characters sharing the screen (KISS 1 window per character)
  • Scene/background management per character
• AnimAIOS (WIP)
  • System tray & screen capture integration
  • Generate native GTK3/4 windows instead of web widgets
  • AnimAIOS Devtools MCP deep integration
  • AnimAIOS Linux MCP deep integration
  • AnimAIOS Zed deep integration
    • Send recent context snapshot with each AIRI heartbeat
  • AIRI chatbox doubles as a system terminal with natural language detection (similar to Warp terminal)
• Misc
  • DeepSource pass with 0 issues
  • LCov > 90% -> switch to TDD
  • Add mcp/skills via natural language prompts
  • Native Wayland Support using Ozone platform flags

🤖 LLM API Providers

• Supported providers: everything xsai supports
• Planned AnimaRouter integration to replace official AIRI provider, a limitless source of free yummy tokens for your cyber waifus~

---

🙏 Acknowledgements

• moeru-ai/airi project and dasilva333/airi fork