项目起源#

AIRI 要解决的核心问题是：Neuro-sama 不开源，下播后无法互动。AIRI 让你可以自托管一个同样能力的 AI 虚拟角色，随时随地陪伴你聊天、玩游戏。

项目官网：airi.moeru.ai | GitHub：moeru-ai/airi

桌面版（Tamagotchi）#

网页版（Stage Web）#

源码编译#

方法一：桌面版安装包（推荐新手）#

前往 GitHub Releases 页面 下载对应平台的安装包：

下载后双击安装，按引导完成即可。启动后会自动进入引导配置。

Windows 用户还可通过 Scoop 安装：

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

方法二：网页版（无需安装）#

直接打开 airi.moeru.ai 即可在浏览器中使用。网页版支持 PWA，可添加到主屏幕获得接近原生应用的体验。

方法三：源码编译（面向开发者）#

1
# 克隆仓库
2
git clone https://github.com/moeru-ai/airi.git
3
cd airi
4

5
# 安装依赖
6
pnpm install
7

8
# 获取 Rust 依赖（可选，用于原生模块）
9
cargo fetch
10

11
# 启动网页版开发服务器
12
pnpm dev
13

14
# 或启动桌面版
15
pnpm dev:tamagotchi

方法四：Nix Flake#

1
nix run github:moeru-ai/airi

第一步：选择 LLM 提供商#

AIRI 支持 40+ 家 LLM 提供商。以下是几个推荐方案：

设置路径：打开设置 → LLM 提供商 → 选择服务商 → 输入 API Key → 选择模型。

国内用户提示：AIHubMix、DeepSeek、通义千问、SiliconFlow 等国内服务无需特殊网络环境即可访问。如果使用 Ollama 本地部署，需设置环境变量 OLLAMA_ORIGINS=* 并重启 Ollama。

第二步：配置语音（可选）#

要实现语音对话，需配置 TTS（语音合成）和 STT（语音识别）：

如果暂时不想配置语音，也可以直接使用文字聊天。

第三步：选择角色外观#

AIRI 支持两种角色模型格式：

• Live2D：2D 角色模型，文件格式为 .model3.json
• VRM：3D 角色模型，文件格式为 .vrm

AIRI 自带一套默认角色，你也可以导入自己的模型。在设置中上传模型文件即可生效。

如何获取模型？ 社区分享网站如 VRoid Hub、Booth 上有大量免费和付费模型。也可以从 AIRI 官方 Discord 社区获取推荐资源。

第四步：开始对话#

配置完成后即可开始对话：

1. 在聊天输入框中输入文字，按回车发送
2. 如果配置了语音，点击麦克风按钮开始说话
3. AIRI 会通过 Live2D/VRM 角色做出表情和嘴型同步

默认情况下 AIRI 在”悬停时淡化”模式下运行。如果不习惯，可以在设置中关闭此选项，让角色常驻显示。

实时语音对话#

完成 TTS 和 STT 配置后，AIRI 支持全双工语音对话：

1. 浏览器输入：在网页版中直接通过麦克风采集音频
2. Discord 输入：在 Discord 语音频道中说话，AIRI 会自动听取并回复

语音处理流程：VAD（语音活动检测）→ STT（语音转文字）→ LLM（生成回复）→ TTS（文字转语音）。

多平台聊天#

AIRI 不仅可以在桌面端使用，还支持：

游戏联动#

AIRI 可以自主学习玩游戏，目前支持：

Minecraft：通过 mineflayer 库连接，AIRI 作为机器人进入你的 Minecraft 服务器，可以聊天、移动、交互。

1
# 在 AIRI 设置中配置 Minecraft 服务器地址和账号即可

Factorio：通过 RCON API 连接 Factorio 服务端，AIRI 可以观察并操作游戏。

游戏联动功能需要额外配置，具体请参考官方文档中的相关章节。

AIRI Cloud 账号系统#

v0.10.1 起 AIRI 支持账号系统：

• 使用邮箱注册，支持验证邮箱、重置密码
• 可关联社交账号登录
• 支持服务端 TTS（按角色按流量计费）
• 可在设置中删除账号

插件系统#

AIRI 提供插件 SDK，支持开发自定义功能：

插件可从设置中安装和管理。MCP 工具的配置界面在 v0.10.2 中进行了重构，支持 JSON 编辑、连接测试和开关控制。

记忆系统#

AIRI 内置了基于浏览器的数据库支持，用于存储对话历史：

• DuckDB WASM：浏览器内嵌入式数据库
• pglite：轻量级 PostgreSQL 兼容方案
• Memory Alaya：新一代记忆系统（开发中）

记忆功能让 AIRI 能够记住之前的对话内容，提供更连贯的交互体验。

私服画廊（Self-hosted Gallery）#

AIRI 支持图像生成功能，通过配置图像生成提供商（如 ComfyUI、Replicate 等），可以让 AIRI 在对话中生成图片。

图像生成需要额外配置对应的 API 服务。