AIRI 开源AI伴侣部署指南15分钟完成首次语音对话与Minecraft陪玩【免费下载链接】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 打怪建家的伙伴数据和配置都掌握在你手里。三分钟第一次对话AIRI Web 版三步走Web 版是验证它到底能不能用最快的路径不用装任何环境也不用管依赖版本三分钟看到角色回你第一句话就说明模型链路已经通了后面所有工作都只是加功能。这条路只覆盖浏览器桌面端和容器化在后面单独讲。用浏览器打开 AIRI 网页版官方 README 里有在线演示入口如果你已经自己跑起来了直接开终端提示的本地地址首页点击开始吧进入模型配置页。在服务商选择页挑一个你熟悉的大模型服务填入 API 密钥如果选的是OpenAI 兼容站点还要补一行 Base URL也就是那家服务商 API 的访问地址。从模型列表里选一个非思考模型——带思考链的模型每句话都要先想一想响应明显变慢会影响后面的语音对话体验。然后在输入框发出你的第一句话。按你的设备选部署路线从浏览器到 Docker 挑一条跑通网页版之后下一个问题是程序放在哪里。同一套代码拆成了网页apps/stage-web、桌面apps/stage-tamagotchi、移动端apps/stage-pocket几个形态对普通用户最有用的是前两者。下面按设备各给一条最短路线选一条即可不要全装。浏览器打开即用或本地起一份如果你只是想体验功能、不想管环境停在网页版就够了想自己掌控一份也顺便熟悉源码结构就在仓库根目录起开发服务器pnpm dev启动的正是 Web 版git clone https://gitcode.com/GitHub_Trending/ai/airi cd airi pnpm i pnpm devWindows一条 winget 命令终端里执行winget install MoeruAI.AIRI或者去官方 release 页下载安装包。想本地跑模型、要显卡加速或者准备玩游戏的选桌面版。macOS用 Homebrew 装brew install --cask airi装完直接打开应用即可桌面版默认能调用 Apple Metal 做本地推理比网页版能干的事多。LinuxAppImage 直接跑从官方 release 页下载 AppImage双击即可运行不需要额外装运行时。如果你的机器没有图形界面比如一台常开的服务器就别走这条路直接看下一段。AIRI Docker 部署两条命令出一个容器容器就是把程序和它的运行环境打包成一个镜像任何装了 Docker 的机器都能原样跑起来。AIRI 的镜像由apps/stage-web/Dockerfile构建包含网页版和文档容器内用 nginx 监听 80 端口所以宿主机映射到 3000 即可docker build -t airi-app -f apps/stage-web/Dockerfile . docker run -d -p 3000:80 --name airi airi-app跑起来后浏览器访问localhost:3000。这种路线适合给家里局域网或一台小服务器部署一份多台设备共用的场景。从 API 密钥到第一句对话补齐三处配置密钥是大脑的燃料后面三处配置则决定这个角色的人设。没有密钥她不会开口没有角色卡她只是一个通用助手——所以这一步值得慢一点把每处的作用搞明白后面调性格、换模型心里才有数。模型选择、角色卡这些都作用在 AI 核心源码 描述的推理与角色层上。先选服务商和拿 key。AIRI 支持 OpenAI、Claude、DeepSeek、Google Gemini、Ollama本地模型无需 key等二十多家完整清单见服务商配置文档。Key 都去各家官方控制台或开放平台的应用管理页领取复制后填进 AIRI 对应的服务商配置项。第一处模型选择。它决定回复质量的天花板建议选响应快的非思考模型同一张角色卡下也可以给不同机体模块绑不同模型先拿一个主力模型跑通再说。第二处语气与记忆。角色卡Character Card是描述角色名称、性格、说话方式的一组提示词相当于人设说明书记忆则靠上下文窗口和内置的浏览器端数据库维持切换角色卡会整套切换人设和模型。第三处角色名称与形象。在舞台Stage上挑选内置的 VRM 或 Live2D 模型首页右上角可以切换角色卡与形象名称和人设都跟着角色卡走。让伙伴真正用起来语音、游戏与接入渠道三条路到这一步 AIRI 已经能打字聊天了但真正用起来意味着她要有声音、能陪你打游戏、还能住进你常待的聊天软件里。这三条路互相独立、可以各开各的建议先开语音再碰游戏。AIRI 语音对话让她开口也让她听见你语音分两半语音合成TTS把文字变成声音和语音识别ASR把你的话变成文字两者可以只配一边。配好后你得到的是一次不用打字的自然对话——她说给你听你直接对她讲。开启方式设置 → 服务商 → 语音合成里填入凭据再到发声页选模型和音色、播放测试文本听觉页同理配置识别服务并选麦克风。注意内置的 Kokoro TTS 不支持中文中文用户要另加一家服务商详见语音配置文档。AIRI 游戏互动陪她玩 Minecraft 和 Factorio游戏互动是 AIRI 区别于普通聊天机器人的地方Minecraft 这条线已经可用她会通过 Mineflayer 连进服务器接收上下文、执行游戏内动作Factorio 方向有独立的 airi-factorio 子项目目前处于 PoC 阶段能帮你盯着工厂流水线。开启方式在仓库的 integrations 目录把模板复制成本地配置填上你的服务器地址再启动cp integrations/minecraft/.env integrations/minecraft/.env.local pnpm -F proj-airi/minecraft-bot dev安全提醒只有一条只连你自己搭建或完全信任的服务器别连来路不明的公共服。更多细节看Minecraft 集成文档。插件生态把角色拉进 Discord 和 Telegram这两条渠道的作用是让角色离开 AIRI 主界面、住进你日常聊天里Discord 里她能接消息、进语音频道Telegram 里你能随时 她。开启方式在 Discord 开发者控制台创建应用和 Bot、开启 Server Members 与 Message Content 权限把 Token 等凭据存进integrations/discord-bot/.env.local然后pnpm -F proj-airi/discord-bot startTelegram 同样在 integrations 目录下配置。步骤细节分别见Discord 机器人文档和Telegram 机器人文档。踩坑速查出问题先对号入座新手第一周遇到的问题九成在下面这六类里。每一条都按现象 → 原因 → 一句话解法写先对现象再动手。该说话时没有声音→ 发声页的服务商、模型、音色三样缺一样或只用了不支持中文的内置 Kokoro → 换一家支持中文的 TTS 服务商并在测试区放一段试听。语音输入没有文字出来→ 麦克风权限没给或选错了输入设备 → 在系统/浏览器授权后回听觉页选对麦克风再说一句短句。回复明显慢半拍→ 选了带思考链的模型 → 换成非思考模型流畅度立竿见影。密钥被拒报 401 一类错误→ key 抄错、余额为零或 OpenAI 兼容站点漏填 Base URL → 重新粘贴密钥并补齐 Base URL两家都查一遍。启动时提示端口被占用→ Docker 映射的 80/3000 或开发端口已被别的进程占掉 → 换一个空闲端口-p 3001:80这类写法即可。浏览器里 3D 形象不显示或卡顿→ 浏览器的 GPU 链路没走通 → 换支持 WebGPU 的新版浏览器或直接上桌面版走本地 CUDA/Metal。收个尾先跑网页版再谈自托管建议你先按三分钟那节的三步把网页版跑通顺手把模型、角色卡和形象都摸一遍这一步不花钱不装环境。上手之后再挑桌面版或 Docker 路线自托管一份按需打开语音和游戏开关。哪一步卡住了先翻仓库里官方文档的中文手册和 integrations 目录上面这些坑基本都有对应页面。【免费下载链接】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），仅供参考