AIRI：自托管的AI虚拟伴侣，支持实时语音和游戏互动

AIRI 是一个开源的自托管 AI 虚拟伴侣项目，旨在为用户提供可定制的数字角色体验。它以大型语言模型（LLM）为核心，支持实时语音聊天、游戏互动（如 Minecraft 和 Factorio）以及虚拟角色（VRM/Live2D）动画。用户可以在浏览器或桌面端运行 AIRI，无需复杂依赖即可使用 Web 技术或本地 GPU 加速。项目灵感来源于 Neuro-sama，目标是打造一个能与用户共同玩游戏、聊天并执行多种任务的虚拟伴侣。AIRI 强调用户自主性，支持本地化部署，确保隐私和灵活性。项目由 Moeru AI 社区维护，持续更新，欢迎开发者参与贡献。

功能列表

• 实时语音交互：支持浏览器或 Discord 的语音输入和输出，使用 ElevenLabs 语音合成技术。
• 游戏互动：能在 Minecraft 中执行自然语言指令，完成挖掘、建造等任务；在 Factorio 中辅助玩家（开发中）。
• 虚拟角色支持：集成 VRM 和 Live2D 模型，具备自动眨眼、视线跟踪等动画效果。
• 本地推理：利用 WebGPU 或本地 NVIDIA CUDA/Apple Metal 进行模型推理，无需云端依赖。
• 内存系统：支持本地数据库（如 DuckDB WASM），记录用户交互历史。
• 跨平台支持：可在 Web 浏览器、Windows 和 macOS 上运行。
• 开发者友好：提供插件系统，支持用户扩展功能。

使用帮助

安装流程

要使用 AIRI，用户需要克隆 GitHub 仓库并进行简单配置。以下是详细的安装步骤：

1. 克隆仓库：
   打开终端，输入以下命令克隆 AIRI 仓库：

   git clone https://github.com/moeru-ai/airi.git
   cd airi
   

2. 安装依赖：
   AIRI 使用 pnpm 作为包管理器。确保已安装 Node.js 22+，然后运行：

   pnpm install
   

3. 配置环境变量：
   复制示例配置文件并填写必要信息：

   cp packages/agent/.env.example packages/agent/.env.local
   

   编辑 packages/agent/.env.local，添加以下内容：

   OPENAI_API_KEY=your_openai_api_key
   OPENAI_API_BASEURL=your_openai_api_baseurl
   

   如果使用 Factorio 模块，还需配置：

   cp packages/factorio-wrapper/.env.example packages/factorio-wrapper/.env.local
   

   编辑 packages/factorio-wrapper/.env.local，设置 WebSocket 和 RCON 地址，例如：

   WS_SERVER_HOST=localhost
   FACTORIO_WS_HOST=localhost
   RCON_API_SERVER_HOST=localhost
   

4. 链接 Factorio 模块（可选）：
   如果使用 Factorio 功能，需创建符号链接：

   ln -s /path/to/airi-factorio/packages/autorio/dist /path/to/factorio/data/autorio
   

5. 运行 AIRI：
   根据平台选择运行方式：
   • 浏览器：启动 Web 版本，访问 http://localhost:5173（具体端口以实际配置为准）。
   • 桌面端：运行桌面版本，支持 NVIDIA CUDA 或 Apple Metal 加速，执行：

     pnpm run start
     

功能操作流程

1. 实时语音交互

AIRI 支持通过浏览器或 Discord 进行语音输入和输出。用户需配置 ElevenLabs 语音合成 API：

• 在 .env.local 中添加 ElevenLabs 的 API 密钥。
• 启动 AIRI 后，打开浏览器界面或 Discord 客户端，点击语音输入按钮。
• 说出指令（如“帮我建造一个房子”），AIRI 会通过语音回应并执行任务。
• 语音交互支持自动检测用户说话状态，适合实时沟通场景。

2. Minecraft 游戏互动

AIRI 集成了 Minecraft 机器人功能，可通过自然语言指令控制：

• 确保 Minecraft 服务器（1.20+）运行，并配置 .env.local 中的服务器信息：

  BOT_USERNAME=your_bot_username
  BOT_HOSTNAME=localhost
  BOT_PORT=25565
  BOT_VERSION=1.20
  

• 启动 AIRI，连接到服务器。
• 在界面输入指令，如“挖掘 10 块石头”或“跟随我”，AIRI 会自动执行。
• 特色功能包括路径规划、物品管理、战斗支持等。例如，输入“建造一个 3×3 的木屋”，AIRI 会自动收集木材并完成建造。

3. 虚拟角色动画

AIRI 支持 VRM 和 Live2D 模型，增强互动体验：

• 在设置页面上传 VRM 或 Live2D 模型文件。
• 模型会自动执行 Juno，包含自动眨眼、视线跟踪等动画效果。
• 用户可通过界面调整模型动作，如“看向鼠标”或“随机移动眼睛”。

4. 本地推理与隐私

AIRI 支持 WebGPU 推理，无需云端服务器：

• 确保设备支持 WebGPU（现代浏览器如 Chrome/Edge）。
• 在设置中选择本地模型（如 LLaMA），即可在浏览器运行推理。
• 桌面端支持 NVIDIA CUDA 或 Apple Metal，性能更优。

5. 扩展功能

开发者可通过插件系统添加功能：

• 访问 services 目录，参考文档创建自定义技能。
• 示例：添加新的游戏互动模块，需实现技能逻辑并注册到 AIRI。

注意事项

• 确保网络稳定，语音和游戏功能需低延迟连接。
• 本地推理需要高性能设备，建议至少 16GB 内存。
• 定期检查 GitHub 仓库更新，获取最新功能和修复。

应用场景

1. 游戏伴侣
   AIRI 能在 Minecraft 和 Factorio 中与玩家互动，执行指令或提供协助，适合希望有智能伙伴的玩家。
2. 虚拟助手
   通过语音和文字与 AIRI 交流，完成日常任务，如查询信息、记录笔记，适合个人娱乐或工作场景。
3. 开发者测试
   开发者可利用 AIRI 的插件系统测试 AI 模型或开发新功能，适合 AI 研究和应用开发。
4. 虚拟角色爱好者
   用户可自定义 VRM/Live2D 角色，创建个性化数字伴侣，适合虚拟角色爱好者。

QA

1. AIRI 需要高性能设备吗？
   浏览器版本可在普通设备运行，但本地推理需要支持 WebGPU 的浏览器或 GPU 设备（如 NVIDIA/Apple 设备）。
2. 如何确保数据隐私？
   AIRI 支持本地部署和推理，数据无需上传云端，保障隐私。
3. 是否支持多语言？
   是的，AIRI 的语言模型支持多种语言，语音合成也支持多语言输出。
4. 如何参与开发？
   访问 GitHub 仓库，提交 Pull Request 或加入 Moeru AI 社区的 Telegram/Discord 讨论。