Everything you need to know about Project AIRI - Your self-hosted AI companion
Project AIRI is an open-source initiative to create a self-hosted AI companion inspired by Neuro-sama. It's designed to bring cyber living beings (virtual waifus, digital companions) into our world with capabilities for real-time voice chat, gaming, and interaction across multiple platforms.
AIRI stands out with its comprehensive game integration (Minecraft, Factorio), advanced voice capabilities, cross-platform support (Web, desktop, mobile), and extensive LLM provider support. Unlike other VTuber projects, it's built with modern web technologies while maintaining native performance for critical tasks.
Yes! Project AIRI is fully self-hostable. You can run it locally on your own hardware with complete control over your data. The web version runs entirely in your browser, while desktop apps use native performance with optional cloud services.
AIRI is built with TypeScript and uses modern web technologies including WebGPU, WebAudio, Web Workers, and WebAssembly. The desktop version leverages native APIs (NVIDIA CUDA, Apple Metal) for performance. The architecture is modular with separate components for brain, ears, mouth, and body.
AIRI supports numerous providers including OpenAI, Claude, Grok, DeepSeek, Qwen, Gemini, xAI, Groq, Mistral, Cloudflare Workers AI, Together.ai, Fireworks.ai, Novita, Zhipu, SiliconFlow, Stepfun, Baichuan, Minimax, Moonshot AI, ModelScope, Player2, Tencent Cloud, and many more. Full list available in documentation.
AIRI uses client-side speech recognition for privacy and real-time performance. It supports multiple ASR providers and includes voice detection capabilities. The system can work entirely offline or connect to cloud services depending on your setup.
AIRI supports VRM (VRM1.0 and VRM0.0) and Live2D models. It includes advanced features like auto-blinking, gaze tracking, idle eye movements, and expression synchronization. Both static and animated models are fully supported.
Desktop: Windows 10+, macOS 10.14+, or Linux. Recommended 8GB RAM, NVIDIA GPU (optional), stable internet connection.
Web: Modern browser with WebGPU support (Chrome/Edge 113+).
Mobile: iOS 15+ or Android 10+ with PWA support.
1. Download the Windows installer from our releases page.
2. Run the installer and follow the setup wizard.
3. Alternatively, use winget: winget install MoeruAI.AIRI
4. Or use Scoop: scoop bucket add airi then scoop install airi/airi
1. Download the DMG file from our releases page.
2. Drag the app to your Applications folder.
3. Alternatively, use Homebrew: brew install --cask airi
1. Download the Linux AppImage from our releases page.
2. Make it executable: chmod +x AIRI-*.AppImage
3. Run with: ./AIRI-*.AppImage
4. For Nix users: nix run github:moeru-ai/airi
1. Configure your microphone input in settings
2. Select your preferred speech recognition provider
3. Choose a TTS voice from available providers
4. Enable voice detection if available
5. Connect to Discord/Telegram for voice channels
1. Install supported games (Minecraft, Factorio, etc.)
2. Enable game integration in settings
3. Configure API keys if required
4. Launch AIRI and select the game mode
5. Follow in-app instructions for setup
1. Prepare your VRM or Live2D model
2. Place models in the designated folder
3. Use the model manager in the app
4. Configure animations and expressions
5. Test with voice and gestures
Join our Discord server for community support, check the documentation site for guides, and browse GitHub issues for technical help. We also have active translation projects on Crowdin.
We welcome contributions in all forms: code, art, documentation, translations, or community management. Check our GitHub discussions and contributing guidelines. Areas of interest include 3D modeling, computer vision, speech synthesis, and more.
Project AIRI is licensed under the MIT License. This means you're free to use, modify, and distribute the software for any purpose, including commercial use, as long as you include the original license file.
No. We do not have any officially minted cryptocurrency or token associated with this project. Any claims about cryptocurrency involvement are not affiliated with Project AIRI.
Users must comply with the terms of service for any third-party models or services they use with AIRI. The project itself doesn't impose additional restrictions beyond the MIT license.