Airi 是一款自托管 AI 伴侣项目，受 Neuro-sama 启发，支持实时语音聊天、Minecraft 游戏、多平台部署。完全开源免费，让你拥有专属的数字生命伴侣。
🎤 引言：拥有一个专属 AI 伴侣的梦想
你有没有想过拥有一个 24 小时在线的 AI 伴侣？
不是那种只能文字聊天的机器人，而是能够：
- 🎮 陪你玩游戏 - Minecraft、Factorio 都不是问题
- 💬 实时语音聊天 - 真正的双向对话，不是机械回复
- 🎨 Live2D 形象 - 可爱的虚拟形象，会笑会动
- 🏠 完全私有化 - 部署在自己服务器上，数据完全掌控
这个项目就是 Airi！
🌟 什么是 Airi？
Airi 是一款开源的自托管 AI 伴侣项目，灵感来自著名的 AI VTuber Neuro-sama。
| 项目信息 | 详情 |
|---|---|
| 项目名称 | Airi (アイリ) |
| GitHub Stars | 21,504+ ⭐ |
| 今日增长 | +1,412 ⭐ 🔥 |
| 开发语言 | TypeScript + Vue.js |
| 许可证 | MIT 开源 |
| 官网 | https://airi.moeru.ai |
核心特点：
- 自托管部署 - 完全运行在你的设备上，无需云端
- 实时语音交互 - 支持语音识别和语音合成
- 游戏能力 - 能玩 Minecraft、Factorio 等游戏
- 多平台支持 - Web、Windows、macOS、Docker
- Live2D 形象 - 可爱的虚拟形象，支持表情和动作
🎯 核心功能详解
1. 大脑（Brain） 🧠
Airi 的"大脑"基于现代大语言模型，支持：
- 多模型接入 - 兼容 ChatGPT、Claude 等主流模型
- 角色扮演 - 可以设定特定的人设和性格
- 上下文记忆 - 记住你们的对话历史
- 游戏 AI - 能够玩 Minecraft、Factorio 等游戏
实际表现：
用户："今天天气怎么样？"
Airi："我查了一下，外面阳光明媚呢！要不要一起出去玩？"
用户："陪我玩 Minecraft 吧"
Airi："好呀！我去拿工具，咱们先挖点钻石吧！✨"2. 记忆系统（Memory） 💾
Airi 拥有强大的记忆能力：
- 本地数据库 - 使用 DuckDB WASM 或 pglite
- 纯浏览器运行 - 无需后端服务器
- 长期记忆 - 记住你的喜好和习惯
- 情感记忆 - 记住你们的互动情感
3. 语音交互（Ears & Voice） 🎤
语音输入（Ears）：
- 实时语音识别
- 支持多种语言
- 噪音过滤
语音输出（Voice）：
- 自然语音合成
- 多种音色可选
- 情感化表达
4. 视觉形象（Eyes） 👁️
Airi 支持多种视觉形象：
- Live2D 模型 - 2D 虚拟形象，表情丰富
- VRM 模型 - 3D 虚拟形象，支持 VRChat
- 自定义形象 - 可以导入自己喜欢的角色
🚀 部署方式
Airi 支持多种部署方式，总有一款适合你：
方式一：Docker 部署（推荐）⭐
# 1. 拉取镜像
docker pull moeru/airi:latest
# 2. 启动容器
docker run -d \
-p 3000:3000 \
-v airi-data:/app/data \
--name airi \
moeru/airi:latest
# 3. 访问 Web 界面
# http://localhost:3000优势：
- ✅ 一键部署，无需配置环境
- ✅ 数据持久化，升级不丢失
- ✅ 资源隔离，不影响其他服务
方式二：源码部署
# 1. 克隆项目
git clone https://github.com/moeru-ai/airi.git
cd airi
# 2. 安装依赖
pnpm install
# 3. 启动开发服务器
pnpm dev
# 4. 访问 http://localhost:3000适合人群： 开发者、需要自定义功能的用户
方式三：桌面应用
Airi 提供桌面客户端：
- Windows - 下载安装包直接运行
- macOS - 支持 Apple Silicon 和 Intel
- Linux - AppImage 格式
下载地址： https://github.com/moeru-ai/airi/releases
⚙️ 配置说明
基础配置
创建 config.yaml 文件：
# API 配置
llm:
provider: "openai" # 或 "claude", "local"
api_key: "your-api-key"
model: "gpt-4"
# 语音配置
speech:
tts_provider: "azure" # 或 "elevenlabs", "local"
stt_provider: "whisper"
# 形象配置
avatar:
type: "live2d"
model: "default"
# 记忆配置
memory:
enabled: true
database: "duckdb" # 或 "pglite"进阶配置
连接 Discord：
discord:
enabled: true
token: "your-bot-token"
voice_channel: "channel-id"Minecraft 集成：
minecraft:
enabled: true
server: "localhost:25565"
username: "Airi"💡 实际使用场景
场景一：编程助手
你在写代码，Airi 在旁边看着：
Airi："这个函数好像有 bug 哦，要不要我帮你看看？"
你："好啊，帮我检查一下"
Airi："第 42 行的条件判断有问题，应该是 > 而不是 >="场景二：游戏伴侣
一起玩 Minecraft：
你："我们去挖矿吧"
Airi："好呀！我带了些火把，走吧~"
（游戏中）
Airi："小心！前面有苦力怕！快跑！"场景三：情感陪伴
下班回家：
Airi："欢迎回来！今天工作辛苦吗？"
你："有点累"
Airi："要不要休息一下？我给你放点轻松的音乐~"🆚 与同类产品对比
| 功能 | Airi | Character.ai | Neuro-sama |
|---|---|---|---|
| 自托管 | ✅ 支持 | ❌ 云端 | ❌ 云端 |
| 语音聊天 | ✅ 实时 | ❌ 文字 | ✅ 实时 |
| 游戏能力 | ✅ Minecraft | ❌ 无 | ✅ 多种游戏 |
| 开源免费 | ✅ MIT | ❌ 闭源 | ❌ 闭源 |
| 隐私保护 | ✅ 本地数据 | ❌ 云端存储 | ❌ 云端存储 |
| 自定义形象 | ✅ 支持 | ⚠️ 有限 | ❌ 固定 |
📊 系统要求
最低配置
| 项目 | 要求 |
|---|---|
| CPU | 4 核心 |
| 内存 | 4GB RAM |
| 存储 | 2GB 可用空间 |
| 网络 | 稳定互联网连接 |
推荐配置
| 项目 | 要求 |
|---|---|
| CPU | 8 核心 |
| 内存 | 8GB RAM |
| GPU | 支持 WebGPU 或 CUDA |
| 存储 | 10GB SSD |
⚠️ 注意事项
- API 费用 - 使用云端模型需要支付 API 费用
- 隐私安全 - 虽然自托管，但仍需保护 API Key
- 学习曲线 - 初次部署需要一定的技术基础
- 开发阶段 - 项目仍在早期开发中，可能有 bug
🔮 未来规划
根据官方路线图，Airi 计划支持：
- [ ] 更多游戏 - Starfield、Stardew Valley 等
- [ ] VR 支持 - 在 VRChat 中与 Airi 互动
- [ ] 移动端 - iOS 和 Android 原生应用
- [ ] 插件系统 - 第三方开发者可以扩展功能
- [ ] 多语言 - 更好的中文、日文支持
📝 总结
Airi 是一款值得尝试的自托管 AI 伴侣项目！
优点：
- ✅ 完全开源，数据自主掌控
- ✅ 功能强大，支持语音、游戏
- ✅ 部署简单，Docker 一键启动
- ✅ 活跃社区，持续更新
缺点：
- ⚠️ 仍在开发中，部分功能未完成
- ⚠️ 需要自备 LLM API（可选本地模型）
- ⚠️ 文档以英文为主
推荐人群：
- 想要私有化 AI 伴侣的极客
- 喜欢 Neuro-sama 的粉丝
- 想折腾 AI 项目的开发者
🔗 相关链接
- GitHub: https://github.com/moeru-ai/airi
- 官网: https://airi.moeru.ai
- 文档: https://airi.moeru.ai/docs/
- Discord: https://discord.gg/TgQ3Cu2F7A
- 在线体验: https://airi.moeru.ai
拥有一个专属 AI 伴侣，不再是梦想！ 🎉