voice-ai

Airi

Name: Airi
Author: moeru-ai

Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of realtime voice chat, Minecraf…

47,937 stars4,754 forksTypeScriptUpdated 8/16/2026100% free · open source

What it does

Airi is a self-hosted AI companion that allows for real-time voice chat, Minecraft, and Factorio gameplay, bringing virtual characters into your world.

Install / run

git clone https://github.com/moeru-ai/airi.git && cd airi && npm install

When to use it

•You want a customizable virtual companion for entertainment or social interaction
•You need a tool for real-time voice chat with a virtual character
•You're looking for a unique gaming experience with a virtual partner in Minecraft or Factorio

Quick start

1Run `npm run build` to compile the TypeScript code
2Configure your Airi instance by editing the `config.json` file
3Start the Airi server with `npm run start`
4Access the Airi web interface by navigating to `http://localhost:8080` in your browser
5Use the `airi-cli` command-line tool to interact with your Airi instance, such as `airi-cli talk` to initiate a voice chat

Ready-to-paste prompt

airi-cli talk 'What do you think about the latest anime season?'

Heads up: Make sure you have Node.js (version 16 or higher) and npm installed on your system, as Airi is built using TypeScript and relies on these dependencies

Saves to your device

Topics

ai-companion

ai-vtuber

airi

digital-life

grok-companion

live2d

neuro-sama

neurosama

openclaw

vrm

vtuber

How Airi works

Codeflow

Free to inspect

Airi is a very large TypeScript project (~331k lines across 2884 code files, plus 48 test files). It is a full software project: use it through its install path rather than reading it end to end. Last commit this month, MIT license, has a test suite.

Size

Very large codebase

~331k lines · 2884 code files · days to read — use, don't read

Setup

Developer setup

A real software project. Use it via its install path; don't expect to read it all.

Runs on

Node.js

No API keys detected