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

Full distro based on CachyOS coming soon!

---

🌙 The Vision

• Always-Present Stage: Your character lives on your desktop! She can open, close and switch between windows and most importantly read text in those windows through accessibility integration~
• System Integration: Hooks fully into the system, from basic stuff like notifications to fully managing your Linux via terminal in Agentic Mode
• Context Awareness: Your companion observes desktop activity to respond and interact proactively and she can also assume full desktop control in Agentic Mode
• Modular Stage Layouts: GTK3/4 widgets, interactively generated backgrounds through artistry module, and window layouts composed dynamically by characters

🖥️ 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 Linux MCP 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-based gamified energy system integration that will replace official AIRI provider, a limitless source of free yummy tokens for your cyber waifus~ Or just clone AnimaRouter and host it yourself with BYOK! UI will allow easy switch between hosted/localhost AnimaRouter providers!

---

🙏 Acknowledgements

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