AIRI 部署指南：5 分钟快速搭出会实时语音对话的 AI 伴侣

AIRI 部署指南5 分钟快速搭出会实时语音对话的 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 同玩、VRM/Live2D 角色展示覆盖 Web、macOS 与 Windows 三端。本指南带你完成安装、服务商配置与第一次对话从零跑通 AIRI 部署。这份指南适合谁如果你想拥有一个能陪你聊天、说话、打游戏的虚拟角色这个项目就是为此设计的。典型场景把它放在桌面上陪你看代码、随时语音对话让她登上 Minecraft 和你一起探索或者部署到自己的服务器通过 Telegram、Discord 机器人随时找她说话。哪怕你从没部署过项目跟着下面步骤走即可。三条 AIRI 部署路径按需选择最快体验官方在线 Demo。浏览器打开 AIRI 的网页演示填入你的 API 密钥就能聊。零安装适合先试功能再决定要不要自托管。完整本地桌面版。下载官方发布页的 Windows / macOS 安装包安装Windows 可用 wingetmacOS 可用 Homebrew。支持本地 GPU 加速与本地模型适合长期日常使用。自托管源码或 Docker 构建。克隆仓库后按下一节操作适合想完全掌控数据和部署位置、或需要部署到服务器的人。三步克隆并启动 AIRI以下命令启动本地网页版需先安装 Node.js 与 pnpm。git clone https://gitcode.com/GitHub_Trending/ai/airi cd airi克隆仓库并进入目录。pnpm install安装依赖postinstall 阶段会顺带构建内部包首次耗时略长。pnpm dev启动网页版开发服务器按终端提示的地址在浏览器打开即可。 Docker 两步构建 AIRI 网页版如果偏好容器化部署仓库内置了现成的 apps/stage-web/Dockerfile镜像基于 nginx可直接用于自托管。docker build -t airi-web -f apps/stage-web/Dockerfile .构建镜像内部会编译网页版与文档站。docker run -d -p 3000:80 --name airi airi-web启动容器并映射到 3000 端口浏览器打开 http://localhost:3000 看到界面即成功。五分钟完成首次对话API 密钥与模型配置首次打开界面点击「开始吧」进入模型配置页按四步走选择服务商支持 OpenAI、DeepSeek、Anthropic、Ollama 等 30 余家选 OpenAI 兼容 API 时还需填 Base URL。填入 API 密钥点击Ping API验证连通性。验证通过后选择模型列表无法加载时按服务商官方文档手动输入模型 ID。在设置 → 意识中确认同时选中服务商与模型发送「你好」收到回复即配置成功。内置角色卡「ReLU」可以立刻开聊想换人设见下文深度定制部分。 三个差异化功能逐个开启实时语音对话。AIRI 的语音链路是语音识别STT 大模型 语音合成TTS。开启方式在设置 → 机体模块 → 听觉/发声中各添加一个支持中文的提供商内置 Kokoro TTS 不支持中文再在聊天框选中麦克风。实际效果你对着麦克风说话她实时语音回应。Minecraft 同玩。这是 AIRI 最有代表性的能力让 AI 登上 Minecraft 陪你探索、建造并根据你的玩法给出实时建议。相关模块在 integrations/minecraft/配置服务器地址即可。VRM/Live2D 角色驱动。角色支持自动眨眼、视线跟随与空闲眼球运动在设置 → 模型中切换 3DVRM与 2DLive2D也可以导入自己的模型文件。深度定制角色卡、模型参数与插件扩展分组入口可配置内容人设角色卡首页右上角切换名称、性格、行为每张卡可单独绑定各模块的模型提供商切卡即切人设模型设置 → 意识选聊天模型思考模型回复慢日常对话建议选非思考模型语音设置 → 听觉/发声选择 TTS/STT 提供商与麦克风扩展integrations/ 目录Discord、Telegram、Satori 等机器人接入AI 核心逻辑实现在 packages/core-agent/想读源码从这里入手。排坑手册四个常见坑验证通过但没有模型列表→ 部分服务商不提供模型列表或密钥无权限 → 在「意识」页手动输入与官方文档完全一致的模型 ID。发消息没有回复→ 只保存了服务商凭据、没选模型 → 检查「意识」页服务商与模型是否都已选中。pnpm install 报错或版本不匹配→ 项目锁定了 pnpm 版本见 package.json 的 packageManager 字段 → 先执行corepack enable让项目自动匹配对应 pnpm。Docker 构建慢或 3000 端口占用→ 镜像编译了网页版、文档站等多个子项目首次构建本来就慢 → 耐心等待或带缓存重建启动前确认端口未被占用。常见问题AIRI 需要什么硬件网页版在现代浏览器即可运行桌面版建议 8GB 内存以上以获得流畅体验。可以离线使用吗对话依赖大模型接入 Ollama、LM Studio 等本地服务可走本地推理模型文件需自行准备。软件收费吗代码免费开源MIT 协议云端模型按服务商计费本地服务免费。下一步跑通第一次对话后建议精读网页版上手指南配置语音再翻服务商配置指南了解全部 30 余家服务商细节遇到卡点欢迎到官方社区提问交流。【免费下载链接】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），仅供参考