airi：自托管AI虚拟形象项目

项目概述

Project AIRI 致力于复刻 Neuro-sama，提供一个可自主拥有的 AI 虚拟形象（"数字灵魂容器"）框架。与 ChatGPT、Character.ai、SillyTavern 等纯聊天方案不同，AIRI 强调让虚拟形象具备游戏互动、视觉感知、实时语音等综合能力，并支持用户在本地或浏览器中运行。

技术架构亮点

项目从立项之初就以现代 Web 技术为基石：

• WebGPU、WebAudio、Web Workers、WebAssembly、WebSocket
• 桌面端通过 HuggingFace candle 框架原生支持 NVIDIA CUDA 与 Apple Metal，避免复杂的依赖管理
• 图形、布局、动画及插件系统由 Web 技术驱动，但性能关键路径可下沉到原生层
• 基于此架构可运行于现代浏览器、移动设备（PWA），并通过 TCP 连接扩展到 Discord 语音、Minecraft、Factorio 等场景

核心能力清单

大脑（Brain）

• 游戏：Minecraft、Factorio（PoC 可用）、Kerbal Space Program；Helldivers 2 合作模式开发中
• 即时通讯：Telegram、Discord
• 记忆：基于 DuckDB WASM 与 pglite 的纯浏览器内嵌数据库；Memory Alaya 规划中

耳朵（Ears）

浏览器与 Discord 音频输入、客户端语音识别与说话检测。

嘴巴（Mouth）

多供应商语音合成：ElevenLabs、Microsoft/Azure Speech、OpenAI 兼容 TTS、阿里云百炼、本地 Kokoro TTS。

身体（Body）

支持 VRM 与 Live2D 模型，含自动眨眼、自动注视、闲置眼神漂移等动画。

开发与运行

pnpm i
pnpm dev            # Stage Web 浏览器版本
pnpm dev:tamagotchi # 桌面版
pnpm dev:pocket:ios --target <DEVICE_ID_OR_SIMULATOR_NAME>  # iOS 移动版
pnpm dev:docs       # 文档站点

桌面版同时提供 Nix 包：

nix run github:moeru-ai/airi

NixOS 用户需先进入 FHS shell：

nix develop .#fhs
pnpm dev:tamagotchi

移动版以 root 启动桌面服务后，可在设置中启用安全 WebSocket 进行无线连接。版本号通过 npx bumpp --no-commit --no-tag 维护。

LLM 供应商支持

通过自研的 xsai SDK 适配，已支持 OpenAI、Azure OpenAI、Anthropic Claude、DeepSeek、Qwen、Google Gemini、xAI、Groq、Mistral、Cloudflare Workers AI、Together.ai、Fireworks.ai、Novita、智谱、SiliconFlow、Stepfun、百川、Moonshot AI、ModelScope、Ollama、vLLM、SGLang、Player2、腾讯云、小米 MiMo 等；AWS Claude、Spark、Volcano Engine 欢迎社区贡献。

安装方式

# Windows
winget install MoeruAI.AIRI
scoop bucket add airi https://github.com/moeru-ai/airi
scoop install airi/airi

# macOS
brew install --cask airi

子项目

衍生项目由 @proj-airi 组织维护，涵盖 unspeech（ASR/TTS 通用代理）、hfup（HuggingFace Spaces 部署工具）、xsai-transformers、@proj-airi/drizzle-duckdb-wasm、@proj-airi/duckdb-wasm、AIRI Factorio、DomeKeeper AI、Factorio RCON API、autorio、demodel、inventory、mcp-launcher、实时语音聊天示例 webai-realtime-voice-chat、文档仓库 🥺 SAD 等。整体架构见 README 中 mermaid 流程图：Core 通过 STT、Server Runtime、Memory 与 Stage UI 解耦，并分别对接 Factorio、Minecraft 等游戏 Agent。

路线与现状

仓库路线图按 Brain、Ears、Mouth、Body 四个维度列出，已完成 VRM/Live2D 渲染、跨平台客户端、多语音供应商集成；纯浏览器 WebGPU 推理、Memory Alaya、Helldivers 2 仍在推进中。

注意：项目未发布任何官方加密货币或代币，谨防假冒。