airiOS - Core

A container of souls - cyber livings, waifu, digital humans - brought into your Linux machine.

This fork's focus is creating desktop-native agentic OS centered around your AI companion.

---

🌙 The Vision: airiOS

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
• airiOS (WIP)
  • System tray & screen capture integration
  • Generate and open native GTK3/4 windows instead of web widgets
  • airiOS Linux API integration
  • airiOS Code integration
    • Send recent airiOS 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 airiOS localhost and cloud LLM API layers 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