AIRI: Open‑Source AI Virtual Companion That Tops GitHub Trending and Runs 24/7

AIRI is an open‑source AI virtual companion that can be self‑hosted, allowing continuous 7 × 24 h availability as long as the host computer remains powered on.

Interaction capabilities

Supports both VRM and Live2D avatar formats; avatars automatically blink, follow gaze, and perform expressive gestures, giving the AI a sense of “breathing”. Provides real‑time voice conversation and integrates with Discord and Telegram. Game integration includes:

In Minecraft, uses the Mineflayer tool to mine, build structures, fight mobs, and explore autonomously.

In Factorio, combines YOLO visual recognition with large‑model decision‑making to assist in part assembly and automated production‑line construction (demonstration‑level functionality).

Memory and personalization

Includes a built‑in Retrieval‑Augmented Generation (RAG) mechanism and an embedded database, enabling long‑term retention of conversation history and adaptation to a user’s speaking style.

Platform support

Web version runs in browsers using WebGPU and WebAudio, supports Progressive Web App mode for mobile devices, and offers performance comparable to native apps.

Desktop client is built with the Tauri framework, written in Rust, and can invoke NVIDIA CUDA or Apple Metal for hardware‑accelerated execution.

Model compatibility

Native support for over 30 major large‑model APIs, including OpenAI, Claude, Gemini, Tongyi Qianwen, Kimi, and local inference via Ollama, allowing offline operation without reliance on a single platform.

Deployment workflow

Technical stack: TypeScript + Vue.js; package manager: pnpm.

Prerequisites: Git, Node.js 23 or newer, pnpm; building the desktop client additionally requires the Rust toolchain.

Platform‑specific environment‑configuration commands are provided for macOS, Windows, and Linux. Deployment consists of three steps: clone the repository, install project dependencies, and start the development server. After connecting a large‑model API key, the companion can be used immediately; optional configuration enables voice interaction and game plugins.

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