Overview
Airi is a fully self-hosted, user-owned AI companion platform inspired by Neuro-sama. Supports PWA, Electron, and Capacitor with real-time voice chat, Discord integration, game play (Minecraft, Factorio, and more), persistent memory via DuckDB WASM, and multi-LLM backend support.
Features
- ✓Cross-Platform (PWA/Electron/Capacitor)
- ✓Game Integration (Minecraft/Factorio/KSP/Helldivers)
- ✓Real-Time Voice Chat with Discord
- ✓Persistent Memory (DuckDB WASM)
- ✓VRM and Live2D Avatar Support
- ✓Multi-LLM Backend (OpenAI/Anthropic/DeepSeek)
Installation
git clone https://github.com/moeru-ai/airi.git && npm installPros
- +Fully self-hosted and user-owned
- +Cross-platform deployment
- +Rich game integration
- +Multi-LLM and multi-TTS providers
Cons
- −High hardware requirements for local inference
- −Game integration limited to supported titles
- −TTS costs if using cloud providers
Alternatives
Documentation
Airi
Overview
Airi (moeru-ai/airi) is a fully self-hosted, user-owned AI companion platform inspired by the Neuro-sama phenomenon. At 45,119+ GitHub stars, it has become the leading open-source platform for running AI companions locally with real-time voice chat, game integration, and persistent memory.
Airi is designed to be user-owned — unlike cloud-bound chatbots, everything runs on your own infrastructure. The platform supports PWA (browser), Electron (Windows/macOS/Linux), and Capacitor (mobile), making it truly cross-platform.
Features
- Cross-platform deployment: PWA in browsers, Electron desktop app (Windows/macOS/Linux), Capacitor mobile apps
- Game integration: Plays Minecraft, Factorio, Kerbal Space Program, Helldivers 2 alongside users
- Real-time voice chat with full Discord integration
- Persistent memory powered by DuckDB WASM — companions retain identity across sessions
- VRM and Live2D model support with full animation pipelines
- Multi-provider TTS: ElevenLabs, Azure, and local Kokoro TTS
- Multi-LLM backend: OpenAI, Anthropic Claude, DeepSeek, OpenRouter via the xsai library
- Grok Companion inspired: Originally designed as a self-hosted Grok companion alternative
Installation
git clone https://github.com/moeru-ai/airi.git
cd airi
# Follow platform-specific setup for PWA, Electron, or Capacitor
npm install
npm run dev
Quick Start
- Clone the repository and install dependencies
- Configure your LLM provider (OpenAI, Anthropic, DeepSeek, OpenRouter)
- Set up TTS provider (ElevenLabs, Azure, or Kokoro for local)
- Define your companion's personality, voice, and avatar
- Launch — companion is ready for voice chat, Discord, and game integration
Core Concepts
- Companion: A persistent AI persona with memory, voice, avatar, and personality
- Memory System: DuckDB WASM-backed persistent memory for long-term identity retention
- xsai: Multi-provider LLM abstraction that supports OpenAI, Anthropic, DeepSeek, and OpenRouter
- Voice Pipeline: TTS (ElevenLabs/Azure/Kokoro) + real-time streaming for natural conversations
Examples
Minecraft Companion
An Airi companion joins a Minecraft server, participates in building, trades items, and engages in real-time voice chat with players.
Discord Presence
Airi joins a Discord server as a persistent voice channel participant, engaging in conversations, playing music, and responding to user commands.
Pros
- ✅ Fully self-hosted and user-owned
- ✅ Cross-platform (PWA, Electron, Capacitor)
- ✅ Game integration across multiple titles
- ✅ Real-time voice chat with Discord
- ✅ Persistent memory (DuckDB WASM)
- ✅ Multi-LLM and multi-TTS provider support
- ✅ VRM/Live2D avatar animations
- ✅ 45K+ GitHub stars
Cons
- ❌ Significant hardware requirements for local inference
- ❌ Game integration limited to supported titles
- ❌ TTS costs if using cloud providers
- ❌ Companion personality depends on prompt quality
When to Use
Airi is ideal for:
- Self-hosted AI companion enthusiasts who want full data ownership
- Gamers who want an AI companion to play alongside them
- Discord community operators wanting an AI presence
- VRM/Live2D creators building animated virtual characters