引言
Project AIRI 是一个可本地部署的虚拟伴侣系统。它不仅是聊天机器人,还能提供实时语音互动及桌宠常驻桌面功能。其开源属性(MIT 协议)确保数据本地运行,保障隐私安全。

部署安装
Project AIRI 支持多平台(Web/macOS/Windows),以下是实测可用的部署方式:
- Windows 一键安装:在 GitHub Releases 下载对应安装包,安装后任务栏会出现 AIRI 图标。右键可调整位置,设置中绑定 API 后即可对话。
- NAS 部署:支持 Synology 或树莓派,通过 Node.js 环境运行。依赖 DuckDB-WASM 嵌入式数据库,内存占用优化较好,但需注意 WebGPU 加速在 NAS 上可能受限。
- 本地运行:克隆代码库并安装依赖(需 Node.js 18+ 和 pnpm):
git clone https://github.com/moeru-ai/airi
cd airi
pnpm i
pnpm dev:web # 启动浏览器版
首次启动后会提示配置 LLM API(支持 OpenAI、Claude、国产模型如 DeepSeek 等),填入自己的 API Key 即可启用聊天功能。
注意:语音功能需额外配置 TTS/ASR API(如 Azure Speech),自带的免费选项有限;网页版 Demo 部分功能未开放,建议本地部署体验完整能力。
核心功能
- 实时语音 & 多模态交互:通过 WebAudio 和 WebRTC 实现低延迟语音对话,麦克风输入可直接转为文本指令。角色模型(Live2D/VRM)支持自动眨眼、视线跟踪,比如移动鼠标时它会'看'向你。
- 游戏伙伴:
- 《我的世界》:通过
airi-minecraft模块,AI 能理解自然语言指令,例如输入'帮我建个木屋'或'收集 10 个钻石',它会自主规划路径并操作角色; - 《异星工厂》:需加载模组,AI 可协助自动化生产链,例如'优化电力供应'或'扩展铁矿运输带'。
- 《我的世界》:通过
- 记忆与个性化:内置 DuckDB-WASM 数据库存储对话历史,启用 RAG(检索增强生成)后,AI 能记住你的偏好(比如喜欢的游戏或聊天话题)。

技术亮点
- 模块化设计:子项目如
unspeech(语音处理)、xsai(LLM 接口层)可独立使用,方便集成到其他应用; - 社区驱动:鼓励贡献 Live2D 模型或游戏插件,已有用户制作了《星露谷物语》的实验性支持;
- 隐私优先:所有数据留在本地,LLM API 调用可自建代理(如通过 Ollama 本地运行模型)。



