一个自托管的 AI VTuber/数字伴侣平台，灵感源自 Neuro-sama，让你的虚拟角色不仅能聊天，还能陪你玩游戏。
📌 项目概览
Project AIRI 是一个开源的 AI 驱动虚拟角色平台，旨在打造「waifu 的灵魂容器」（a container of souls of waifu）。它由 Moeru AI 组织开发，灵感来源于知名 AI VTuber Neuro-sama ------一个能在直播中玩游戏、聊天互动的 AI 虚拟主播。
与 Neuro-sama 仅在直播时段可用、完全封闭不同，AIRI 提供了一个自托管、完全自主 的解决方案，让你的 AI 伴侣随时随地陪伴你。
项目属性
详情
开源协议 MIT License
GitHub Stars ~40,000+
GitHub Forks ~4,000+
当前版本 v0.10.2
项目创建 2024年12月
官方网站 https://airi.moeru.ai
✨ 核心价值
为什么选择 AIRI？
传统痛点
AIRI 解决方案
🔒 Neuro-sama 仅直播时段可用
📱 自托管，24/7 随时陪伴
🏢 AI VTuber 技术封闭
🔓 开源代码，完全自主
🤖 普通 AI 伴侣只能聊天
🎮 AI 能玩游戏（Minecraft、Factorio）
💰 商业方案订阅昂贵
💸 完全免费，无订阅成本
☁️ 数据隐私存疑
🛡️ 本地部署，数据完全掌控
🧠 核心功能模块
AIRI 将虚拟角色能力划分为四大模块：
Brain（大脑）------ 智能核心
能力
状态
玩 Minecraft ✅ 已实现
玩 Factorio ✅ 已实现
玩 Kerbal Space Program ✅ 已实现
Telegram/Discord 聊天集成 ✅ 已实现
记忆系统（Alaya） 🔄 进行中
纯浏览器 WebGPU 推理 🔄 进行中
联玩 Helldivers 2 🔄 进行中
Ears（耳朵）------ 语音识别
能力
描述
浏览器音频输入 WebAudio API 实时采集
Discord 音频采集 支持多平台语音
客户端语音识别（STT） 本地/云端 ASR
说话检测（VAD） Voice Activity Detection
Mouth（嘴巴）------ 语音合成
能力
描述
ElevenLabs TTS 高质量语音合成
Kokoro TTS 开源本地语音引擎
多语音模型支持 通过 unspeech 统一接口
Body（身体）------ 角色呈现
模型类型
支持特性
VRM 模型 自动眨眼、注视跟踪、待机动画
Live2D 模型 自动眨眼、注视跟踪、待机动画
Spine 动画 2D 骨骼动画支持
🏗️ 技术架构
技术栈一览
层级
技术选型
主语言 TypeScript（~68.7%）
前端框架 Vue.js 3（~22.5%）
桌面框架 Electron
移动框架 Capacitor（iOS/Android）
3D 渲染 Three.js + @pixiv/three-vrm
2D 渲染 PixiJS + pixi-live2d-display
样式方案 UnoCSS + Reka UI（shadcn-vue 兼容）
状态管理 Pinia
构建工具 Vite + Turbo（Monorepo）
包管理器 pnpm（Workspace）
Monorepo 项目结构
复制代码
airi/
├── apps/ # 应用入口
│ ├── stage-web/ # 浏览器版本（PWA）
│ ├── stage-tamagotchi/ # 桌面版本（Electron）
│ ├── stage-pocket/ # 移动版本（Capacitor）
│ └── server/ # 后端服务
│
├── packages/ # 共享库
│ ├── stage-ui/ # 核心 UI 组件与状态
│ ├── stage-ui-three/ # 3D/VRM 渲染组件
│ ├── stage-ui-live2d/ # Live2D 渲染组件
│ ├── stage-ui-spine/ # Spine 动画组件
│ ├── audio/ # 音频处理工具
│ ├── pipelines-audio/ # 音频流水线（采集→VAD→编码→流式）
│ ├── server-runtime/ # 服务端运行时（Hono/h3）
│ ├── i18n/ # 国际化
│ └── ...
│
├── engines/ # 游戏引擎集成
├── plugins/ # 插件系统
├── services/ # 微服务
├── docs/ # 文档站（VitePress）
└── examples/ # 示例代码
Web 技术栈深度应用
技术
用途
WebGPU GPU 加速推理（桌面支持 CUDA/Metal 回退）
WebAudio 音频处理与合成
Web Workers 后台多线程处理
WebAssembly DuckDB、ONNX Runtime、Transformers.js
WebSocket 实时通信
PWA 离线可用浏览器应用
AI/LLM 集成架构
AIRI 使用自研的 xsai 库作为 AI 抽象层，类似 Vercel AI SDK：
xsai 模块
功能
@xsai/generate-text文本生成
@xsai/stream-text流式文本生成
@xsai/generate-speechTTS 语音合成
@xsai/generate-transcriptionASR 语音识别
@xsai/stream-transcription流式转录
@xsai/embed向量嵌入
@xsai/toolTool Calling（函数调用）
@xsai/shared-chat聊天会话管理
🤖 LLM 提供商支持
AIRI 通过 xsai 支持 25+ LLM 提供商 ：
国际主流提供商
提供商
类型
OpenAI / Azure OpenAI
商业 API
Anthropic Claude
商业 API
Google Gemini
商业 API
xAI（Grok）
商业 API
DeepSeek
商业 API
Qwen（阿里）
商业 API
Groq
高速推理
Mistral
商业 API
Cloudflare Workers AI
边缘推理
Together.ai / Fireworks.ai / Novita推理聚合
OpenRouter
多模型聚合
本地推理方案
方案
描述
Ollama 本地 LLM 运行
vLLM 高吞吐本地推理
SGLang 结构化语言生成
国内提供商
提供商
类型
智谱（Zhipu）
GLM 系列
SiliconFlow
推理平台
Stepfun
阶跃星辰
百川（Baichuan）
商业 API
Minimax
商业 API
Moonshot AI
Kimi 模型
腾讯云
商业 API
小米 MiMo
商业 API（v0.10.2 新增）
🚀 安装部署
平台支持矩阵
平台
支持级别
安装方式
Windows ✅ 桌面完整支持
EXE 安装包、Scoop
macOS（Intel） ✅ 桌面完整支持
DMG、ZIP
macOS（Apple Silicon） ✅ 桌面完整支持
DMG、ZIP
Linux x64/ARM64 ✅ 桌面完整支持
DEB、RPM、Flatpak、Nix
Web 浏览器 ✅ PWA 支持
直接访问
Android ✅ 移动支持
APK 下载
iOS ✅ 移动支持
IPA（侧载）
快速安装
方式一：二进制发布包（推荐终端用户）
从 GitHub Releases 下载对应平台安装包：
平台
格式
文件名示例
Windows x64
Setup EXE
AIRI-0.10.2-windows-x64-setup.exe
macOS ARM64
DMG
AIRI-0.10.2-darwin-arm64.dmg
macOS x64
DMG
AIRI-0.10.2-darwin-x64.dmg
Linux x64
DEB
AIRI-0.10.2-linux-amd64.deb
Linux ARM64
RPM
AIRI-0.10.2-linux-aarch64.rpm
Linux x64
Flatpak
AIRI-0.10.2-linux-x64.flatpak
Android
APK
AIRI-0.10.2-android.apk
方式二：Scoop（Windows）
powershell
复制代码
scoop bucket add airi https://github.com/moeru-ai/airi
scoop install airi/airi
方式三：Nix（Linux）
shell
复制代码
nix run github:moeru-ai/airi
方式四：Web 版（无需安装）
直接访问 https://airi.moeru.ai
源码构建（开发者）
前置要求
Git
Node.js 23+
corepack
pnpm 10.33.0
平台特定依赖
Windows:
powershell
复制代码
scoop install git nodejs rustup
scoop install main/rust-msvc
rustup toolchain install stable-x86_64-pc-windows-msvc
macOS:
shell
复制代码
brew install git node
Linux:
shell
复制代码
sudo apt install libssl-dev libgtk-3-dev libwebkit2gtk-4.1-dev
构建命令
shell
复制代码
# 克隆仓库
git clone https://github.com/<your-username>/airi.git
cd airi
# 启用 pnpm
corepack enable
pnpm install
# 运行不同版本
pnpm dev # Web 版（浏览器）
pnpm dev:tamagotchi # 桌面版（Electron）
pnpm dev:pocket:ios # iOS 移动版
pnpm dev:pocket:android # Android 移动版
pnpm dev:docs # 文档站
🔗 生态系统
核心子项目
相关组织项目
📈 社区生态
项目演进历程
复制代码
2024年12月: v0.1.x（项目创建）
v0.3.x - v0.4.x（功能开发）
2025年: v0.5.0 - v0.6.x（核心特性）
v0.7.0 - v0.7.1（稳定化）
2025年12月: v0.8.0（重大更新）
2026年1月: v0.8.1 - v0.8.4（Bug修复）
2026年4月: v0.9.0（Alpha/Beta 测试）
2026年5月: v0.10.0 - v0.10.2（当前版本）
开发节奏 ：6个月内超过100个版本发布，活跃的 Alpha/Beta 测试周期。
贡献者
贡献者
GitHub
贡献数
Neko nekomeowww
1,986（核心开发者）
luoling8192
349
shinohara-rin
233
github-actions[bot]
229（自动化）
语言分布
语言
占比
TypeScript
~68.7%
Vue
~22.5%
GDScript
~2.4%
JavaScript
~1.0%
C#
~0.6%
CSS/Kotlin/Swift
~1.4%
社区渠道
🎯 适用场景
个人娱乐
场景
描述
AI VTuber 直播 创建 AI 虚拟主播，YouTube/Twitch 直播
游戏陪玩 AI 陪你玩 Minecraft、Factorio
日常聊天 随时语音对话的数字伴侣
角色扮演 加载不同角色卡，体验多元人格
开发研究
场景
描述
AI Agent 研究 实验游戏 AI、语音 Agent
LLM 应用开发 学习 xsai 集成最佳实践
虚拟角色技术 VRM/Live2D 技术探索
本地推理测试 WebGPU/Ollama 本地部署
📚 参考资源
结语
AIRI 是开源 AI VTuber 领域的标杆项目：功能完整、跨平台支持、技术栈现代、社区活跃。它不仅是一个聊天机器人，更是一个能陪你玩游戏、实时语音对话的「数字灵魂」。
与封闭的 Neuro-sama 相比，AIRI 让技术民主化------任何人都能拥有自己的 AI VTuber，无需依赖第三方平台。
一句话总结 ：开源界的 Neuro-sama，游戏+语音+虚拟形象三合一------属于你的数字伴侣。