moeru-ai/airi
⭐ 39,132 · TypeScript · GitHub Repo
💖🧸 Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.
ai-companion ai-vtuber airi digital-life grok-companion live2d neuro-sama neurosama
1-Sentence Summary
Self-hosted, open-source Neuro-sama alternative enabling real-time voice chat and game-playing AI companions.
🔥 Key Capabilities & USP
- Real-time Voice Chat: Enables natural, spoken conversations with your AI companion, solving the lack of interactive voice interaction in most AI tools. No cloud dependency ensures privacy.
- Game-Playing AI: The companion can actively play Minecraft and Factorio alongside you, transforming passive chatbots into co-op gaming partners—a unique feature absent from typical AI assistants.
- Self-Hosted & Open Source: You own the instance entirely, eliminating data privacy concerns and subscription fees. Full control over models, memory, and character behavior.
- Customizable Virtual Character: Supports Live2D and VRM models, letting you design a personalized waifu/digital being. Bridges VTuber culture with practical AI interaction.
- Cross-Platform Desktop App: Native installers for Windows, macOS, and Linux, plus a web version. No server rental or complex cloud setup required.
Technical Architecture
| Component | Details |
|---|---|
| Language | TypeScript (primary) |
| AI Models | Leverages ChatGPT, Claude, and other LLMs for roleplay & conversation |
| Sub-projects | Dedicated org (@proj-airi) with RAG, memory systems, embedded databases, Live2D utilities |
| Desktop Framework | Electron or similar (native installers for Windows .exe, macOS .dmg, Linux) |
| Character Rendering | Live2D & VRM model support |
| Voice Pipeline | Real-time voice chat (speech-to-text + text-to-speech) |
| Distribution | Scoop package manager (Windows), direct downloads |
Quick Start Guide
Windows (via Scoop):
scoop bucket add airi https://github.com/moeru-ai/airi
scoop install airi/airimacOS/Linux/Web: Download the latest native installer from the Releases page or use the web version directly.
Setup Logic: After installation, configure your preferred LLM API key (e.g., OpenAI, Anthropic), select a Live2D/VRM character model, and start chatting or gaming.
Pros, Cons & Use Cases
Pros
- Privacy-first: Self-hosted, no data leaves your machine.
- Unique gaming integration: AI plays Minecraft/Factorio with you—unmatched by any commercial product.
- Open source & extensible: Full code access, community-driven improvements.
- Cross-platform: Works on all major desktop OSes and web browsers.
- Active development: v0.9.0 release with dedicated sub-project organization.
Cons
- Requires technical setup: Self-hosting demands comfort with APIs, model configuration, and potential debugging.
- Still in development: v0.9.0 means occasional instability or missing features.
- No official token/crypto: Warning against scams—no minted cryptocurrency exists.
- Hardware dependent: Real-time voice and game AI may need decent GPU/CPU.
Who should NOT use this?
- Non-technical users seeking a plug-and-play commercial AI companion (e.g., Replika, Character.AI).
- Casual gamers who want simple voice assistants without game integration.
- Enterprise teams needing SLA-backed, managed AI services.
- Users expecting a finished product—this is pre-1.0 software.
Ideal Use Cases
- VTuber enthusiasts wanting a self-hosted Neuro-sama clone for streaming or personal interaction.
- AI developers experimenting with multimodal companions (voice + gaming + character rendering).
- Privacy-conscious users who refuse cloud AI companions.
- Minecraft/Factorio players seeking an AI co-op partner for building or automation.
- Waifu/digital life creators customizing Live2D/VRM models with conversational AI.
Community & Activity
The project is on fire with 39,132 stars—a clear signal of massive interest in self-hosted AI companions. The dedicated GitHub organization (@proj-airi) shows serious architectural thinking with sub-projects for RAG, memory, and Live2D utilities. The latest update on May 10, 2026 (v0.9.0) indicates active, recent development. While still pre-1.0, the community momentum and feature set suggest this could become the de facto open-source Neuro-sama platform. If you’re into AI, VTubers, or self-hosted digital life, this is the project to watch and contribute to.