AIRI 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/airiAIRI 是一个可自托管的开源 AI 伴侣项目主打实时语音对话、虚拟形象渲染还能陪你打 Minecraft、管理 Factorio 工厂。它解决的是聊天机器人只会打字的问题这里有一个会说话、有形象、能动手操作游戏的数字伙伴而且数据全部落在你自己的机器上。适合想本地部署 AI 伴侣、折腾桌面应用或容器环境的开发者和技术爱好者。环境准备部署 AIRI 前要备齐什么动手前先确认几件事省得中途卡壳。AIRI 本身是前端应用加后端服务的组合浏览器版本几乎零门槛桌面端和自托管则需要 Node 工具链。一台内存 8GB 以上的电脑跑 Web 版 4GB 够桌面端和语音功能建议更高一个 AI 服务商的 API KeyOpenAI、Claude、DeepSeek、Gemini 等 20 多家都支持先到对应平台注册拿密钥pnpm 包管理器自托管部署依赖它Node 18 以上版本即可稳定的网络连接模型推理走云端 API 时断网对话就停了可选Docker如果你计划容器化部署提前装好三种方式启动 AIRI从浏览器到自托管浏览器版适合只想快速体验的人。打开官方 Web 站点就能用在设置面板里填好 API Key选一个模型立刻可以开聊全程不用装任何东西。桌面端适合想要完整功能的用户本地 GPU 加速、系统托盘常驻、无边框窗口形态。Windows 直接装安装包macOS 用户运行brew install --cask airiLinux 用 AppImage 即可。自托管适合想把整套源码跑在自己机器上的人。这条命令克隆仓库、装依赖并启动 Web 版开发服务器git clone https://gitcode.com/GitHub_Trending/ai/airi cd airi pnpm install pnpm dev容器化部署 AIRI 与传递配置仓库内置了 Web 版的 Dockerfile构建和运行各一条命令搞定。这条命令把项目构建成一个 nginx 托管的静态镜像docker build -t airi-app -f apps/stage-web/Dockerfile .镜像就绪后启动容器把宿主机的 3000 端口映射到容器 80 端口docker run -d -p 3000:80 --name airi airi-app关于环境变量先说清楚它的边界免得你踩坑VITE_ENABLE_ANALYTICS是否启用使用统计构建期参数默认关闭API Key 不需要也不应该塞进容器环境变量——它是应用内配置启动后在设置面板里填入需要带服务端的能力时参考 server/docker-compose.yaml 起完整后端栈调成你喜欢的样子接模型、调参数、定人设配置分三步递进顺序别反了。先接通模型。打开设置里的服务商列表选一家DeepSeek 对中文友好OpenAI 稳定性高Gemini 上下文长把 Key 粘进去。AIRI 的 推理服务商定义 把各家接口抽象成了统一列表填完可以立即测连通性。再调参数。模型选定后调整上下文长度控制它记多久改 temperature 影响回复的跳脱程度语音侧则选合成音色和语速。这几项在设置面板里都是下拉框和滑杆改完生效不用重启。最后定制人设。给角色起名、写一段提示词描述性格、说话习惯、兴趣边界。写具体一点效果最好比如毒舌但护短的老玩家聊游戏时爱用行话比友善的助手能出效果得多。用起来是什么样的对话、游戏与语音日常对话场景。下班后打开桌面端她在系统托盘里等你。你随口吐槽今天的项目评审她会接住情绪、记住你上周提到的 deadline回复时形象同步做口型动作像身边多了个真听得见的人。上下文记忆让长对话不断片系统托盘常驻随时唤起随时收多语言混聊没问题游戏协作场景。开一局 Minecraft她以玩家身份进服你指挥去建个储物间她真的动手挖方块、放箱子顺带报材料进度打 Factorio 时她盯着产线瓶颈给你调配方。这不是演示视频里的脚本是 Minecraft 集成模块 里实打实的 agent 循环。语音交流场景。打开麦克风不用打字直接聊。她说出的每句话都有合成语音输出嘈杂环境下有降噪兜底你打断她时她会停下来听你对话节奏接近真人通话。部署 AIRI 常见问题的排查思路现象填了 Key 后回复报 401。原因Key 过期、复制带空格、或服务商区域不匹配。解决重新生成 Key粘贴后手动点连通性测试。现象语音输出卡顿或无声。原因合成走的是云端 API网络延迟高或麦克风权限没给浏览器/桌面端。解决换低延迟服务商先在系统层授权音频设备。现象pnpm install中途报错。原因Node 版本过低或网络没装全依赖。解决升到 Node 18重跑安装镜像源配置能救大部分情况。现象桌面端 Minecraft 玩不了。原因游戏功能依赖原生 TCP 连接纯 Web 端跑不起来。解决装桌面版并按 Minecraft 集成说明 配置服务器地址。深入探索AIRI 文档、源码与社区想读代码或搭二次开发环境这几个入口最有用官方文档完整使用手册多语言版本都在 docs/content/ 下AI 核心逻辑对话主循环、记忆、工具调用都在这个包语音处理模块识别、合成、噪音过滤的实现插件目录浏览器扩展、Claude Code、游戏插件等可参考的扩展写法Discord 机器人 与 Telegram 机器人把伴侣接到聊天软件的两个现成方案最后一步建议先花十分钟跑通浏览器版把 Key 填好、对话聊通确认自己愿意长期用这个形态。觉得顺手了再装桌面端加语音和游戏确定要长期自托管时最后一步才上容器。顺序反了排错的成本会翻倍。【免费下载链接】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），仅供参考