explaingit

moeru-ai/airi

Analysis updated 2026-05-18

39,005TypeScriptAudience · vibe coderComplexity · 4/5LicenseSetup · 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
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

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.

What is it built with?

TypeScriptTauriVue.jsLive2DGrok API

How does it compare?

moeru-ai/airinovuhq/novuoutline/outline
Stars39,00538,94338,404
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderatehard
Complexity4/53/54/5
Audiencevibe coderdeveloperpm founder

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

Frequently asked questions

What is airi?

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.

What language is airi written in?

Mainly TypeScript. The stack also includes TypeScript, Tauri, Vue.js.

What license does airi use?

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

How hard is airi to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is airi for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub moeru-ai on gitmyhub

Verify against the repo before relying on details.