A container of souls — cyber beings, waifus, and digital humans living 24/7 on your Linux machine.

AnimAIOS is focused on creating a desktop-native, agentic AI OS centered around your companion: a zero-config experience where you paste a free API key and 🚀

---

🌙 The Vision: AnimAIOS

Our goal is a Linux desktop experience where your AI companion acts as the center of your desktop environment:

• 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 into system fully, 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 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 (heartbeat)
  • Multi-tier memory based on openvault design
  • Per-character memory scoping that works with multiple-character being preset at the stage (witnesses)
• 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 stage (one window per character)
  • Widget system (to be converted to GTK)
  • Scene/background management per character
• AnimAIOS (WIP)
  • System tray & screen capture integration
  • Generate and open native GTK3/4 windows instead of web widgets
  • AnimAIOS Linux API integration
  • AnimAIOS Code integration
    • Send recent AnimAIOS Code context snapshot with each AIRI heartbeat
  • AIRI chatbox doubles as a system terminal with natural language detection
• Misc
  • DeepSource pass with 0 issues
  • LCov > 90% -> switch to TDD
  • Natural terminal command detection (similar to Warp terminal)
  • Add providers/mcp/skills via natural language prompts
  • Native Wayland Support using Ozone platform flags

---

🤖 LLM API Providers

• Supported providers: everything xsai supports
• Planned AnimAIOS localhost and (optional) cloud LLM API routers integration to replace default AIRI provider, good source of almost limitless free yummy tokens for your cyber waifus~

---

🙏 Acknowledgements

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