人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载导读AIRIアイリ是一个自托管、归你所有的 AI 伴侣 / VTuber 项目其目标是让每个人都能拥有一个受 Neuro-sama 启发的赛博生命灵魂容器她既能陪你实时语音聊天、一起玩 Minecraft 与 Factorio也能在 Web、macOS、Windows 与移动端运行。本文基于项目官方 READMEdocs/README.vi.md的完整内容结合仓库源码与配置系统梳理 AIRI 的定位、安装方式、Web 技术选型、能力全景、LLM 提供商支持、多 Stage 开发工作流与桌面端 Server Channel 机制帮助开发者快速评估并上手这一项目。项目定位为什么需要赛博生命灵魂容器Neuro-sama 是当前知名的虚拟 VTuber能够一边玩游戏、一边与观众实时聊天互动被部分人称为数字人类。但她的实现并非开源直播结束后用户便无法再与她交互。AIRI 给出的答案是让你自己拥有一份数字生命体随时随地、自由交互。与 Character.ai、JanitorAI、SillyTavern 等聊天 / 角色扮演平台不同AIRI 从一开始就不是纯聊天工具而是强调陪你打游戏、看代码、在游玩中对话的完整数字伴侣。仓库根目录的 README.md 将其定位为 LLM powered virtual character并在 package.json 中以proj-airi/root为根、使用 pnpm 工作区管理整个 monorepo。需要注意的是项目明确声明官方不发行任何与项目相关的加密货币或 token参与社区时请仔细核实信息见 docs/README.vi.md 中的 WARNING 提示。安装与快速开始桌面端安装winget / Scoop / HomebrewAIRI 桌面版提供官方打包产物Windows 与 macOS 用户可通过系统包管理器直接安装Windows 使用 wingetwinget install MoeruAI.AIRIWindows 也可以使用 Scoopscoop bucket add airi https://github.com/moeru-ai/airi scoop install airi/airimacOS 使用 Homebrew Cask无需额外 tapbrew install --cask airiNix 运行项目在 flake.nix 中提供了完整的 Nix 打包packages.default指向nix/package.nix构建出的airi包并同时支持x86_64-linux、aarch64-linux、x86_64-darwin、aarch64-darwin四个系统。启用 flakes 后可直接运行nix run github:moeru-ai/airi对于在 NixOS 上运行 Electron 的场景flake 还提供了nix develop .#fhs开发环境FHS 环境显式注入 glib、nss、dbus、gtk3 等 Electron 运行所需的系统库并默认启用config.allowUnfree true。从源码运行README 给出的最小启动命令是pnpm i pnpm dev默认情况下pnpm dev启动的是Stage Web浏览器版若要开发桌面版需按 .github/CONTRIBUTING.md 配置正确环境。该贡献指南要求先通过mise install安装仓库 .tool-versions 中锁定的 Node.js 与 pnpm 版本再执行pnpm install——pnpm 版本同时受 package.json 的packageManager字段约束当前为pnpm11.24.0。核心技术栈以 Web 技术作为一切的基础AIRI 与多数 AI VTuber 开源项目的差异在于它从第一天起就建立在 Web 技术之上包括 [WebGPU]、[WebAudio]、[Web Workers]、[WebAssembly] 与 [WebSocket]。这意味着浏览器 / WebView 版本仅用于展示 Web 技术能达到的能力上限桌面版默认可利用NVIDIA CUDA与Apple Metal依托 HuggingFace 生态与candle项目无需复杂依赖管理图形、布局、动画与插件系统WIP仍复用 Web 技术以保持扩展性。仓库可以印证这套技术栈的落地根目录 pnpm-workspace.yaml 的 catalog 中锁定了onnxruntime-web、huggingface/transformers、three、pixiv/three-vrm、pixi-live2d-display、kokoro-js等依赖apps/stage-web/vite.config.ts 则通过VitePWA插件配置了 PWAregisterType: prompt、manifest 图标、workbox 缓存策略与navigateFallback并声明Sherpaw插件下载若干固定版本模型如paraformerBilingualZhEn、zipformerMultilingual、xAsrBilingualZhEnInt8DownloadLive2DSDK()下载 Live2D SDK另有Download(...)拉取 hiyori 系列 Live2D 模型与 AvatarSample VRM 模型作为演示资产。能力全景从大脑到身体README 以清单形式列出了当前进度结合仓库可以逐项落到实现大脑LLM 驱动玩游戏Minecraft已支持、FactorioWIPPoC 与 demo 已在 integrations/minecraft 与 airi-factorio 子项目中提供、Kerbal Space Program后续公布、Helldivers 2进行中。仓库中integrations/minecraft下 156 个 TypeScript 文件即其 Minecraft 集成实现依赖mineflayer系列库见 pnpm-workspace.yaml 的 catalog聊天Telegram、Discord 已支持。Discord 集成见 integrations/discord-bot/README.md其通过discord.js实现语音频道接入需要配置DISCORD_TOKEN、DISCORD_BOT_CLIENT_ID、LLM 与 TTS 相关环境变量记忆浏览器内数据库已支持 DuckDB WASM 与pglite相关封装见 packages/drizzle-duckdb-wasm/README.md 与 packages/duckdb-wasm/README.mdMemory Alaya 仍为 WIP浏览器内本地推理WebGPUWIP。听力感知输入接收浏览器音频、接收 Discord 音频客户端侧语音识别STT客户端侧语音活动检测VAD。音频底层实现在 packages/pipelines-audio/src 中其中 audio-input.ts 定义了AudioInput类它以LiveAudioSource如麦克风为输入向多个独立订阅者共享一路实时 PCM 流并支持历史保留historyMs回放——这样在检测到语音之前就已开始的说话内容也能被保留正是 VAD 场景所需的机制。语音输出TTS 支持多家提供商包括 ElevenLabs、Microsoft/Azure Speech、OpenAI 兼容 TTS、阿里云百炼Model Studio以及本地 Kokoro TTS。kokoro-js已被锁定在依赖 catalog 中pnpm-workspace.yaml。身体Avatar 表现VRM 支持模型控制以及眨眼、自动视线跟随、空闲时眼球运动等动画依赖pixiv/three-vrm与 three.jsLive2D 支持模型控制以及同样的眨眼 / 视线 / 眼球动画依赖pixi-live2d-display。支持的 LLM API 提供商由 xsai 驱动AIRI 的 LLM 调用层由xsaimoeru-ai 组织维护的轻量 AI SDK类似 Vercel AI SDK 但更小巧提供。README 列出的已支持提供商包括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 等Azure OpenAI、AWS Claude、讯飞星火Sparks、火山引擎为欢迎 PR状态。在仓库中这层能力由 packages/provider-inference/README.md 描述的proj-airi/provider-inference包落地它负责运行时无关的提供商定义提供listProviders()、getDefinedProvider(openai)等 API并定义了生成协议api: chat-completions | responses——OpenAI 默认responses、OpenAI Compatible 默认chat-completionsOpenAI 还提供默认关闭的webSearch开关仅限 Responses 协议。core-agent只面向统一的GenerationProvider接口把上下文直接投射到所选协议避免各提供商差异渗透到业务层。Stage 应用架构与开发工作流三个 Stage 应用AIRI 将运行时拆分为三个Stage舞台共享同一套产品包Stage形态目录启动命令Stage Web浏览器版线上为 airi.moeru.aiapps/stage-webpnpm devStage Tamagotchi桌面版Electronapps/stage-tamagotchipnpm dev:tamagotchiStage Pocket移动版Capacitor实验性apps/stage-pocketpnpm dev:pocket根目录 package.json 中的脚本与之一一对应dev、dev:tamagotchi、dev:pocket:ios、dev:pocket:android、dev:docs、dev:serverserver-runtime、dev:backendDocker Compose 拉起托管后端等工作区成员覆盖packages/**、apps/**、integrations/**、services/**、engines/**、server/**等目录见 pnpm-workspace.yaml。开发命令详解Stage Webpnpm dev即启动 Vite 开发服务器pnpm dev:web:https可结合vite-plugin-mkcert启用 HTTPSapps/stage-web/vite.config.ts 中通过--mkcert标志或STAGE_WEB_ENABLE_MKCERTtrue环境变量开启。Stage Tamagotchipnpm dev:tamagotchi使用electron-vite dev启动桌面开发模式脚本内部先执行install-electron。Nix 用户可直接nix run github:moeru-ai/airi。Stage Pocketpnpm dev:pocket启动 Capacitor Web 开发服务器输出类似下面格式的地址➜ Local: https://localhost:5273/ ➜ Network: https://ip-will-be-here:5273/然后打开 Xcode 运行 iOS 应用CAPACITOR_DEV_SERVER_URLhttps://your-ip-address:5273 pnpm open:iosapps/stage-pocket/capacitor.config.ts 会读取CAPACITOR_DEV_SERVER_URL环境变量并将其作为server.url注入同时按android/ios参数区分 appIdai.moeru.airi_pocket与ai.moeru.airi-pocket。文档站pnpm dev:docs启动基于 VitePress 的文档站开发服务器。发布运行npx bumpp --no-commit --no-tag更新 monorepo 版本号根目录 package.json 将bumpp固定在 devDependencies。整体架构README 用 mermaid 图概括了应用、共享包、桌面 Server Channel、集成与托管后端的关系核心脉络如下即三个 Stage 应用共用stage-ui等共享包桌面版额外内置server-runtimeServer Channel让 Discord、Minecraft 等集成与 Stage SDK 通过 WebSocket 信道与桌面本体通信托管后端由 Caddy 反代 api-server / auth-server数据落在 PostgreSQL 与 Redis 上。桌面端 Server Channel端口、TLS 与无线连接README 特别说明若需要在 Pocket移动版上以无线方式连接桌面 Tamagotchi 的 server channel需以 root 权限启动 Tamagotchisudo pnpm dev:tamagotchi随后在 Tamagotchi 的settings/connections中启用 secure websocket。对应实现位于 apps/stage-tamagotchi/src/main/services/airi/channel-server/index.ts默认监听端口为6121由SERVER_CHANNEL_PORT环境变量覆盖WebSocket 路径为/ws配置项包括hostname默认127.0.0.1、authTokenBearer 认证、tlsConfig启用后协议从ws升级为wss开启 TLS 时主进程用mkcert的createCA/createCert生成有效期 365 天的自签 CA 与证书覆盖 localhost、本机 IP 等 SAN 域名并尝试将 CA 安装进系统信任库macOS 用security add-trusted-cert、Windows 用certutil -addstore、Linux 用update-ca-certificates应用变更配置时若 hostname / authToken / TLS 任一变化会重启信道失败则回滚到上一份配置扫描连接时生成二维码载荷createServerChannelQrPayload便于 Pocket 扫码接入。客户端侧 SDK 见 packages/server-sdk/README.mdnew Client({ name, autoConnect })连接后connect()会等待 WebSocket 打开、认证成功且模块完成 announce 才 resolve并提供onEvent(input:text, ...)之类的事件订阅接口。国际化与贡献AIRI 的界面文案走packages/i18n翻译可经由 Crowdin 在线协作或直接修改 packages/i18n/src/locales 并提交 PR两种方式同步同一批翻译。注意不接收与英文原文逐字相同的翻译未翻译的字符串将回退显示英文。中文社区入口见 docs/wechat.mdREADME 中的 WeChat 链接指向该文件。详细开发规范与工具链配置mise、lint、测试、打包请参阅 .github/CONTRIBUTING.md。相关子项目与生态AIRI 组织下还维护了一批配套子项目README 中提及的包括unspeech面向任意 ASR / TTS 的统一/audio/transcriptions与/audio/speech代理端点类似 LiteLLM 的音频版、hfupHuggingFace Spaces 部署打包工具、xsai-transformersTransformers.js 的 xsAI 提供商、WebAI Realtime Voice ChatVAD STT LLM TTS 的实时语音完整示例、drizzle-duckdb-wasm与duckdb-wasm仓库内对应 packages/drizzle-duckdb-wasm 与 packages/duckdb-wasm、airi-factorio让 AIRI 玩 Factorio、autorio、demodel、inventory、MCP Launcher、SAD浏览器内自托管 LLM 的文档与笔记等。此外engines/stage-tamagotchi-godot目录表明桌面端正在引入 Godot 引擎舞台extraResources将 Godot 构建产物随 Electron 打包见 apps/stage-tamagotchi/electron-builder.config.ts这与其 DevLog 中游戏引擎方向的路线图一致。总结AIRI 是一个全栈式的数字生命体开源项目以 Web 技术为底座打通浏览器、桌面与移动端以xsai统一几十家 LLM/TTS 提供商以core-agentpipelines-audiostage-ui-*构成大脑、听觉与身体三大子系统并通过 Electron 内置 Server Channel 把 Discord、Minecraft、Telegram 等外部集成接到同一本体上。对于想研究AI 原生 VTuber 架构或自建 Neuro-sama 类伴侣的开发者AIRI 的 monorepo 是一个值得深入阅读的完整参考实现。赞分享人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手【免费下载链接】airi 自托管、归你拥有的 Grok 风格 AI 伴侣与 waifu / 赛博生命灵魂容器目标是接近 Neuro-sama 的高度支持实时语音聊天、Minecraft 和 Factorio 游玩支持 Web / macOS / Windows。项目地址https://gitcode.com/moeru-ai/airi点击查看免费下载相关推荐Gyroflow新手教程3步用陀螺仪数据稳定晃动视频Gyroflow新手教程3步用陀螺仪数据稳定晃动视频 Gyroflow 是一款开源、免费、跨平台的视频稳定工具它读取 GoPro、索尼等相机写入视频文件的陀云原生后端运维LunaTranslator 完整部署指南三步跑通视觉小说翻译器附故障速查LunaTranslator 完整部署指南三步跑通视觉小说翻译器附故障速查 LunaTranslator 是一款 Windows 端的视觉小说Visual桌面应用AI 应用AIRI 开源项目全景指南复刻 Neuro-sama 的自托管 AI 伴侣灵魂容器安装、开发与架构解析AIRI 开源项目全景指南复刻 Neuro sama 的自托管 AI 伴侣灵魂容器安装、开发与架构解析 本指南以 Project AIRI 官方 RE人工智能AI AgentMCP 服务工具调用GUI 自动化语音数字人交互助手后端上一篇BottomBar多进程适配实现跨进程更新导航状态下一篇旧微信聊天找不到WeChatMsg 本地导出记录永久保存还能出一份年度聊天报告创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考