Project AIRI 全解析：自托管 Neuro-sama 式 AI 虚拟伴侣的开源技术实践指南
Project AIRI 全解析自托管 Neuro-sama 式 AI 虚拟伴侣的开源技术实践指南【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi导读Project AIRI 是一个以「AI 虚拟伴侣 / 赛博生命体」为核心目标的自我托管开源项目致力于把 Neuro-sama 这类「能玩游戏、能实时语音对话、拥有 Live2D/VRM 数字形象」的数字存在带进普通用户的日常设备。本文基于仓库中的日文版项目文档 README.ja-JP.md 整理而成结合 apps、packages、integrations 等目录下的真实源码进行佐证与扩展。读完本文你将掌握 AIRI 的项目定位、三大运行形态Web / 桌面 / 移动、完整安装与开发命令、支持的 LLM 与语音供应商矩阵以及它从「大脑、耳朵、口、身体」四个层面构建数字生命体的整体架构思路。一、项目定位为什么要再造一个 Neuro-sama1.1 出发点开源可控的「数字伴侣」Neuro-sama 是目前公认最优秀的 AI 数字主播之一能够一边打游戏一边与观众实时聊天。但她的实现并非开源直播结束后用户便无法与她互动。AIRI 项目的核心差异在于任何人都可以自托管属于自己的数字生命体随时、随地、随时可用并完全拥有自己的「数字生活」。1.2 现有方案的边界ChatGPT、Claude 等大模型已经让「与 AI 角色扮演、聊天」变得足够简单Character.ai、JanitorAI 等平台以及 SillyTavern 这类本地方案也提供了出色的聊天与视觉冒险游戏体验。但 AIRI 的文档进一步追问游戏能力呢看到用户编码的画面、一边打游戏一边聊天、看视频以及更多其他能力呢这正是 AIRI 与传统聊天机器人方案拉开距离的地方——它不仅是一个聊天框还是一个能够「看到」和「行动」的智能体。二、三大运行形态与技术栈2.1 Web 技术驱动的核心设计与多数 AI VTuber 开源项目不同AIRI 从开发第一天起就全面拥抱 Web 技术栈WebGPU、WebAudio、Web Workers、WebAssembly 与 WebSocket 均作为一等公民被支持见文档「このプロジェクトの特別な点は」一节。这意味着 AIRI 可以在现代浏览器与移动设备PWA上直接运行。依赖 apps/stage-web/package.json 可以看到浏览器版实际引入的技术组件huggingface/transformers与onnxruntime-web浏览器端模型推理vite-plugin-pwaPWA 支持实现移动端安装tresjs/core与threeThree.js 3D 渲染VRM 模型proj-airi/stage-ui-live2d、proj-airi/stage-ui-three等渲染器包proj-airi/pipelines-audio音频处理流水线同时AIRI 并未把全部能力押注在 Web 上。桌面版默认支持 NVIDIA CUDA 与 Apple Metal借助 HuggingFace 的 candle 推理框架并且保留让用户启用「TCP 连接或非 Web 技术」的灵活性——例如接入 Discord 语音频道、与朋友联机玩 Minecraft 或 Factorio。2.2 三种运行形态Stage Web / Stage Tamagotchi / Stage Pocket项目把客户端应用统称为「Stage舞台」目前有三个形态应用目录形态说明Stage Webapps/stage-web浏览器版含 PWApnpm dev默认启动Stage Tamagotchiapps/stage-tamagotchiElectron 桌面应用macOS / Windows / Linux附带 Nix 包Stage Pocketapps/stage-pocketCapacitor 移动应用iOS / Android实验性桌面版是功能最完整的形态apps/stage-tamagotchi/package.json 显示它基于 Electron 构建同时引入了proj-airi/server-runtime本地服务通道、proj-airi/plugin-sdk插件系统、proj-airi/electron-screen-capture屏幕捕获用于让 AI「看到」你的屏幕、uiohook-napi全局键鼠钩子等能力并支持通过electron-builder产出 Win/macOS/Linux 安装包。三、快速安装与获取3.1 桌面版包管理器安装Windows 用户可通过 winget 一键安装winget install MoeruAI.AIRI或使用 Scoopscoop bucket add airi https://github.com/moeru-ai/airi scoop install airi/airimacOS 用户无需自定义 tap直接用 Homebrew Caskbrew install --cask airi注上述外部命令与链接来自原文档的安装指引部分当前仓库为源码形态实际版本安装以对应发布渠道为准。3.2 离线二进制与移动端体验仓库文档提供了 Windowsv0.12.0-beta.5对应AIRI-0.12.0-beta.5-windows-x64-setup.exe、macOSdarwin-arm64.dmg及 Linux 的发布二进制下载入口Web 端可通过在线地址直接试用移动端则支持 PWA 安装。3.3 安全提示原文档特别给出了官方警告AIRI 从未发行任何官方加密货币或代币请用户警惕相关误导信息。这一点在阅读第三方推广内容时务必留意。四、从源码搭建开发环境4.1 环境准备与依赖安装AIRI 是一个 pnpm monorepo 工作区工作区声明于根 package.json 的workspaces字段覆盖packages/**、apps/**、integrations/**、services/**、engines/**、docs/**、server/**等目录。安装依赖并启动开发服务器pnpm i pnpm dev其中pnpm dev默认启动 Stage Web浏览器版的开发服务器。根 package.json 中该命令展开为pnpm -r -F proj-airi/stage-web dev。详细贡献流程请参阅 .github/CONTRIBUTING.md。4.2 各形态开发命令速查形态命令说明Stage Web浏览器版pnpm dev根脚本默认行为Stage Tamagotchi桌面pnpm dev:tamagotchi启动 Electron 开发环境Stage Pocket移动pnpm dev:pocket启动 Capacitor Web 版开发服务器文档站点pnpm dev:docs本地渲染 docs 站点iOS 真机运行CAPACITOR_DEV_SERVER_URLhttps://ip:5273 pnpm open:ios打开 Xcode 后点击 Run对应脚本均可在根 package.json 的scripts段核对dev:tamagotchi指向proj-airi/stage-tamagotchi run devopen:ios指向proj-airi/stage-pocket run open:ios等。4.3 Stage Pocket 的 iOS 联调细节执行pnpm dev:pocket后终端会输出形如ROLLDOWN-VITE v7.3.0 ready in 1073 ms ➜ Local: https://localhost:5273/ ➜ Network: https://ip-will-be-here:5273/ ➜ Vue DevTools: Open https://localhost:5273/__devtools__/ as a separate window ➜ Vue DevTools: Press Option(⌥)Shift(⇧)D in App to toggle the Vue DevTools ➜ UnoCSS Inspector: https://localhost:5273/__unocss/使用 Network 地址在另一个终端设置开发服务器 URL 并打开 XcodeCAPACITOR_DEV_SERVER_URLhttps://your-ip-address:5273 pnpm open:ios若需要在无线模式下连接 Pocket 到 Tamagotchi 的服务器通道文档建议以 root 权限启动桌面端sudo pnpm dev:tamagotchi然后在 Tamagotchi 的settings/connections中启用 secure websocket。4.4 Nix 运行方式桌面版提供 Nix 包启用 flakes 后可直接运行nix run github:moeru-ai/airi4.5 版本发布流程发布时使用bumpp更新 monorepo 版本不自动提交与打 tagnpx bumpp --no-commit --no-tag当前仓库版本为v0.12.0-beta.5见根 package.json 的version字段。五、「大脑」能力与功能路线图原文档以「脑 / 耳 / 口 / 体」四个比喻组织功能状态下面完整还原并补充源码佐证。5.1 脑思考与行动✅ 游玩 Minecraft —— 集成代码见 integrations/minecraft其中src/minecraft-bot-runtime.ts与src/airi子目录承载机器人运行时✅ 游玩 Factorio进行中已有 PoC 与 demo—— 相关自动化库见autorio子项目⏳ 一起玩 Helldivers 2进行中✅ Telegram 聊天 —— integrations/telegram-bot✅ Discord 聊天 —— integrations/discord-bot记忆能力✅ 浏览器内数据库支持DuckDB WASM /pglite—— 对应包 packages/drizzle-duckdb-wasm 与 packages/duckdb-wasm⏳ 记忆阵列进行中⏳ 浏览器内本地WebGPU推理从源码看「脑」的核心由 packages/core-agent 承担其中包含agents/、runtime/、session/、messages/、contracts/等子模块与配套测试实现会话编排、上下文管理与工具调用等 Agent 运行时能力。5.2 耳听觉输入✅ 浏览器语音输入✅ Discord 语音输入✅ 客户端侧语音识别STT✅ 客户端侧说话人检测VAD音频能力对应 packages/pipelines-audio26 个源文件同时 packages/audio 提供底层音频工具。测试与演示方面仓库还维护了 packages/testing-audio 用于语音流水线的验证。5.3 口语音合成✅ 已支持多供应商 TTS包括ElevenLabsMicrosoft / Azure SpeechOpenAI 兼容 TTS阿里云 Model Studio百炼本地 Kokoro TTS5.4 体数字形象✅ VRM 支持模型控制—— 渲染实现见 packages/stage-ui-three桌面端还集成 MMDpackages/stage-ui-mmd与 Spinepackages/stage-ui-spine✅ VRM 动画自动眨眼、自动视线追踪、待机眼部微动✅ Live2D 支持模型控制—— packages/stage-ui-live2d✅ Live2D 动画自动眨眼、自动视线追踪、待机眼部微动5.5 近期 DevLog 时间线原文档列出的一系列 DevLog 展示了项目演进脉络2025.06 2026.032026.03.23移动端性能与游戏引擎选型2026.03.14VRM 舞台的生命周期、缓存与可观测性2026.02.16Dome Keeper 数据采集与学习流水线2026.01.01AIRI Pocket 与 FlowChat 的存储实验2025.10.20Electron 迁移、新模型与 Moeru AI 更新2025.08.26airi-factorio 纯视觉方向进展2025.08.05AIRI v0.7 发布亮点2025.08.01流式文本动画与字素簇grapheme cluster2025.07.18从 Factorio Learning Environment 反思 airi-factorio2025.06.16DreamLog 0x1 项目背景故事六、支持的 LLM 与语音供应商矩阵6.1 LLM 提供商基于 xsaiAIRI 的 LLM 接入基于自研的 xsai 库类似 Vercel AI SDK 的精简实现。原文档列出的已支持提供商如下已支持 ✅AIHubMix推荐、OpenRouter、vLLM、SGLang、Ollama、302.AI、OpenAI、Anthropic Claude、DeepSeek、Qwen、Google Gemini、xAI、Groq、Mistral、Cloudflare Workers AI、Together.ai、Fireworks.ai、Novita、Zhipu智谱、SiliconFlow、Stepfun、Baichuan百川、Minimax、Moonshot AI月之暗面、ModelScope魔搭、Player2、腾讯云、小米 MiMo。期待 PR ⏳Azure OpenAI、AWS ClaudeAmazon Bedrock、Spark讯飞星火、火山引擎。这一供应商矩阵在仓库中也有实现层面的印证packages/provider-inference 的src/providers/cloud/目录下可见openai/、anthropic/、deepseek/、groq/、mistral-ai/、moonshot-ai/、minimax/、modelscope/、cloudflare-workers-ai/、together-ai/、fireworks-ai/、openrouter-ai/、xai/、zai/智谱等独立目录src/providers/local/下则有ollama/、lm-studio/、browser-web-speech-api/、voicevox/等本地运行时实现。6.2 推理层的设计意图从 packages/provider-inference 的目录结构可以推断AIRI 通过「cloud / local」两层抽象把云端 API 与本地模型统一收敛到同一套推理接口上云端侧覆盖各大厂商的 OpenAI 兼容与非兼容端点本地侧则覆盖 Ollama、LM Studio、浏览器 Web Speech API、VOICEVOX、vLLM TTS 等场景再配合registry.ts的运行时矩阵注册机制runtime-matrix.test.ts与runtime-matrix.browser.test.ts分别验证 Node 与浏览器运行时的注册一致性。七、整体架构Stage 共享包 服务通道 托管后端原文档用一张 Mermaid 流程图描述了项目整体架构下面转述为可读的分层说明对应 apps、packages、integrations、server 目录。Stage 应用层Webstage-web、Desktopstage-tamagotchi、Pocketstage-pocket实验性共享产品包层stage-uiUI 组件库packages/stage-ui包含 200 个 Vue 组件与 490 个 TS 模块、core-agent / core-character领域逻辑packages/core-agent、packages/core-character、pipelines-audiopackages/pipelines-audio、渲染器stage-ui-live2d、stage-ui-three 等、server-sdk / server-sharedpackages/server-sdk、packages/server-shared桌面服务通道层server-runtimepackages/server-runtime与 SDK 通过server channel双向通信集成层discord-botintegrations/discord-bot、minecraft-botintegrations/minecraft、Telegram、Factorio、MCP 等可选接入 SDK托管后端层Caddy 网关server/dev/caddy、api-serverserver/apps/api、auth-serverserver/apps/auth、PostgreSQL 与 Redis 存储值得注意的还有桌面端插件体系proj-airi/plugin-sdkpackages/plugin-sdk与proj-airi/plugin-sdk-tamagotchipackages/plugin-sdk-tamagotchi为 Tamagotchi 提供了插件化扩展能力而 plugins 目录下的实际插件如 homeassistant、claude-code、game-chess、web-extension 等则展示了生态的雏形。八、衍生子项目生态AIRI 仓库衍生出一批可独立使用的子项目覆盖工具链与周边生态Awesome AI VTuberAI VTuber 相关项目精选列表unspeech/audio/transcriptions与/audio/speech通用端点代理类似 LiteLLM 之于任意 ASR/TTShfupHuggingFace Spaces 部署与打包工具xsai-transformers为 xsAI 提供的 Transformers.js 实验性 ProviderWebAI: Realtime Voice ChatVAD STT LLM TTS 的实时语音聊天完整示例proj-airi/drizzle-duckdb-wasm/proj-airi/duckdb-wasmDuckDB WASM 的 Drizzle 驱动与易用封装仓库内目录见 packages/drizzle-duckdb-wasm、packages/duckdb-wasmAIRI Factorio /autorio/tstl-plugin-reload-factorio-mod让 AIRI 玩 Factorio 的系列组件Factorio RCON APIFactorio 无头服务器控制台的 RESTful API 封装Velin用 Vue SFC 与 Markdown 管理提示词Prompt的机制demodel多运行时/下载器的模型与数据集加速获取inventory模型目录与默认 Provider 配置的后端服务MCP Launcher统一管理 MCP 服务器的构建与启动器SAD自托管与浏览器运行 LLM 的文档与笔记九、社区、翻译与贡献官方组织 proj-airi 承载了 AIRI 衍生的所有子项目RAG、记忆系统、嵌入式数据库、图标、Live2D 工具等翻译项目托管在 Crowdin读者若发现译文不自然或不准确可在 Crowdin 上直接参与翻译与修正项目仍在早期开发阶段欢迎各类贡献者即使不熟悉 Vue.js / TypeScript也可以作为艺术家、设计师或直播主参与使用 React / Svelte / Solid 的开发者同样被欢迎——可以开启子目录添加自己想看到的功能。文档点名需要以下领域人才Live2D 建模、VRM 建模、VRChat 头像设计、计算机视觉、强化学习、语音识别、语音合成、ONNX Runtime、Transformers.js、vLLM、WebGPU、Three.js、WebXR结语Project AIRI 用「大脑、耳朵、口、身体」四个维度重新定义了开源 AI 数字伴侣的可能性既能通过 Web 技术在浏览器与移动端即开即用又能通过 Electron 桌面形态调用 CUDA / Metal 本地算力并接入 Discord、Minecraft、Factorio 等真实世界场景。配合 packages/provider-inference 的云 本地双层推理抽象、packages/core-agent 的 Agent 运行时以及 integrations 下的各类通道集成AIRI 展示了一条从「聊天机器人」走向「看得见、听得懂、说得出、动起来」的完整数字生命体实现路径。对于想要研究或自托管 AI VTuber 的开发者而言这是一个可直接上手、可深度定制的优秀蓝本。说明本文内容以 docs/README.ja-JP.md 为骨架仓库源码与目录结构仅作为补充佐证文中对源码目录结构的描述均为对当前仓库的如实引用涉及版本与命令以当前仓库实际内容为准。【免费下载链接】airi Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-samas altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.项目地址: https://gitcode.com/GitHub_Trending/ai/airi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考