一个自托管的 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)