
AIRI 完全指南Electron Capacitor 多端自托管 LLM 虚拟角色一、AIRI 是什么从 Neuro-sama 到你自己的数字生命二、为什么说它生而多端Web 技术栈的底层红利这个方向选反了有什么好处三、三端架构详解桌面 / 网页 / 移动的技术取舍与模型支持3.1 桌面版 stage-tamagotchiElectron3.2 网页版 stage-webPWA3.3 移动版 stage-pocketCapacitor3.4 三端能力差异对照表3.5 共享核心四、Brain / Ears / Mouth / Body一个虚拟角色的四象限能力4.1 Brain大脑 / Agent4.2 Ears耳朵 / 输入4.3 Mouth嘴巴 / TTS4.4 Body身体 / 形象五、可扩展性骨架30 LLM 提供商、插件系统与 Eventa/injeca 架构5.1 第一条轴LLM 提供商30 家5.2 第二条轴插件系统5.3 第三条轴IPC 与 DI 架构5.4 Monorepo 规模六、自托管让记忆和声音真正归你所有三个服务各有分工七、如何上手三行命令启动 周边生态一览7.1 安装系统包管理器最省事7.2 开发启动改源码三行命令覆盖三端7.3 周边生态八、适合谁、现状如何、未来在哪适合谁现状展望AIRI 完全指南Electron Capacitor 多端自托管 LLM 虚拟角色如果你正在找一个可以自托管、支持多端、LLM 驱动的虚拟角色开源项目那 Project AIRIGitHub 48k Star值得花 10 分钟读完这篇文章。它解决了三个开发者最在意的问题第一同一个 AI 角色带记忆和声音能跑在桌面、浏览器、手机三端不再换个设备从头再来第二模型驱动覆盖 Live2D / MMD / Spine / VRM 四种格式第三自托管栈完全开源MIT记忆用 Postgres 18 vchord 向量扩展docker-compose 三行命令拉起。本文基于最新 release v0.11.3从架构差异、四象限能力、30 LLM 提供商、Eventa/injeca IPC 设计到自托管部署与三行命令启动全部带可运行代码与对比表格文末有完整命令清单可直接复制使用。一、AIRI 是什么从 Neuro-sama 到你自己的数字生命AIRI 的package.json描述只有一句话–“LLM powered virtual character”。官方中文定位更直白复刻 Neuro-sama让 AI waifu / 虚拟角色也能来到我们的世界。Neuro-sama 是引爆 Twitch 的 AI VTuber但不开源、不可自托管AIRI 给出了另一种可能把同样的体验开源、可改、可自托管地交还到你手里。核心愿景写得很清楚–「let you own your digital life, cyber living, easily, anywhere, anytime」。协议是 MITCopyright © 2024-PRESENT Neko Ayaka。想先体验不装也行在线版在airi.moeru.ai文档站是airi.moeru.ai/docs/。二、为什么说它生而多端Web 技术栈的底层红利很多 AI 陪伴项目走原生优先Web 补齐路线–先做 iOS/Android app再考虑要不要出网页版。AIRI 走了相反方向从第一天起就基于 Web 技术栈再向原生扩展。README 列得很清楚WebGPU、WebAudio、Web Workers、WebAssembly、WebSocket是它一开始就依赖的能力。这个方向选反了有什么好处浏览器天然跨平台PWA 一开移动端也就有了–AIRI 的移动版正是通过 PWA 与 Capacitor 共同支持的。桌面版可通过 candleHuggingFace使用原生 NVIDIA CUDA 与 Apple Metal 加速无需你在每台机器上手动装一套 CUDA 工具链。灵活性留给了你需要 TCP 连接、Discord 语音频道、玩 Minecraft / Factorio 这种非 Web能力时桌面运行时可以打开这些扩展通道。换句话说Web 不是 AIRI 的降级版而是它的根。原生是叠加在 Web 之上的能力加强而不是另一套重写的代码。这是它能同时覆盖桌面、网页、移动三端的根本原因。三、三端架构详解桌面 / 网页 / 移动的技术取舍与模型支持三个正式应用共享packages/stage-ui核心包但运行时与模型支持有明确差异–这不是一套代码三端跑的营销话术而是有意识的能力分层。3.1 桌面版 stage-tamagotchiElectron技术栈Electron electron-vite electron-builder前端用 Vue 3、Pinia、VueUse、reka-ui、UnoCSS、Three.jstresjs/core、Valibot。appId 是ai.moeru.airi构建脚本分build:win/build:mac/build:linux。它依赖的模型驱动包最全stage-ui-live2dstage-ui-mmdstage-ui-spinestage-ui-three–Live2D、MMD、Spine、VRM 四种格式全支持三端里覆盖最广。其他关键依赖injeca依赖注入moeru/eventa类型安全 IPCmodelcontextprotocol/sdkMCP 支持chess.jsuiohook-napi全局输入钩子electron-updater3.2 网页版 stage-webPWA技术栈Vue 3 Vite vite-plugin-pwa后端用 honoWIP认证用 better-authORM 是 drizzle-orm外加model-driver-mediapipe。在线访问airi.moeru.ai。模型驱动依赖只有stage-ui-live2dstage-ui-three即Live2D VRM。注意后端 hono 仍是 WIPAGENTS.md 明确标注 “Web backend: WIP”别把它当稳定后端用。3.3 移动版 stage-pocketCapacitor基于capacitor/androidcapacitor/iosiOS 与 Android 都支持里面有 Swift 原生层lint:swift脚本可验、barcode-scanner、local-notifications。开发脚本是dev:ios/dev:android。模型驱动依赖只有stage-ui-three目前以VRM 为主–这里如实表述不要夸大成支持所有模型格式事实就是移动端目前只挂了 three 这一个驱动。3.4 三端能力差异对照表维度桌面版网页版移动版Live2D✅✅❌MMD✅❌❌Spine✅❌❌VRM✅✅✅原生 GPU 加速CUDA/Metal via candle✅❌❌后端自托管可选WIPhono依赖网页版或自托管3.5 共享核心packages/stage-ui是三端共用的业务核心搭配stage-layouts、stage-pages等共享页面基座以及stage-shared跨端逻辑、model-driver-lipsync、model-driver-mediapipe等驱动包–它们作为 monorepo 内的共享模块存在各端按需直接或间接引入例如移动端目前主要用到stage-ui-three并未直接依赖stage-pages与两个 model-driver。另外有一个实验性的 Godot 引擎版位于engines/stage-tamagotchi-godot感兴趣可以关注但不是主线。四、Brain / Ears / Mouth / Body一个虚拟角色的四象限能力AIRI 把虚拟角色拆成四象限这种分法让能力扩展变得很清晰。4.1 Brain大脑 / Agent会做事的部分。它能玩 Minecraft、Kerbal Space ProgramFactorio 支持是 WIP独立仓库airi-factorioHelldivers 2 也是 WIP。社交侧接入了 Telegram 与 Discord 聊天。记忆系统设计很有意思浏览器端用 DuckDB WASM / pglite 做纯浏览器数据库服务端用 Postgres 向量扩展承载长期记忆Memory Alaya更进一步的方案仍标注 WIP还有一个颇具野心的方向纯浏览器 WebGPU 本地推理WIP–如果这条路线走通浏览器里跑 LLM 就不再是技术演示。4.2 Ears耳朵 / 输入负责听。包括浏览器音频输入、Discord 音频输入、客户端语音识别、客户端说话检测。这是实时语音对话的前置条件决定了角色能不能被打断。4.3 Mouth嘴巴 / TTS负责说。AIRI 不绑死单一 TTS而是接了多家ElevenLabsMicrosoft / Azure SpeechOpenAI 兼容 TTS阿里云 Model Studio本地 Kokoro TTS对自托管用户特别友好意味着说话这一环可完全离线4.4 Body身体 / 形象负责演。README 详列的是 VRM 与 Live2DVRM 支持控制加动画自动眨眼、注视、闲置眼球运动Live2D 支持同款动画。MMD 与 Spine 在桌面版也挂载了但 README 没有展开它们的具体动画能力是否与 VRM/Live2D 完全对等这部分建议参考官方文档。四象限的扩展性背后其实是下一节要讲的 LLM 提供商、插件系统与 IPC 架构在支撑。五、可扩展性骨架30 LLM 提供商、插件系统与 Eventa/injeca 架构AIRI 的扩展性可以拆成三条相对独立的轴它们正交生长。5.1 第一条轴LLM 提供商30 家由 xsAI 驱动。列表里既有国际主流也有国内厂商与聚合/自托管方案国际主流OpenAIAzure、Anthropic Claude、Google Gemini、xAI、Groq、Mistral、Together.ai、Fireworks.ai、Novita、Cloudflare Workers AI国内厂商DeepSeek、Qwen通义、Zhipu智谱、SiliconFlow硅基流动、Stepfun、Baichuan、Minimax、Moonshot月之暗面、ModelScope、Tencent Cloud腾讯云、Xiaomi Mimo小米聚合与自托管AIHubMix、OpenRouter、302.AI、vLLM、SGLang、Ollama、Player2注意这里没有默认模型是 Grok这种说法–LLM 是可配置的你在设置里选谁就是谁。5.2 第二条轴插件系统plugins/目录下有 5 个已落地的插件证实存在不是规划airi-plugin-bilibili-laplaceB 站集成airi-plugin-claude-codeClaude Code 集成airi-plugin-game-chess下棋游戏airi-plugin-homeassistant智能家居 Home Assistantairi-plugin-web-extension浏览器扩展services/下另有 6 个机器人/集成服务discord-bot、telegram-bot、twitter-services、satori-bot、minecraft、computer-use-mcp。5.3 第三条轴IPC 与 DI 架构IPCElectron 主进程与渲染进程之间用moeru/eventa做类型安全的 IPC/RPC契约集中定义在apps/stage-tamagotchi/src/sharedDI依赖注入用injeca组合示例在apps/stage-tamagotchi/src/main/index.tsMCP通过modelcontextprotocol/sdk接入AIRI 可作为 MCP client 接入更广的工具生态5.4 Monorepo 规模包管理pnpm10.33.0构建turbo整体规模6 apps 48 packages 5 plugins 6 services测试Vitest含vitest/browser-playwrightLintmoeru-lintantfu/eslint-config oxlint这种规模能跑起来本身就说明工程化做得相当扎实。六、自托管让记忆和声音真正归你所有自托管是 AIRI 的核心叙事–前面说的让记忆归你技术兑现就在这里。自托管服务器栈叫proj-airi-server配置在apps/server/docker-compose.yml关键服务节选如下# apps/server/docker-compose.yml服务名: proj-airi-serverservices:db:image:ghcr.io/tensorchord/vchord-postgres:pg18-v1.0.0# Postgres 18 向量扩展 vchordports:[5435:5432]redis:image:redis:7-alpineports:[6379:6379]api:build:{context:../..,dockerfile:apps/server/Dockerfile}command:[pnpm,-F,proj-airi/server,run,server,api]ports:[6112:3000]depends_on:[db,redis]三个服务各有分工db使用 TensorChord 的 vchord-postgres 镜像Postgres 18 vchord 向量扩展专门用来存向量记忆redis负责缓存与队列apiAIRI 的服务端端口映射6112:3000依赖 db 与 redis 的健康检查通过才启动数据链路浏览器端的 DuckDB WASM / pglite 负责本地短期记忆服务端的 Postgres vchord 负责长期向量记忆–完整闭环。提醒docker-compose 只展示服务编排不含完整的部署文档、最低硬件要求与初始化步骤。真要上生产建议参考官方文档。MIT 协议 自托管是开头钩子里记忆归你的技术兑现–你不仅能跑还能改、能分发、能审计。七、如何上手三行命令启动 周边生态一览7.1 安装系统包管理器最省事# Windowswinget / scoop 二选一winget install MoeruAI.AIRI scoop bucket add airi https://github.com/moeru-ai/airi scoop install airi/airi# macOSbrewinstall--caskairi通用方案是去 GitHub Releases 下载 v0.11.3 对应平台的产物用 Nix 的话可以nix run github:moeru-ai/airi7.2 开发启动改源码三行命令覆盖三端pnpmipnpmdev# 默认启动 stage-web浏览器版pnpmdev:tamagotchi# 桌面版Electronpnpmdev:pocket:ios# 移动版 iOSCapacitor7.3 周边生态AIRI 孵化出了一批子项目都和自托管 AI 角色这条主线相关unspeech通用 ASR/TTS 端点代理类 LiteLLM但面向语音hfupHuggingFace Spaces 部署工具xsai-transformers把 Transformers.js 接成 xsAI providerVelin用 Vue SFC Markdown 写有状态的 LLM promptinventory模型目录与默认 provider 配置后端MCP LauncherMCP server 启动器定位类似Ollama for modelsSAD自托管与浏览器运行 LLM 的文档airi-factorio与AIRI DomeKeeper游戏 AI 衍生品还有独立组织proj-airiGitHub承载 RAG、记忆系统、嵌入数据库、图标、Live2D 工具等更细分的子项目。八、适合谁、现状如何、未来在哪适合谁想自托管 AI 陪伴、让数据归己的开发者想在桌面、网页、手机上体验同一个角色的用户Live2D / MMD / Spine / VRM 模型作者你的作品能直接跑起来研究 LLM Agent 游戏能力的实验者Minecraft、Kerbal 都已经能玩现状AIRI 仍处于早期开发阶段官方在 README 里明确招募开发者、艺术家、设计师加入翻译托管在 Crowdin。重要声明项目无任何官方加密货币或代币遇到以 AIRI 名义发币的都是诈骗。展望接下来值得关注的几条线WebGPU 纯浏览器本地推理WIPMemory AlayaWIPFactorio 与 Helldivers 2 支持WIP网页版 hono 后端的完善这几条一旦落地AIRI 的自托管 多端 本地推理叙事会再上一个台阶。项目地址github.com/moeru-ai/airi在线体验airi.moeru.ai。让 AI 陪伴不止活在一块屏幕里–这是 AIRI 想做的事也是它已经迈出的一大步。 博客主页https://xiaoy.blog.csdn.net 本文由呆呆敲代码的小Y原创 学习专栏推荐Unity系统学习专栏 游戏制作专栏推荐游戏制作Unity实战100例专栏推荐Unity 实战100例 教程 欢迎点赞 收藏 ⭐留言 如有错误敬请指正 未来很长值得我们全力奔赴更美好的生活✨------------------❤️分割线❤️-------------------------资料白嫖技术互助学习路线指引点击解锁知识定位人群定位 Unity系统学习专栏入门级本专栏从Unity入门开始学习快速达到Unity的入门水平 Unity实战类项目进阶级计划制作Unity的 100个实战案例助你进入Unity世界争取做最全的Unity原创博客大全。❤️ 游戏制作专栏难度偏高分享学习一些Unity成品的游戏Demo和其他语言的小游戏 游戏爱好者万人社区互助/吹水数万人游戏爱好者社区聊天互助白嫖奖品 Unity100个实用技能Unity查漏补缺针对一些Unity中经常用到的一些小知识和技能进行学习介绍核心目的就是让我们能够快速学习Unity的知识以达到查漏补缺