How to Build Your Own Open-Source AI Companion with AIRI

Overview

AIRI is an open‑source AI companion that reproduces the functionality of the virtual streamer Neuro‑sama. It can be self‑hosted, runs on more than 30 large‑model APIs (OpenAI, Claude, Gemini, DeepSeek, Kimi, etc.), and provides real‑time voice chat, Discord/Telegram integration, and game‑play assistance for Minecraft and Satisfactory .

Key capabilities

Real‑time voice conversation

Game‑play bots for Minecraft (using Mineflayer) and Satisfactory (YOLO‑based visual recognition)

Discord and Telegram chat bridges

RAG (retrieval‑augmented generation) with an embedded vector database for long‑term memory

Web version built with WebGPU, WebAudio, WebAssembly and PWA support

Desktop version built with Tauri (Rust) leveraging CUDA or Metal acceleration

Compatibility with >30 large‑model APIs and local Ollama inference

Technical stack

The codebase uses TypeScript and Vue.js for the UI, managed with pnpm . The desktop client is compiled with Tauri , which requires a Rust toolchain.

Environment preparation

macOS

- brew install git node
- corepack enable
- corepack prepare pnpm@latest --activate

Windows

- Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
- Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
- scoop install git nodejs rustup
- scoop install main/rust-msvc
- rustup toolchain install stable-x86_64-pc-windows-msvc
- rustup default stable-x86_64-pc-windows-msvc
- corepack enable
- corepack prepare pnpm@latest --activate

Linux

# Ubuntu/Debian example
- sudo apt install git nodejs libssl-dev libglib2.0-dev libgtk-3-dev libjavascriptcoregtk-4.1-dev libwebkit2gtk-4.1-dev
- corepack enable
- corepack prepare pnpm@latest --activate

Clone the repository

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

Install project dependencies

- corepack enable
- pnpm install

Optionally install @antfu/ni to simplify command usage: - npm i -g @antfu/ni After installing ni, you can replace pnpm install with ni and run scripts with nr.

Run the development server

The quickest way to start is the web version: - pnpm dev The command prints a local URL (e.g., http://localhost:5173). Open it in a browser and provide an API key for a supported large‑model service (e.g., Kimi K2.5).

Additional configuration

To enable voice chat, configure a speech model as described in the repository’s README. Discord and Telegram integration, as well as game‑play bots, are controlled via configuration files located in the config/ directory.

Repository

https://github.com/moeru-ai/airi/