What is Airi?
Airi is a self-hosted AI companion and VTuber platform inspired by Neuro-sama. It allows you to create and interact with virtual characters powered by large language models, complete with voice chat, visual models (Live2D/VRM), and the ability to play games alongside you.Unlike closed platforms, Airi gives you complete control over your digital companion. Everything runs on your own hardware, with no cloud dependencies unless you choose them.
Key Features
Real-time Voice Chat
Natural conversations with client-side speech recognition, voice activity detection, and support for multiple TTS providers including ElevenLabs.
Live2D & VRM Support
Bring your characters to life with full Live2D and VRM model support, including auto-blink, look-at tracking, and idle animations.
Game Integration
Your AI companion can play Minecraft and Factorio with you as a genuine teammate, not just a spectator.
Multi-Platform
Run on Web (WebGPU-powered), Desktop (Electron with native CUDA/Metal), or Mobile (iOS/Android via Capacitor).
40+ LLM Providers
Connect to OpenAI, Anthropic Claude, Google Gemini, DeepSeek, Ollama, OpenRouter, and 40+ other providers through xsAI.
Persistent Memory
In-browser database support with DuckDB WASM for context-aware conversations that remember past interactions.
Chat Platform Integration
Integrate with Discord voice channels, Telegram bots, and other platforms to bring your companion everywhere.
Extensible Architecture
Plugin system powered by Model Context Protocol (MCP) for easy customization and integration.
What Makes Airi Special?
Unlike other AI-driven VTuber projects, Airi was built from day one with web technologies:- WebGPU for accelerated graphics
- WebAudio for audio processing
- Web Workers for parallel processing
- WebAssembly for performance-critical code
- WebSocket for real-time communication
Platform Flexibility
Airi offers three deployment options to match your needs:| Platform | Name | Best For | Key Features |
|---|---|---|---|
| Web | Stage Web | Quick access, no installation | WebGPU acceleration, PWA support, runs anywhere |
| Desktop | Stage Tamagotchi | Power users, local models | Native CUDA/Metal, screen capture, system integration |
| Mobile | Stage Pocket | On-the-go interaction | iOS/Android apps, notifications, mobile-optimized UI |
Architecture Overview
Airi is built as a monorepo using pnpm workspaces with Vue 3, TypeScript, and a modular architecture:Core Components
Stage UI
Stage UI
Business components, composables, and stores shared across all three platforms. Houses provider definitions, orchestration modules, and reusable Vue components.Location:
packages/stage-ui/xsAI Integration
xsAI Integration
Unified interface for interacting with 40+ LLM providers. Similar to Vercel AI SDK but significantly smaller and more focused.Supported providers: OpenAI, Anthropic, Google Gemini, DeepSeek, Ollama, vLLM, SGLang, and many more.
Audio Pipelines
Audio Pipelines
Client-side speech recognition with voice activity detection, audio transcription through multiple providers (via unspeech), and text-to-speech synthesis.Location:
packages/pipelines-audio/, packages/audio/Memory System
Memory System
Persistent conversation history and context using DuckDB WASM (in-browser) or PostgreSQL with pgvector (server-side). The Memory Alaya system (WIP) will provide advanced RAG capabilities.Location:
packages/drizzle-duckdb-wasm/, packages/memory-pgvector/Character Models
Character Models
Full Live2D and VRM model support with automatic blink, look-at tracking, and idle animations powered by Three.js.Location:
packages/stage-ui-three/, packages/stage-ui-live2d/Server Runtime
Server Runtime
Powers bot integrations (Discord, Telegram, Minecraft, Factorio) and plugin execution. Supports WebSocket connections for remote control.Location:
packages/server-runtime/, packages/server-sdk/Use Cases
Personal AI Companion
Create a virtual friend who remembers your conversations, understands your interests, and is always available to chat via voice or text.
Gaming Buddy
Play Minecraft or Factorio with an AI teammate that can build, gather resources, and strategize alongside you.
Virtual Streamer
Set up a VTuber that can interact with your Twitch/Discord community, respond to chat, and provide entertaining commentary.
Development Assistant
Integrate with your development workflow through VSCode extensions and MCP plugins for context-aware coding help.
Community and Ecosystem
Airi has spawned an entire ecosystem of sub-projects under @proj-airi and @moeru-ai:- xsAI - Universal LLM provider interface
- unspeech - Universal endpoint proxy for ASR and TTS
- MCP Launcher - Easy MCP server management
- Velin - Vue SFC + Markdown for LLM prompts
- AIRI Factorio - Factorio game integration
- Awesome AI VTuber - Curated list of AI VTuber projects
Join the Community
Connect with other developers and users on Discord to share ideas, get help, and contribute to the project.
Technology Stack
- Frontend
- Desktop
- Mobile
- Backend
- Framework: Vue 3 with TypeScript
- Build Tool: Vite 7
- State Management: Pinia
- Routing: Vue Router
- UI Components: Reka UI (headless)
- Styling: UnoCSS
- 3D Graphics: Three.js with TresJS
- Internationalization: Vue I18n
Project Status
Airi is under active development with regular updates. Check the DevLogs for recent progress:- Latest release: v0.8.5-beta.4
- Active contributors: Growing community
- License: MIT (open source)
- Production ready: Beta (use for personal projects)
Next Steps
Ready to get started with Airi?Quickstart
Get your first AI companion running in 5 minutes
Installation Guide
Detailed setup instructions for all three platforms
Configure Providers
Set up your preferred LLM provider and API keys
Import Characters
Add Live2D or VRM models to customize your companion