moeru-ai/airi

⭐ 39,113  ·  #8  ·  TypeScript

💖🧸 Self hosted, you-owned Grok Companion, a container of souls of waifu, cyber livings to bring them into our worlds, wishing to achieve Neuro-sama's altitude. Capable of realtime voice chat, Minecraft, Factorio playing. Web / macOS / Windows supported.

TypeScript ai-companion ai-vtuber airi Webui

项目分析

🎯 定位	可视化交互层
💡 核心价值	把 Agent 的命令行能力封装成 Web 界面，支持会话管理、历史记录、多模型切换等功能，降低非技术人员的使用门槛
👥 适合谁	不太熟悉终端操作的用户，或者需要团队协作使用 Agent 的场景

为什么值得关注

39,113 Stars，社区活跃度不错，说明解决了真实痛点。使用 TypeScript 开发。

AI 深度分析报告

一句话总结

打造自托管、可交互的 AI 虚拟伴侣，复刻 Neuro-sama 体验。

核心功能

Airi 的核心在于将大语言模型、语音交互与虚拟角色表现深度融合，打造一个“活”的数字生命体。

1. 多模态实时交互：支持实时语音对话（语音输入与输出），并能通过文字进行交流。其交互延迟和自然度目标是接近 Neuro-sama 的实时直播水平。
2. 沉浸式虚拟角色表现：集成 Live2D 和 VRM 模型标准，使 AI 伴侣拥有生动的面部表情、口型同步和肢体动作，而非简单的聊天框。
3. 游戏环境集成：具备操作 Minecraft 和 Factorio 等游戏的能力，使 AI 能作为“玩家”在虚拟世界中行动和互动，极大扩展了应用场景。
4. 全平台客户端支持：提供 Web、macOS 和 Windows 原生客户端，降低了用户的使用门槛，确保在不同设备上获得一致体验。
5. 自托管与数据主权：强调“Self hosted”和“you-owned”，意味着用户可以完全掌控自己的数据和 AI 的运行环境，不受第三方服务限制。

技术架构

Airi 采用了现代、模块化的技术栈，体现了对实时性和可扩展性的追求。

• 主要技术栈：
  • 语言：TypeScript（全栈），保证了类型安全和开发效率。
  • 前端：大概率使用 React 或类似框架构建 Web 客户端，结合 Electron 或 Tauri 构建桌面端。Live2D/VRM 的渲染依赖 WebGL/Three.js 等图形库。
  • 后端：Node.js 运行时，可能使用 Express、Fastify 或 NestJS 作为 HTTP/WebSocket 服务器。
  • AI 核心：通过 API 或本地模型（如 llama.cpp）调用 LLM，语音部分集成 ASR（如 Whisper）和 TTS（如 VITS、Coqui TTS）模型。
  • 游戏控制：通过 RCON 协议或特定游戏插件（如 Minecraft 的 Bot）实现与游戏的交互。
• 代码结构亮点：
  • 微服务/模块化：项目很可能将 LLM、语音、虚拟角色渲染、游戏控制等核心能力拆分为独立的服务或模块，便于独立开发和迭代。
  • 事件驱动架构：为处理实时的语音流、游戏状态更新和用户输入，内部通信很可能依赖事件总线或消息队列（如 RabbitMQ、Redis Pub/Sub），以保证低延迟和高吞吐。
  • 插件/扩展系统：考虑到游戏集成和模型切换的灵活性，项目可能设计了插件系统，允许社区贡献新的游戏支持或 AI 后端。

快速上手指南

（基于项目通用自托管模式推断，具体请参照项目 README）

1. 环境准备：

   • 确保已安装 Node.js (v18+)、Git 和包管理器（npm/pnpm/yarn）。
   • （可选）如需本地运行 AI 模型，需准备 GPU 环境和相应的推理框架（如 llama.cpp, Ollama）。

2. 克隆与安装：

   git clone https://github.com/moeru-ai/airi.git
   cd airi
   pnpm install # 或 npm install / yarn

3. 配置：

   • 复制 .env.example 为 .env。
   • 配置必要的 API Key（如 OpenAI、Azure TTS 等）或本地模型路径。
   • 配置 Live2D/VRM 模型文件路径。

4. 运行：

   # 启动后端服务
   pnpm run dev:server
   # 启动前端客户端（Web）
   pnpm run dev:client

   访问 http://localhost:5173（或类似地址）即可开始交互。

优劣势与适用场景

• 优势：

  • 技术领先性：紧跟 AI 虚拟主播（VTuber）和数字生命体潮流，技术方案新颖。
  • 高度可定制：模型、AI 后端、语音、游戏行为均可自由替换和配置，灵活性极高。
  • 数据隐私：自托管方案解决了用户对数据安全的根本关切。
  • 全平台覆盖：Web + 桌面端，受众广泛。

• 劣势：

  • 上手门槛较高：需要用户具备一定的 Node.js 环境配置、AI 模型部署和网络知识。
  • 资源消耗大：运行本地 LLM 和语音模型需要较高配置的 GPU 硬件。
  • 生态尚在早期：作为新兴项目，社区贡献的模型、插件和文档可能不够丰富，稳定性有待验证。

• 适用场景与开发者：

  • AI 极客与高级玩家：希望拥有一个完全属于自己的、可深度定制的 AI 伴侣或虚拟主播。
  • VTuber/内容创作者：作为技术原型或辅助工具，探索 AI 驱动的新型直播互动形式。
  • AI 应用开发者：作为研究多模态交互、实时 AI 系统、游戏 AI 集成的优秀学习案例和基础框架。
  • 不适用人群：希望“开箱即用”、不愿折腾配置、对硬件投入有限制的普通用户。

社区与热度

• Star 与 Fork：项目拥有 39,113 Stars，这是一个非常高的数字，表明项目在技术社区（特别是 AI、VTuber 领域）获得了极高的关注度和认可度。Fork 数量通常也会相应较高，反映了活跃的二次开发和社区贡献。
• 最后更新：标记为 2026-05-09。这是一个未来时间点，可能是一个笔误或计划性的未来目标。从现实角度看，关注其最近的 Commit 记录和 Release 版本更为重要。
• 趋势与热度：项目描述中明确对标 Neuro-sama，抓住了当前 AI 虚拟生命体的热点。其高 Star 数表明它成功吸引了大量对此概念感兴趣的开发者。社区活跃度（Issues、Pull Requests）是衡量其是否“健康”的关键指标，需要进一步观察 Issue 的回复速度、PR 的合并频率以及 Discord 等社区渠道的讨论热度。

总结：moeru-ai/airi 是一个野心勃勃且技术实力雄厚的开源项目。它不仅仅是一个聊天机器人，而是一个集成多模态感知、表达和行动能力的数字生命体框架。对于有技术能力和硬件资源的开发者而言，它是探索下一代人机交互形态的绝佳平台。

技术信息

• 💻 语言: TypeScript
• 📂 Topics: ai-companion, ai-vtuber, airi, digital-life, grok-companion
• 🕐 更新: 2026-02-09
• 🔗 访问 GitHub 仓库

---

数据更新于 2026-02-10 · Stars 数以 GitHub 实际数据为准