explaingit

moeru-ai/airi

📈 Trending39,354TypeScriptAudience · vibe coderComplexity · 4/5ActiveLicenseSetup · hard

TLDR

Self-hosted AI companion platform where you run your own interactive virtual character with voice chat, Live2D animation, and game-playing abilities on your computer.

Mindmap

mindmap
  root((repo))
    What it does
      Voice chat with AI
      Live2D animation
      Game playing agent
      Self-hosted control
    Tech stack
      TypeScript
      Tauri framework
      Vue.js
      Grok API
    Use cases
      Personal AI companion
      Virtual streamer
      Game agent
      Custom persona
    Platforms
      Windows desktop
      macOS desktop
      Web browser
    Key features
      Real-time interaction
      Full data ownership
      Minecraft support
      Factorio support

Things people build with this

USE CASE 1

Create a personalized AI companion character you can talk to via voice chat on your own computer.

USE CASE 2

Build a virtual streamer or animated persona that plays games like Minecraft or Factorio autonomously.

USE CASE 3

Experiment with AI-driven game agents without relying on cloud services or third-party platforms.

USE CASE 4

Run an interactive animated character with full control over the AI models and data.

Tech stack

TypeScriptTauriVue.jsLive2DGrok API

Getting it running

Difficulty · hard Time to first run · 1h+

Requires Tauri build setup, Live2D SDK integration, and Grok API key; multiple native dependencies and compilation steps.

Use freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

Project AIRI is a self-hosted AI companion platform that lets you run your own interactive virtual character, sometimes called an AI VTuber or waifu, on your own computer or server. The project's goal, as described in the README, is to re-create the kind of experience popularized by Neuro-sama, a popular AI-driven virtual streamer. Rather than relying on a third-party service, AIRI gives you full ownership and control over the character and its underlying AI models. The platform supports real-time voice chat so you can have a spoken conversation with the character, and it can even play games autonomously, the README mentions Minecraft and Factorio as supported environments. Characters are rendered using Live2D, a technique for animating 2D illustrated characters with smooth, lifelike movement. The system connects an AI language model (configured to use Grok-compatible interfaces) to the character's voice, animation, and game-playing abilities. Because it is self-hosted, you bring your own API keys and model choices. You would use AIRI if you want to create or run a personalized AI companion or virtual streamer character, experiment with AI-driven game agents, or build your own version of an interactive animated persona without sending your data to a third-party cloud service. Desktop apps are available for Windows and macOS, and a browser version also exists. The tech stack is TypeScript throughout, using the Tauri framework for the desktop application shells, with Vue.js for the user interface. It runs on Windows, macOS, and in modern web browsers.

Copy-paste prompts

Prompt 1
How do I set up AIRI to create my own AI virtual character with voice chat on Windows?
Prompt 2
Show me how to configure AIRI to play Minecraft autonomously using my own Grok API key.
Prompt 3
What are the steps to customize a Live2D character in AIRI and connect it to a language model?
Prompt 4
How can I deploy AIRI in a browser instead of using the desktop app?
Prompt 5
Help me set up AIRI to create an AI companion that can have real-time voice conversations.
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.