一个自托管的 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 技术栈深度应用

技术用途
WebGPUGPU 加速推理(桌面支持 CUDA/Metal 回退)
WebAudio音频处理与合成
Web Workers后台多线程处理
WebAssemblyDuckDB、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 AIKimi 模型
腾讯云商业 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 x64Setup EXEAIRI-0.10.2-windows-x64-setup.exe
macOS ARM64DMGAIRI-0.10.2-darwin-arm64.dmg
macOS x64DMGAIRI-0.10.2-darwin-x64.dmg
Linux x64DEBAIRI-0.10.2-linux-amd64.deb
Linux ARM64RPMAIRI-0.10.2-linux-aarch64.rpm
Linux x64FlatpakAIRI-0.10.2-linux-x64.flatpak
AndroidAPKAIRI-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

# 启用 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         # 文档站

🔗 生态系统

核心子项目

项目描述Stars
xsaiextra-small AI SDK(LLM 抽象层)600+
unspeech统一 ASR/TTS 端点代理(类似 LiteLLM)95
airi-factorioAI 玩 Factorio(CV + LLM)88
xsmcpextra-small MCP SDK47
mcp-launcherMCP 服务器构建/启动器42
velinVue SFC 编写 LLM Prompt44

相关组织项目

项目组织描述
awesome-ai-vtuber@proj-airiAI VTuber 资源精选列表
webai-realtime-voice-chat@proj-airiChatGPT 风格实时语音示例

📈 社区生态

项目演进历程

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贡献数
Nekonekomeowww1,986(核心开发者)
luoling8192349
shinohara-rin233
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 Discussionshttps://github.com/moeru-ai/airi/discussions
Discordhttps://discord.gg/TgQ3Cu2F7A
Telegramhttps://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 Releaseshttps://github.com/moeru-ai/airi/releases
xsai SDKhttps://github.com/moeru-ai/xsai
Crowdin 翻译https://crowdin.com/project/proj-airi
CONTRIBUTINGhttps://github.com/moeru-ai/airi/blob/main/.github/CONTRIBUTING.md

结语

AIRI 是开源 AI VTuber 领域的标杆项目:功能完整、跨平台支持、技术栈现代、社区活跃。它不仅是一个聊天机器人,更是一个能陪你玩游戏、实时语音对话的「数字灵魂」。

与封闭的 Neuro-sama 相比,AIRI 让技术民主化——任何人都能拥有自己的 AI VTuber,无需依赖第三方平台。

一句话总结:开源界的 Neuro-sama,游戏+语音+虚拟形象三合一——属于你的数字伴侣。

更多推荐