🏗️airiOS🚧

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

Tip

This fork's focus is turning the Project AIRI vision into the ultimate dream of creating baremetal desktop agentic OS centered around your AI companion.

The original AIRI project provides a feature-rich foundation. This fork adopts a strict KISS philosophy to keep the codebase clean and cloud linter-friendly, with plans to transition to TDD.

While multi-platform compatibility is maintained, our primary optimization target is a lightweight Linux build. If you require broader cross-platform stability, please refer to dasilva333/airi or moeru-ai/airi.

^{Note: We aim to render AIRI directly as a desktop wallpaper on supported Linux compositors. If you have experience implementing desktop wallpapers for Windows or macOS (e.g., via Wallpaper Engine), contributions or issues are highly welcome!}

---

🌙 The Vision: airiOS

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

• Always-Present Stage: Your character lives on your desktop, not in a floating window or browser tab.
• System Integration: Hooks into notifications, screen capture, and global shortcuts.
• Context Awareness: Your companion observes desktop activity to respond and interact proactively.
• Modular Stage Layouts: GTK3/4 widgets, interactive backgrounds, and window layouts composed dynamically by the character.

---

🐧 Features & Architecture

We build directly upon the core strengths of the original project and selectively rebase dasilva333/airi changes on latest upstream:

• • Native Wayland Support: Out-of-the-box integration using Ozone platform flags, PipeWire screen capture, and window decorations.
• • AIRI Card System: High-fidelity character management. Import/export native JSON or SillyTavern-compatible chara_card_v2 PNGs. Features per-card model configurations and stage preferences.
• Multi-Tab Card Editor:
  • Acting: Manage model expressions, speech mannerisms, and ACT tokens.
  • Modules: Set specific speech engines, avatars, and models per character.
  • Artistry: Native image generation pipelines (Replicate, ComfyUI).
  • Proactivity: Define triggers for autonomous companion interactions.
• Dynamic Stage Widgets: Spawns and controls floating desktop widgets (weather, maps, or generic JSON payloads).
• Optimized Audio Pipeline: Low-latency speech path supporting OpenAI-compatible voice discovery.

---

🖥️ Development

☕ Prerequisites

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

🖱️ Quick Start

pnpm i
pnpm dev:tamagotchi

⌨️ Building for Linux

cd apps/stage-tamagotchi
./build.sh           # Builds the .deb package in dist/

(An optional PKGBUILD is located in apps/stage-tamagotchi to repackage the .deb into .zst for Arch/Manjaro/CachyOS).

❔ Troubleshooting

Electron build approvals (pnpm 10+):

pnpm approve-builds # Select 'electron' and confirm

---

🚙 Roadmap

• Brain
  • Multi-tier memory based on openvault design
  • Per-character memory scoping that works for multiple-character being preset at the stage, not gated by character card
• Heart
  • Heartbeat (proactivity)
• Ears
  • Client-side speech recognition & talking detection
• Mouth
  • OpenAI-compatible speech providers
    • with voice discovery
• Body
  • VRM support
    • with expression controls, auto-blink, and auto-look-at
  • Live2D support
    • with expression-oriented tools
• Desktop Stage
  • Multiple characters sharing the stage
  • Control Island with emotions, favorites, and idle-loop cycling
  • Widget system (weather, map, generic JSON) (to be converted to GTK)
  • Scene/background management per character
  • Window snapping and position persistence (this fork adapts single-window philosophy)
  • Native Wayland support
• airiOS (WIP)
  • System tray & screen capture integration
  • Generate and open native GTK3/4 windows instead of web widgets
  • computer-use-linux integration
  • AiRoo Code integration
    • Send recent AiRoo context snapshot with each AIRI heartbeat
  • Render AIRI as wlroots wallpaper if compatible compositor detected
  • AIRI chatbox integration 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 more providers to xsai
  • Add providers/mcp/skills via natural language prompts

---

🤖 LLM API Providers

Supported providers: everything xsai supports

---

🙏 Acknowledgements

• Original moeru-ai/airi project and dasilva333/airi fork
• Reka UI - UI components
• xsai - LLM interaction layer