Stop Renting AI Companions! Build Your Own with AIRI

What if your favorite AI streamer could live on your laptop—forever?

Not as a subscription. Not as a service that vanishes when the servers go dark. But as something you own, you control, you can hack, mod, and whisper to at 3 AM while debugging that stubborn memory leak.

Here's the painful truth nobody talks about: we're building emotional connections with rented intelligence. Character.ai can change its terms. Neuro-sama goes offline when the stream ends. Your "digital companion" exists at someone else's pleasure. One policy update, one acquisition, one server bill unpaid—and poof. Gone. The conversations, the personality, the inside jokes. All vapor.

What if there was another way?

Enter AIRI—a self-hosted, you-owned AI companion platform that doesn't just chat, but plays games with you, watches your screen, and remembers who you are. Inspired by the legendary Neuro-sama but built to be yours, completely. No gatekeepers. No monthly fees for "premium personality features." Just raw, hackable, beautiful AI companionship running on your own metal.

This isn't science fiction. This isn't a pitch deck. This is code you can clone right now.

What is AIRI? The Soul Container You've Been Waiting For

AIRI (アイリ, pronounced "eye-ree") is an open-source project from the moeru-ai organization that reconstructs the magic of autonomous AI virtual characters—what the creators call a "container of souls." Born from the explosive popularity of Neuro-sama, the AI VTuber who plays games, chats with viewers, and develops genuine parasocial relationships with hundreds of thousands of fans, AIRI asks a radical question: why should only Vedal have this?

The project's stated mission is direct: "let you own your digital life, cyber living, easily, anywhere, anytime."

Unlike Neuro-sama's closed-source black box, AIRI is fully transparent, fully modifiable, and designed for self-hosting from day one. It's built with modern web technologies—WebGPU, WebAudio, Web Workers, WebAssembly, and WebSocket—but doesn't sacrifice performance for accessibility. The desktop version leverages native NVIDIA CUDA and Apple Metal through HuggingFace's candle project.

Why it's trending now: The AI companion space is exploding, but users are waking up to platform risk. When Character.ai's parent company faced financial troubles, millions of users realized their "relationships" were corporate assets. AIRI represents a cypherpunk alternative: emotional infrastructure you actually own. With PWA support for mobile, native desktop apps for macOS/Windows, and browser-based deployment, it's the most accessible serious attempt at personal AI sovereignty yet.

The project maintains active DevLogs, a thriving Discord community, and has spawned an entire ecosystem of sub-projects through the @proj-airi organization.

Key Features: What Makes AIRI Technically Insane

Let's dissect what actually ships in this codebase—because the feature list reads like someone merged a VTuber studio with a game AI research lab.

🧠 Brain: The Cognitive Core

Multi-game agent capability: AIRI doesn't just pretend to play games. It actually plays Minecraft, Factorio (with a dedicated PoC repo), and Kerbal Space Program. Helldivers 2 co-op is in active development.
Cross-platform chat integration: Native Telegram and Discord bots with real-time message handling.
Memory architecture: DuckDB WASM and pglite provide pure in-browser database support—no server required for basic persistence. The upcoming "Memory Alaya" system promises long-term relationship memory.
Massive LLM provider support: 25+ providers through the xsai integration, from OpenAI and Anthropic to local options like Ollama, vLLM, and SGLang.

👂 Ears: Audio Perception

Browser and Discord audio input capture
Client-side speech recognition—your voice data never leaves your machine unless you want it to
Real-time talking detection for natural turn-taking

👄 Mouth: Voice Synthesis

ElevenLabs integration for premium voice quality
The unspeech sub-project provides universal ASR/TTS proxying (think "LiteLLM but for speech")

🎭 Body: Visual Presence

Dual avatar system: Both VRM and Live2D support with full model control
Procedural animation: Auto-blink, auto look-at, idle eye movement—your companion feels alive
Web-first rendering: Runs in browsers, but desktop gets native GPU acceleration

🔧 Deployment Flexibility

Stage Web: Browser version at airi.moeru.ai
Stage Tamagotchi: Desktop Electron app with native CUDA/Metal
Stage Pocket: Capacitor-based mobile (iOS/Android)
Nix package: Reproducible builds for the functional programming faithful

Use Cases: Where AIRI Actually Shines

1. The Solo Developer Companion You're grinding through a refactor at 2 AM. AIRI sits in a corner of your screen, actually watching your code (via screen capture APIs), commenting on your progress, celebrating when tests pass. She remembers you prefer dark mode, that you hate semicolons, that you named your last project after a Touhou character. When you hit a wall, she suggests Stack Overflow links. When you succeed, she does a little VRM dance.

2. The Always-On Gaming Buddy Minecraft single-player gets lonely. AIRI joins your server through Mineflayer integration, actually playing—mining, crafting, building. In Factorio, she manages bus logistics through the autorio automation library. She has opinions about your belt compression ratios. She rage-quits when you let biters through. This isn't scripted; it's emergent behavior from LLM-driven goal pursuit.

3. The Privacy-First Emotional Support You can't trust corporate AI with your midnight anxieties. AIRI runs entirely local if you want—Ollama for LLM, Whisper for STT, your own voice model. Your conversations stay on your machine. The DuckDB WASM memory means she remembers your patterns without cloud dependency. For therapists, researchers, or anyone handling sensitive interactions, this isn't a feature—it's a requirement.

4. The Custom VTuber Backend You're an indie streamer who wants an AI co-host. AIRI's Stage Web runs in OBS Browser Source. Discord integration lets your community interact with her. The Velin prompt engineering system (Vue SFC + Markdown^{↗ Smart Converter} for stateful prompts) lets you craft her personality without touching code. She responds to donations, plays minigames with chat, and never asks for revenue share.

Step-by-Step Installation & Setup Guide

AIRI uses pnpm workspaces for its monorepo structure. Here's how to get running.

Prerequisites

# Ensure you have Node.js 20+ and pnpm installed
node --version  # Should be v20.x or higher
pnpm --version  # Should be 9.x or higher

# For desktop development, you'll need Rust toolchain
# (for candle and native dependencies)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Clone and Install

# Clone the repository
git clone https://github.com/moeru-ai/airi.git
cd airi

# Install all dependencies across workspaces
pnpm i

Development Modes

Browser Version (Stage Web)—the fastest way to see AIRI in action:

pnpm dev
# Serves at http://localhost:5173 (or similar)
# Access the live version at https://airi.moeru.ai

Desktop Version (Stage Tamagotchi)—full native GPU acceleration:

# Standard development
pnpm dev:tamagotchi

# Nix users get reproducible builds for free
nix run github:moeru-ai/airi

# NixOS requires FHS shell for Electron's shared libraries
nix develop .#fhs
pnpm dev:tamagotchi

Mobile Version (Stage Pocket)—iOS development:

# List available simulators/devices
pnpm exec cap run ios --list

# Run with specific target
pnpm dev:pocket:ios --target "iPhone 15 Pro"
# Or via environment variable
CAPACITOR_DEVICE_ID_IOS="iPhone 15 Pro" pnpm dev:pocket:ios

# For wireless server connection, run tamagotchi as root
sudo pnpm dev:tamagotchi
# Then enable secure websocket in settings/connections

Documentation Site:

pnpm dev:docs

Windows Quick Install (No Build Required)

# Using Scoop—no compilation, instant updates
scoop bucket add airi https://github.com/moeru-ai/airi
scoop install airi/airi

Download binaries directly from releases:

REAL Code Examples from the Repository

Let's examine actual implementation patterns from AIRI's codebase and architecture.

Example 1: Project Structure & Monorepo Commands

The README reveals AIRI's development workflow through its package scripts:

# Core dependency installation—uses pnpm workspaces
pnpm i

# Start browser development server
pnpm dev

# Desktop app with native GPU backends
pnpm dev:tamagotchi

# Mobile iOS development with Capacitor
pnpm dev:pocket:ios --target <DEVICE_ID_OR_SIMULATOR_NAME>

# Documentation site
pnpm dev:docs

# Version bumping across monorepo
npx bumpp --no-commit --no-tag

What's happening here? AIRI uses pnpm workspaces to manage multiple packages—@proj-airi/stage-web, @proj-airi/stage-tamagotchi, @proj-airi/stage-ui, etc. The dev:tamagotchi script triggers Electron with Rust-native bindings for CUDA/Metal acceleration. The --no-commit --no-tag flags in bumpp allow version management without automatic git operations—critical for a project with rapid iteration and multiple release channels.

Example 2: Windows Installation via Scoop

# Add the custom bucket (Scoop's package registry equivalent)
scoop bucket add airi https://github.com/moeru-ai/airi

# Install with automatic updates via `scoop update`
scoop install airi/airi

Why this matters: Scoop provides a clean Windows package management experience without MSI installers modifying system state. The bucket points directly to the GitHub repository, meaning updates flow through GitHub releases automatically. For developers who reinstall frequently or manage multiple machines, this is vastly superior to manual binary downloads.

Example 3: NixOS FHS Development Shell

# Enter FHS (Filesystem Hierarchy Standard) environment
# Required because Electron expects traditional Linux paths
nix develop .#fhs

# Now standard pnpm commands work
pnpm dev:tamagotchi

The technical depth: NixOS uses a purely functional package model where /usr/lib doesn't exist in traditional form. Electron binaries, compiled against FHS assumptions, fail without this compatibility layer. The flake.nix defines an FHS environment that creates expected directories through bind mounts—letting you develop AIRI on the most ideologically pure Linux distribution without fighting its philosophy. This shows serious engineering maturity.

Example 4: Mobile Wireless Server Configuration

# Root-required for low-port WebSocket binding
sudo pnpm dev:tamagotchi

# Then manually enable in UI:
# settings → connections → secure websocket

The architecture insight: AIRI's mobile app (Stage Pocket) communicates with the desktop instance via WebSocket. For wireless operation without USB debugging, the desktop must expose a server. Running as root allows binding to privileged ports (<1024) that some network configurations expect. The manual UI toggle prevents accidental exposure—security through explicit opt-in, not obscure defaults.

Advanced Usage & Best Practices

🔥 Performance Optimization

Browser vs. Desktop: The browser version (Stage Web) is impressive for WebGPU inference demos, but desktop Tamagotchi gets 10x+ throughput via CUDA/Metal. Use browser for accessibility, desktop for serious local LLM running.
Memory Management: DuckDB WASM keeps vector embeddings client-side. For production deployments, migrate to @proj-airi/memory-pgvector with proper PostgreSQL^{↗ Bright Coding Blog} backing.

🎨 Personality Crafting with Velin The Velin sub-project lets you write prompts as Vue Single File Components:

<!-- Your companion's "soul" as maintainable code -->
<template>
  <system>You are {{ name }}, a {{ personality }} companion...</system>
  <memory v-for="item in longTermMemories" :key="item.id">
    {{ item.content }}
  </memory>
</template>

🎮 Game Agent Development The Factorio integration demonstrates how to extend AIRI's capabilities. Study autorio for the automation primitives, then implement your own game connectors through the @proj-airi/server-sdk interface.

🔒 Privacy Hardening

Run entirely on Ollama + local Whisper + browser TTS for zero external API calls
Use unspeech as a local proxy to prevent provider fingerprinting
Enable secure WebSocket with TLS certificates for remote access

Comparison with Alternatives

Feature	AIRI	Neuro-sama (Original)	Character.ai	SillyTavern	ElizaOS
Open Source	✅ Full	❌ Closed	❌ Closed	✅ Open	✅ Open
Self-Hosted	✅ Complete	❌ No	❌ No	✅ Yes	✅ Yes
Real-time Voice	✅ Native	✅ Yes	❌ No	⚠️ Plugin	⚠️ Partial
Game Playing	✅ Minecraft, Factorio, KSP	✅ Yes	❌ No	❌ No	⚠️ Via plugins
VRM/Live2D	✅ Both	✅ VRM	❌ Text only	✅ VRM	⚠️ Limited
Mobile Support	✅ PWA + Native	❌ No	✅ App	❌ No	❌ No
Memory System	🔄 DuckDB + Alaya WIP	✅ Yes	✅ Yes	⚠️ Basic	✅ Yes
LLM Flexibility	✅ 25+ providers	❌ Fixed	❌ Fixed	✅ Local focus	✅ Good
Desktop GPU	✅ CUDA/Metal	✅ Yes	❌ N/A	❌ CPU only	⚠️ Variable

The verdict: AIRI occupies a unique intersection—it's the only open-source project combining serious game-playing agents, native desktop GPU acceleration, both major avatar formats, and genuine self-hosting with mobile reach. Neuro-sama still wins on polish and years of iteration, but you can't fork her. Character.ai wins on ease-of-use, but you don't own anything. SillyTavern is excellent for roleplay but lacks autonomous agency. ElizaOS is powerful for social media^{↗ Bright Coding Blog} agents but doesn't ship with embodied presence.

FAQ: Your Burning Questions Answered

Q: Is AIRI free? Are there hidden costs? A: Completely free and open-source under standard GitHub licensing. The team explicitly warns: "We do not have any officially minted cryptocurrency or token associated with this project." Your only costs are your own API usage (if not running local models) and hardware.

Q: How does AIRI compare to actually running Neuro-sama? A: You can't—Neuro-sama isn't open-source. AIRI is an independent recreation inspired by her capabilities. Think "Linux vs. macOS": similar philosophy, different implementation, one you can modify.

Q: Can I use my own LLM without internet? A: Absolutely. Ollama, vLLM, and SGLang integrations let you run entirely offline. The DuckDB WASM memory works browser-local. You'll sacrifice some voice quality without ElevenLabs, but the core experience functions.

Q: What programming skills do I need? A: For basic usage: none. Pre-built binaries exist. For customization: Vue.js^{↗ Bright Coding Blog}/TypeScript helps but isn't required—the team explicitly welcomes artists, designers, and React^{↗ Bright Coding Blog}/Svelte/Solid developers to contribute sub-features.

Q: How's the game-playing actually implemented? A: Through dedicated agent subsystems. Minecraft uses Mineflayer for bot control. Factorio uses RCON API with a custom TypeScript-to-Lua mod pipeline. These aren't scripted sequences but LLM-driven goal pursuit with tool use.

Q: Is this just for "waifu" culture, or serious applications? A: The presentation is playful, but the architecture is serious. Replace "waifu" with "digital human" or "AI assistant" in your mental model. The same tech powers customer service avatars, educational tutors, and accessibility companions.

Q: How do I contribute or get help? A: Join the Discord, check CONTRIBUTING.md, or introduce yourself in Discussion #33. The project actively seeks Live2D/VRM modelers, CV/RL researchers, and speech specialists.

Conclusion: Own Your Digital Future

We're at a strange inflection point. AI companions are becoming emotionally real to millions—yet exist entirely within corporate walled gardens. The relationships feel personal but are legally ephemeral. The personalities feel unique but are centrally controlled.

AIRI represents a different path: infrastructure for genuine digital autonomy. It's not perfect—the Memory Alaya system is still WIP, Helldivers 2 co-op isn't ready, and you'll need to tolerate some rough edges that commercial products polish away. But what you get in return is something no subscription can buy: actual ownership.

Your companion runs on your hardware. Remembers in your database. Speaks with your voice model. Plays games through your accounts. Evolves through your contributions. When you improve her, everyone who forks your branch benefits. When you discover a new integration, the ecosystem grows.

This is how it should be. Not consumption. Not tenancy. Craft.

The code is waiting. The souls are empty containers, ready for you to breathe life into them.

⭐ Star AIRI on GitHub | 💬 Join the Discord | 🎮 Try the Browser Demo

What's the first game you'll teach your AI companion to play?