一个自托管的 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-speech |
TTS 语音合成 |
@xsai/generate-transcription |
ASR 语音识别 |
@xsai/stream-transcription |
流式转录 |
@xsai/embed |
向量嵌入 |
@xsai/tool |
Tool 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)
scoop bucket add airi https://github.com/moeru-ai/airi
scoop install airi/airi
方式三:Nix(Linux)
nix run github:moeru-ai/airi
方式四:Web 版(无需安装)
直接访问 https://airi.moeru.ai,PWA 支持移动端浏览器运行。
源码构建(开发者)
前置要求
- Git
- Node.js 23+
- corepack
- pnpm 10.33.0
平台特定依赖
Windows:
scoop install git nodejs rustup
scoop install main/rust-msvc
rustup toolchain install stable-x86_64-pc-windows-msvc
macOS:
brew install git node
Linux:
sudo apt install libssl-dev libgtk-3-dev libwebkit2gtk-4.1-dev
构建命令
git clone https://github.com/<your-username>/airi.git
cd airi
corepack enable
pnpm install
pnpm dev
pnpm dev:tamagotchi
pnpm dev:pocket:ios
pnpm dev:pocket: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% |
社区渠道
| 渠道 |
链接 |
| GitHub Discussions |
https://github.com/moeru-ai/airi/discussions |
| Discord |
https://discord.gg/TgQ3Cu2F7A |
| Telegram |
https://t.me/+7M_ZKO3zUHFlOThh |
| Twitter/X |
@proj_airi |
| Crowdin |
多语言翻译协作 |
🎯 适用场景
个人娱乐
| 场景 |
描述 |
| AI VTuber 直播 |
创建 AI 虚拟主播,YouTube/Twitch 直播 |
| 游戏陪玩 |
AI 陪你玩 Minecraft、Factorio |
| 日常聊天 |
随时语音对话的数字伴侣 |
| 角色扮演 |
加载不同角色卡,体验多元人格 |
开发研究
| 场景 |
描述 |
| AI Agent 研究 |
实验游戏 AI、语音 Agent |
| LLM 应用开发 |
学习 xsai 集成最佳实践 |
| 虚拟角色技术 |
VRM/Live2D 技术探索 |
| 本地推理测试 |
WebGPU/Ollama 本地部署 |
📚 参考资源
| 资源 |
链接 |
| GitHub 仓库 |
https://github.com/moeru-ai/airi |
| 官方文档 |
https://airi.moeru.ai/docs/ |
| 在线体验 |
https://airi.moeru.ai |
| GitHub Releases |
https://github.com/moeru-ai/airi/releases |
| xsai SDK |
https://github.com/moeru-ai/xsai |
| Crowdin 翻译 |
https://crowdin.com/project/proj-airi |
| CONTRIBUTING |
https://github.com/moeru-ai/airi/blob/main/.github/CONTRIBUTING.md |
结语
AIRI 是开源 AI VTuber 领域的标杆项目:功能完整、跨平台支持、技术栈现代、社区活跃。它不仅是一个聊天机器人,更是一个能陪你玩游戏、实时语音对话的「数字灵魂」。
与封闭的 Neuro-sama 相比,AIRI 让技术民主化——任何人都能拥有自己的 AI VTuber,无需依赖第三方平台。
一句话总结:开源界的 Neuro-sama,游戏+语音+虚拟形象三合一——属于你的数字伴侣。
所有评论(0)