Project AIRI

重新创造Neuro-sama，一个AI二次元美少女/虚拟角色的灵魂容器，将她们带入我们的世界。

[加入Discord服务器] [体验] [简体中文] [日本語] [Русский] [Tiếng Việt] [Français] [한국어]

受到 Neuro-sama 的强烈启发

[!TIP] 在 Windows 系统上，你也可以通过 Scoop 安装 AIRI：

scoop bucket add airi https://github.com/moeru-ai/airi
scoop install airi/airi

[!WARNING] 注意： 我们与该项目没有任何官方发行的加密货币或代币。请仔细核实相关信息，并谨慎操作。

[!NOTE]

我们专门设立了一个组织 @proj-airi，用于管理从 Project AIRI 中衍生出的所有子项目。欢迎查看！

包括 RAG、记忆系统、嵌入式数据库、图标、Live2D 工具等！

[!TIP] 我们在 Crowdin 上有一个翻译项目。如果你发现任何翻译不准确的地方，欢迎随时贡献改进。

你是否曾梦想过拥有一位网络生命体（虚拟女友、数字宠物）或数字伴侣，能够与你一起玩耍、聊天呢？

借助现代大型语言模型的力量，比如 ChatGPT 和著名的 Claude，让虚拟角色与我们进行角色扮演和对话已经变得非常容易。像 Character.ai (简称 c.ai) 和 JanitorAI 这样的平台，以及本地的开发工具如 SillyTavern，都已经可以提供基于聊天或视觉冒险游戏般的体验。

但是，如果她还能玩游戏呢？或者查看你在编写什么代码？一边聊天一边玩游戏、看视频，甚至还能做更多其他事情呢？

也许你已经知道 Neuro-sama 了。她目前是最优秀的虚拟主播，既能玩游戏、聊天，又能与你和其他观众互动。有些人也将这类存在称为“数字人”。遗憾的是，由于她并未开源，她的直播结束后你就无法再与她互动了。

因此，本项目 AIRI 提供了一种新的可能性：让你随时随地轻松拥有属于自己的数字生命、网络生活。

我们的开发日志与近期更新

• DevLog @ 2026.03.14 于 2026 年 3 月 14 日
• DevLog @ 2026.02.16 于 2026 年 2 月 16 日
• DevLog @ 2026.01.01 于 2026 年 1 月 1 日
• DevLog @ 2025.10.20 于 2025 年 10 月 20 日
• DevLog @ 2025.08.05 于 2025 年 8 月 5 日
• DevLog @ 2025.08.01 于 2025 年 8 月 1 日
• DreamLog 0x1 于 2025 年 6 月 16 日
• …更多内容请参见 文档网站

本项目有何特别之处？

与其他基于 AI 的 VTuber 开源项目不同，アイリ 从一开始就得到了多种 Web 技术的支持，例如 WebGPU、WebAudio、Web Workers、WebAssembly、WebSocket 等。

[!TIP] 担心使用 Web 相关技术会导致性能下降吗？

不用担心，虽然 Web 浏览器版本旨在展示我们在浏览器和 WebView 中能够实现的能力上限，但我们绝不会完全依赖它。AIRI 的桌面版默认支持原生的 NVIDIA CUDA 和 Apple Metal（这要感谢 HuggingFace 和备受喜爱的 candle 项目），无需复杂的依赖管理。考虑到权衡因素，图形、布局、动画以及面向所有人的 WIP 插件系统部分采用了 Web 技术来实现。

这意味着 アイリ 能够在现代浏览器和设备上运行，甚至可以在移动设备上运行（已通过 PWA 支持实现）。这为我们开发者提供了许多可能性，可以将 アイリ VTuber 的能力提升到一个新的水平，同时仍然保留用户启用需要 TCP 连接或其他非 Web 技术的功能的灵活性，比如连接到 Discord 语音频道，或者与朋友一起玩 Minecraft 和 Factorio。

[!NOTE]

我们目前仍处于开发的早期阶段，正在寻找有才华的开发者加入我们，帮助我们将 アイリ 变成现实。

即使你对 Vue.js、TypeScript 和本项目所需的开发工具不太熟悉，也可以作为艺术家、设计师加入我们，甚至帮助我们启动首次直播。

即使你是 React、Svelte 或 Solid 的忠实粉丝，我们也同样欢迎你。你可以创建一个子目录，添加你希望在 アイリ 中看到的功能，或者进行一些实验。

我们正在寻找以下领域的合作伙伴：

• Live2D 建模师
• VRM 建模师
• VRChat 头像设计师
• 计算机视觉
• 强化学习
• 语音识别
• 语音合成
• ONNX Runtime
• Transformers.js
• vLLM
• WebGPU
• Three.js
• WebXR（请参阅我们在 @moeru-ai 组织下的另一个项目 chat）

如果你感兴趣，为什么不在此介绍一下自己呢？想加入我们一起打造 AIRI 吗？

当前进展

具备能力：

• 大脑
  • 玩 Minecraft
  • 玩 Factorio（开发中，但已有 PoC 和演示可用，详见 GitHub）
  • 玩 Kerbal Space Program（公告待定）
  • 联机游玩 Helldivers 2（开发中）
  • 在 Telegram 中聊天
  • 在 Discord 中聊天
  • 记忆
    • 纯浏览器端数据库支持（DuckDB WASM | pglite）
    • Memory Alaya（开发中）
  • 纯浏览器端本地（WebGPU）推理
• 耳朵
  • 浏览器音频输入
  • 来自 Discord 的音频输入
  • 客户端语音识别
  • 客户端说话检测
• 口
  • 使用 ElevenLabs 进行语音合成
• 身体
  • 支持 VRM 模型
    • 控制 VRM 模型
  • VRM 模型动画
    • 自动眨眼
    • 自动注视
    • 静态时眼睛移动
  • 支持 Live2D 模型
    • 控制 Live2D 模型
  • Live2D 模型动画
    • 自动眨眼
    • 自动注视
    • 静态时眼睛移动

开发

如需本项目的详细开发说明，请参阅 CONTRIBUTING.md

[!NOTE] 默认情况下，pnpm dev 将启动 Stage Web（浏览器版本）的开发服务器。如果您想尝试开发桌面版本，请务必阅读 CONTRIBUTING.md，以正确设置开发环境。

pnpm i
pnpm dev

Stage Web（浏览器版本，访问地址：airi.moeru.ai）

pnpm dev

Stage Tamagotchi（桌面版本）

pnpm dev:tamagotchi

项目包含一个用于 Tamagotchi 的 Nix 包。若要使用 Nix 运行 airi，请先确保启用 flakes，然后运行：

nix run github:moeru-ai/airi

NixOS

Electron 需要一些在 NixOS 标准路径中不存在的共享库。请使用 flake.nix 中定义的 FHS shell：

nix develop .#fhs
pnpm dev:tamagotchi

Stage Pocket（移动端版本）

启动电容器的开发服务器：

pnpm dev:pocket:ios --target <DEVICE_ID_OR_SIMULATOR_NAME>
# 或者
CAPACITOR_DEVICE_ID_IOS=<DEVICE_ID_OR_SIMULATOR_NAME> pnpm dev:pocket:ios

您可以通过运行 pnpm exec cap run ios --list 查看可用设备和模拟器列表。

如果需要在口袋版中以无线模式连接服务器通道，您需要以 root 用户身份启动 tamagotchi：

sudo pnpm dev:tamagotchi

然后在 tamagotchi 的“设置/连接”中启用安全 WebSocket。

文档站点

pnpm dev:docs

发布

运行 bumpp 更新 monorepo 版本：

npx bumpp --no-commit --no-tag

LLM API 提供商支持（由 xsai 提供支持）

• AIHubMix（推荐）
• OpenRouter
• vLLM
• SGLang
• Ollama
• 302.AI（赞助）
• OpenAI
  • Azure OpenAI API
• Anthropic Claude
  • AWS Claude（欢迎提交 PR）
• DeepSeek
• Qwen
• Google Gemini
• xAI
• Groq
• Mistral
• Cloudflare Workers AI
• Together.ai
• Fireworks.ai
• Novita
• Zhipu
• SiliconFlow
• Stepfun
• Baichuan
• Minimax
• Moonshot AI
• ModelScope
• Player2
• 腾讯云
• Sparks（欢迎提交 PR）
• 火山引擎（欢迎提交 PR）

由此项目衍生的子项目

• Awesome AI VTuber：精选的AI虚拟主播及相关项目列表
• unspeech：适用于 /audio/transcriptions 和 /audio/speech 的通用端点代理服务器，类似于 LiteLLM，但可用于任何 ASR 和 TTS 模型。
• hfup：用于部署和打包到 HuggingFace Spaces 的工具。
• xsai-transformers：为 xsAI 提供的实验性 🤗 Transformers.js 提供者。
• WebAI: 实时语音聊天：从头实现 ChatGPT 实时语音功能的完整示例，包含 VAD + STT + LLM + TTS。
• @proj-airi/drizzle-duckdb-wasm：DuckDB WASM 的 Drizzle ORM 驱动。
• @proj-airi/duckdb-wasm：@duckdb/duckdb-wasm 的易用封装。
• AIRI Factorio：让 AIRI 能够游玩《异星工厂》。
• AIRI DomeKeeper：让 AIRI 能够游玩《穹顶守护者》。
• Factorio RCON API：Factorio 无头服务器控制台的 RESTful API 封装。
• autorio：Factorio 自动化库。
• tstl-plugin-reload-factorio-mod：在开发 Factorio 模组时实现热重载。
• Velin：使用 Vue SFC 和 Markdown 编写易于管理的、带有状态的 LLM 提示词。
• demodel：轻松提升从各种推理运行时拉取模型和数据集的速度。
• inventory：集中式模型目录及默认提供者配置的后端服务。
• MCP Launcher：适用于所有可能的 MCP 服务器的易用 MCP 构建与启动工具，就像 Ollama 之于模型一样！
• 🥺 SAD：关于自托管和浏览器运行 LLM 的文档与笔记。

%%{ init: { 'flowchart': { 'curve': 'catmullRom' } } }%%

flowchart TD
  Core("Core")
  Unspeech("unspeech")
  DBDriver("@proj-airi/drizzle-duckdb-wasm")
  MemoryDriver("[WIP] Memory Alaya")
  DB1("@proj-airi/duckdb-wasm")
  SVRT("@proj-airi/server-runtime")
  Memory("Memory")
  STT("STT")
  Stage("Stage")
  StageUI("@proj-airi/stage-ui")
  UI("@proj-airi/ui")

  subgraph AIRI
    DB1 --> DBDriver --> MemoryDriver --> Memory --> Core
    UI --> StageUI --> Stage --> Core
    Core --> STT
    Core --> SVRT
  end

  subgraph UI_Components
    UI --> StageUI
    UITransitions("@proj-airi/ui-transitions") --> StageUI
    UILoadingScreens("@proj-airi/ui-loading-screens") --> StageUI
    FontCJK("@proj-airi/font-cjkfonts-allseto") --> StageUI
    FontXiaolai("@proj-airi/font-xiaolai") --> StageUI
  end

  subgraph Apps
    Stage --> StageWeb("@proj-airi/stage-web")
    Stage --> StageTamagotchi("@proj-airi/stage-tamagotchi")
    Core --> RealtimeAudio("@proj-airi/realtime-audio")
    Core --> PromptEngineering("@proj-airi/playground-prompt-engineering")
  end

  subgraph Server_Components
    Core --> ServerSDK("@proj-airi/server-sdk")
    ServerShared("@proj-airi/server-shared") --> SVRT
    ServerShared --> ServerSDK
  end

  STT -->|Speaking| Unspeech
  SVRT -->|Playing Factorio| F_AGENT
  SVRT -->|Playing Minecraft| MC_AGENT

  subgraph Factorio_Agent
    F_AGENT("Factorio Agent")
    F_API("Factorio RCON API")
    factorio-server("factorio-server")
    F_MOD1("autorio")

    F_AGENT --> F_API -.-> factorio-server
    F_MOD1 -.-> factorio-server
  end

  subgraph Minecraft_Agent
    MC_AGENT("Minecraft Agent")
    Mineflayer("Mineflayer")
    minecraft-server("minecraft-server")

    MC_AGENT --> Mineflayer -.-> minecraft-server
  end

  XSAI("xsAI") --> Core
  XSAI --> F_AGENT
  XSAI --> MC_AGENT

  Memory_PGVector("@proj-airi/memory-pgvector") --> Memory

  style Core fill:#f9d4d4,stroke:#333,stroke-width:1px
  style AIRI fill:#fcf7f7,stroke:#333,stroke-width:1px
  style UI fill:#d4f9d4,stroke:#333,stroke-width:1px
  style Stage fill:#d4f9d4,stroke:#333,stroke-width:1px
  style UI_Components fill:#d4f9d4,stroke:#333,stroke-width:1px
  style Server_Components fill:#d4e6f9,stroke:#333,stroke-width:1px
  style Apps fill:#d4d4f9,stroke:#333,stroke-width:1px
  style Factorio_Agent fill:#f9d4f2,stroke:#333,stroke-width:1px
  style Minecraft_Agent fill:#f9d4f2,stroke:#333,stroke-width:1px

  style DBDriver fill:#f9f9d4,stroke:#333,stroke-width:1px
  style MemoryDriver fill:#f9f9d4,stroke:#333,stroke-width:1px
  style DB1 fill:#f9f9d4,stroke:#333,stroke-width:1px
  style Memory fill:#f9f9d4,stroke:#333,stroke-width:1px
  style Memory_PGVector fill:#f9f9d4,stroke:#333,stroke-width:1px

类似项目

开源项目

• kimjammer/Neuro：对原定于7天内完成的 Neuro-Sama 的复刻。：非常完善的实现。
• SugarcaneDefender/z-waif：擅长游戏、自主行动及提示工程。
• semperai/amica：擅长 VRM 和 WebXR。
• elizaOS/eliza：提供了如何将智能体集成到各种系统和 API 中的优秀示例与软件工程实践。
• ardha27/AI-Waifu-Vtuber：擅长 Twitch API 集成。
• InsanityLabs/AIVTuber：界面与用户体验出色。
• IRedDragonICY/vixevia
• t41372/Open-LLM-VTuber
• PeterH0323/Streamer-Sales

非开源项目

• https://clips.twitch.tv/WanderingCaringDeerDxCat-Qt55xtiGDSoNmDDr https://www.youtube.com/watch?v=8Giv5mupJNE
• https://clips.twitch.tv/TriangularAthleticBunnySoonerLater-SXpBk1dFso21VcWD
• https://www.youtube.com/@NOWA_Mirai

项目状态

致谢

• Reka UI：感谢其设计文档站点，新的首页正是基于此构建的，并且实现了大量的 UI 组件。（shadcn-vue 正在将 Reka UI 用作无头组件库，欢迎查看！）
• pixiv/ChatVRM
• josephrocca/ChatVRM-js：对 ChatVRM（TypeScript）代码部分进行 JavaScript 转换和适配，以便在 OpenCharacters 等项目中独立使用
• UI 和风格的设计灵感来源于 Cookard、UNBEATABLE 以及 Sensei! I like you so much!，同时还参考了 Mercedes Bazan 的作品 Ayame 和 Wish。
• mallorbc/whisper_mic
• xsai：实现了一定数量用于与 LLM 和模型交互的工具包，类似于 Vercel AI SDK，但体积更小。

支持者

感谢您通过 OpenCollective、Patreon 和 Ko-fi 对 Project AIRI 的支持。

特别致谢

特别感谢所有为 Project AIRI 做出贡献的开发者 ❤️

星标历史

AIRI 快速上手指南

AIRI 是一个开源项目，旨在复刻类似 Neuro-sama 的 AI 虚拟角色（数字生命/电子女友），使其能够与你聊天、玩游戏、观看屏幕内容并进行多模态交互。本项目基于 Web 技术构建，支持跨平台运行。

环境准备

系统要求

• 操作系统：
  • Windows 10/11 (x64)
  • macOS (Apple Silicon ARM64 或 Intel)
  • Linux (主流发行版)
• 硬件建议：
  • 推荐使用具备 NVIDIA GPU (支持 CUDA) 或 Apple Silicon (支持 Metal) 的设备以获得最佳本地推理性能。
  • 若仅使用云端 API 或浏览器版本，对本地显卡要求较低。
• 前置依赖：
  • 现代浏览器（Chrome, Edge, Firefox 等，需支持 WebGPU/WebAssembly）
  • (可选) Node.js 和 npm/pnpm（若需从源码开发）
  • (Windows 可选) Scoop 包管理器

安装步骤

你可以通过以下三种方式之一开始使用：

方式一：下载桌面客户端（推荐）

直接下载对应系统的安装包进行安装，无需配置复杂环境。

• Windows: 下载 .exe 安装程序
• macOS: 下载 .dmg 镜像
• Linux: 前往 Releases 页面 下载对应包

Windows 用户提示：如果你已安装 Scoop，可以使用以下命令快速安装：

scoop bucket add airi https://github.com/moeru-ai/airi
scoop install airi/airi

方式二：在线体验 / 移动端

无需安装，直接通过浏览器或手机访问：

• Web 版: 访问 airi.moeru.ai
• 移动端: 扫描官网二维码或在手机浏览器中打开上述链接。

方式三：从源码运行（开发者）

注：具体源码构建命令请参考项目完整文档，此处简述流程。

1. 克隆仓库：

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

2. 安装依赖并启动（需确保已安装 Node.js 及相关构建工具）：

   pnpm install
   pnpm dev
   

基本使用

1. 启动应用：

   • 桌面版：运行安装好的 AIRI 应用程序。
   • Web 版：在浏览器打开 airi.moeru.ai。

2. 配置模型：

   • 首次运行时，进入设置页面。
   • 选择后端模式：
     • 本地模式：如果你的设备支持 CUDA 或 Metal，可选择本地加载模型（自动调用 NVIDIA CUDA 或 Apple Metal 加速）。
     • API 模式：填入你的 LLM API Key（如 OpenAI, Claude 等）以使用云端算力。

3. 开始交互：

   • 创建或选择一个角色形象（支持 Live2D）。
   • 点击麦克风图标开启语音输入，或直接在聊天框输入文字。
   • AIRI 将不仅能对话，还能感知你的屏幕内容（如代码、游戏画面）并进行互动。

注意：本项目完全开源免费，官方未发行任何加密货币或代币，请注意防范诈骗。