源码系统概览
文章正文
AIRI 是一套开源的自托管 AI 伴侣和虚拟主播源码。
它能够实时语音聊天、玩 Minecraft 和 Factorio 游戏。
支持 Web、macOS 和 Windows 多平台部署运行。
该项目在 GitHub 上获得 48400 star 和 4800 fork。
系统灵感来自 Neuro-sama，目标是创建可持续运行的赛博生命。
源码简介
AIRI 是一个自托管的 AI 伴侣和虚拟生命平台，支持实时语音对话和自动游戏。
灵感来自 Neuro-sama，目标是创建可持续运行的赛博生命体。
支持 Live2D 和 VRM 模型，具备自动眨眼、注视和情绪表达功能。
支持浏览器端 STT 和多供应商 TTS，包括 ElevenLabs 和 Kokoro。
游戏能力覆盖 Minecraft、Factorio 和 Dome Keeper 等多款游戏。
许可证为 MIT，欢迎社区贡献 star 和 fork。
核心技术栈为 Vue.js、TypeScript 和 WebGPU，项目版本 v0.7.0，最后更新 2026 年。
适用场景
适用于虚拟主播直播和实时互动场景。
支持在 Minecraft 和 Factorio 中 AI 自动游戏。
可用于 Discord 和 Telegram 频道 AI 聊天。
适合需要自托管 AI 伴侣的个性化场景。
也适合用于直播娱乐和互动内容创作的自动化场景。
支持 Discord 和 Telegram 频道集成实现社群 AI 聊天管理。
也适合用于教育领域 AI 助手和语言学习对话伙伴场景。
技术栈与运行环境
核心语言为 TypeScript，使用 pnpm monorepo 管理。
前端使用 Vue.js 和 WebGPU/WebAudio API。
桌面版使用 Electron 框架，支持 NVIDIA CUDA。
支持多种 TTS 供应商包括 ElevenLabs 和 Kokoro。
当前版本 v0.7.0，最后更新 2026 年。
音频处理使用 Web Audio API 和 RNNoise 降噪，STT 支持 Whisper 模型。
功能亮点
- 实时语音聊天：支持浏览器端 STT 和多供应商 TTS
- 游戏能力：可玩 Minecraft、Factorio、Dome Keeper 等游戏
- 多平台支持：Web PWA、桌面 Electron 和移动端 Capacitor
- 多模型支持：VRM 和 Live2D 动画模型，自动眨眼和注视
- 本地推理：支持 WebGPU 浏览器内本地 LLM 推理
系统还支持自定义角色性格和记忆持久化，用户可打造个性化 AI 伴侣。
技术架构与部署指南
安装与部署提示
Web 版使用 pnpm install 和 pnpm dev 启动。
桌面版使用 pnpm dev:tamagotchi 启动 Electron 应用。
Windows 支持 winget 和 Scoop 包管理器安装。
macOS 支持 Homebrew Cask 安装。
更新日志见 DevLog，版本号 v0.7.0。
移动端使用 Capacitor 构建，支持 iOS 和 Android 双平台。
配置文件位于项目根目录 .env，支持多 LLM 供应商并行切换。
截图与演示说明
封面展示了 AIRI 虚拟伴侣项目的社交分享图。
在线 Demo 可访问 airi.moeru.ai 体验 Web 版功能。
支持 VRM 和 Live2D 模型的实时动画展示，含自动眨眼和注视。
桌面版支持 NVIDIA CUDA 和 Apple Metal 硬件加速推理。
语音对话页提供实时字幕和情绪可视化反馈。
游戏集成页展示 AI 在 Minecraft 中的自主操作和对话。
竞品对比
| 特性 | AIRI | NEURO-SAMA | VRoid |
|---|---|---|---|
| 定位 | 自托管AI伴侣 | 直播虚拟主播 | VRM编辑器 |
| 开源 | MIT许可证 | 不开源 | 免费工具 |
| 游戏能力 | Minecraft等 | 无 | 无 |
| 自托管 | 支持 | 不支持 | 不适用 |
| 许可证 | MIT | 闭源 | 免费 |
下表是本系统与主流竞品的核心特性和区别对比。
常见问题
问，AIRI 和 Neuro-sama 有什么区别？
区别在于 AIRI 是开源的自托管方案，而 NEURO-SAMA 不开源且仅在直播时可用。
问，支持哪些 LLM 供应商？
支持 OpenAI、Anthropic Claude、DeepSeek、Ollama、vLLM 等 25 家供应商。
问，是否需要 GPU？
浏览器版使用 WebGPU 加速，桌面版支持 CUDA 和 Metal 加速。
问，可以玩哪些游戏？
目前已支持 Minecraft 和 Factorio，正在开发 Kerbal Space Program 和 Helldivers 2。
安全风险提示
项目涉及本地文件系统访问和网络通信。
Discord 和 Telegram 集成需配置 bot token。
本地 LLM 推理需注意 GPU 资源占用问题。
Web 版使用 WebGPU 需注意浏览器安全策略。
游戏自动化涉及游戏服务器的 RCON 和 Mineflayer 通信。
建议定期备份角色配置和对话历史数据。
下载说明
源码已从 GitHub 下载并打包为 zip 压缩包。
百度网盘和蓝奏云提供双链下载，提取码 8888。
解压后 pnpm install 即可开发运行。
包含完整源码、文档和子项目代码。
GitHub项目开源地址,https://github.com/moeru-ai/airi