如何拥有一个实时语音、能陪玩的 AI 虚拟伴侣AIRI 自托管部署与使用全解【免费下载链接】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/airiAIRI 是一个完全开源、可自托管的 AI 虚拟伴侣项目它会说话、能听你语音、支持 VRM / Live2D 形象还能真正进 Minecraft 和你一起打怪、在 Discord 和 Telegram 里陪聊。因为部署在你自己的设备或服务器上对话记录、角色设定和 API 密钥都由你自己掌控不依赖任何第三方账号体系。下面按先跑起来再逐个解锁功能的顺序带你从零走到一个可以语音对话的 AI 伴侣。一个不止于聊天的 AI 伴侣市面上接入大模型 API 就能聊的网页应用很多AIRI 的差别在于它是一个完整的运行平台浏览器、Windows、macOS、移动端都支持内置实时语音识别与合成管线桌面版还能调用本地 GPUNVIDIA CUDA、Apple Metal做推理。更特别的是它的动手能力——项目内置了 Minecraft 机器人服务可以帮你收集材料、盖房子Factorio 玩法也有专门的配套实现。它的设计思路接近 Neuro-sama一个能看、能听、能玩、能聊的赛博生命但 AIRI 把这套能力完全开源让你在自己机器上就能复刻。跑起来三条上手路径按你的环境选AIRI 用 pnpm 管理 monorepo克隆仓库后先执行pnpm install。之后根据你的环境选一条路径在浏览器里先试水只想感受效果的读者启动 Web 版开发服务器即可pnpm dev默认拉起的 apps/stage-web/ 就是浏览器版git clone https://gitcode.com/GitHub_Trending/ai/airi cd airi pnpm install pnpm dev浏览器版基于 WebGPU、WebAudio、Web Worker 等技术构建适合作为第一个体验入口也能帮开发者快速验证功能边界。把桌面版装到系统里桌面版stage-tamagotchi功能最全支持窗口模式、系统托盘、本地 GPU 加速。各大平台都有一键安装渠道Windowswinget install MoeruAI.AIRI或 Scoopscoop bucket add airi后scoop install airi/airimacOSbrew install --cask airiLinux从 Releases 页面下载 AppImage / Snap 包如果你是开发者也可以从源码启动桌面版pnpm dev:tamagotchi。用 Docker 构建一个可长期运行的 Web 服务想在服务器上长期跑一个随时打开网页就能聊的实例项目自带 apps/stage-web/Dockerfile。构建过程会编译 Web 版、文档站和 UI 组件库最终打包进 nginx 镜像docker build -t airi-web -f apps/stage-web/Dockerfile . docker run -d -p 3000:80 --name airi airi-web容器对外暴露 80 端口映射到本机 3000 即可访问。注意AIRI 的大模型能力来自你在界面里配置的 API 密钥而不是环境变量——容器只负责托管前端与文档。第一次对话从启动向导到接入大模型无论哪种方式启动首次进入都会看到 Welcome to AIRI 引导页提示你设置第一个 AI 服务商。点 Lets do it! 后按界面指引填入密钥即可。AIRI 通过内置的 xsai 层统一接入大模型官方支持的提供商超过 30 家常见的包括OpenAI、Anthropic Claude、DeepSeek、Google Gemini、xAI、Groq、Mistral以及本地方案Ollama 和 vLLM意味着可以完全离线运行。完整清单可以在文档里按厂商逐页查看中文文档docs/content/zh-Hans/docs/各服务商配置说明docs/content/zh-Hans/docs/manual/config/providers/选好模型后你可以在角色设定中定义 TA 的名字、性格、说话方式——本质上是提示词工程写一段人物小传即可。角色卡模板放在 docs/content/zh-Hans/docs/manual/tamagotchi/character-card-template.md。让 TA 开口说话实时语音链路怎么配置AIRI 的语音由三段管线组成都支持在设置面板里独立选择厂商耳朵ASR客户端侧语音识别把麦克风输入转成文字支持多种语言触发VAD客户端说话检测决定什么时候轮到 TA 回话嘴巴TTS多厂商语音合成包括 ElevenLabs、Microsoft/Azure Speech、OpenAI 兼容接口、阿里云模型以及本地 Kokoro TTS——本地方案不依赖网络隐私也更好配置入口在设置页的 speech / transcription 分区文档逐厂商给了配置示例TTS 配置docs/content/zh-Hans/docs/manual/config/providers/speech/语音总览docs/content/zh-Hans/docs/manual/config/audio.md从聊天到游戏Minecraft、多平台与记忆AIRI 最有意思的部分在聊天之外Minecraft 陪玩integrations/minecraft/ 内置了一个四层认知架构的机器人感知 → 反射 → 意识 → 行动LLM 负责规划盖房子这类任务再拆成收集木材、合成木板、建造墙体等动作逐步执行。配置.env.local后运行pnpm -F proj-airi/minecraft-bot dev即可连接服务器。官方提醒只把它连到你信任的本地/私人服务器Factorio有独立的 airi-factorio 子项目在推进工厂自动化玩法社交平台聊天Discord 语音/文字频道integrations/discord-bot/、Telegram 机器人integrations/telegram-bot/都有现成实现让 TA 的陪伴不限于一台电脑记忆浏览器内嵌 DuckDB WASM 数据库为长期记忆打基础相关实现在 packages/drizzle-duckdb-wasm/ 与 packages/memory-pgvector/形象支持 VRM 与 Live2D 模型自动眨眼、视线跟随、待机眼动都有渲染层在 packages/stage-ui-three/ 和 packages/stage-ui-live2d/桌面版还支持窗口模式等玩法——把 TA 做成桌面上一个可拖动、可缩放、鼠标悬停可淡入淡出的小窗口工作时就在屏幕角落陪着移动端则由 apps/stage-pocket/ 基于 Capacitor 打包iOS / Android 均可安装卡住了对照这份排错清单首次启动没有声音确认浏览器已授予麦克风权限桌面版检查系统默认音频输入/输出设备API 请求失败核对密钥、Base URL 与模型名三件套本地部署 Ollama/vLLM 时确认服务已在localhost监听语音响应慢或断断续续把 TTS 换成延迟更低的厂商或改用本地 Kokoro嘈杂环境下先开启 VAD 灵敏度调节Minecraft 机器人连不上检查.env.local中服务器地址与端口该服务只建议用于可信服务器桌面版性能不佳优先确认显卡驱动已启用 CUDA / Metal 加速浏览器版遇到复杂场景可切到桌面版继续深入文档与源码入口想自己动手改点什么这些目录是最好的起点官方文档总入口docs/README.zh-CN.mdAI 核心与角色系统packages/core-agent/、packages/core-character/语音管线packages/pipelines-audio/、packages/audio/桌面版应用apps/stage-tamagotchi/Web 版apps/stage-web/服务端API / 认证 / 数据库server/AIRI 目前仍处于快速迭代阶段桌面版与 Godot 渲染引擎等新方向都在持续推进。从浏览器里的一次pnpm dev开始先让 TA 开口说话再逐步解锁语音、游戏和多平台——这就是拥有自己 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考