开源 AI 桌宠 AIRI 部署指南

简介

AIRI 是一款开源 AI 桌面宠物项目，支持多平台运行、自定义形象、实时语音交互及多模型接入。本文记录其完整部署流程，涵盖环境配置、API 接入、本地 TTS 服务搭建及扩展模块设置。

基础安装与界面设置

项目支持 Windows、macOS 与 Linux 平台，请根据系统架构下载对应版本。

启动后桌面将显示 AI 宠物，支持调整形象与尺寸。建议先完成大模型连接后再进行外观定制。

语言切换：进入 设置 > 外观 > 通用，将语言切换为中文并重启应用。 安全连接：开启 WebSocket 安全连接可启用实时加密通信，同时支持将 Web 版安装为移动端应用。

接入大模型 API

在模型提供商设置中，可根据硬件条件选择本地部署或云端 API。

• 本地部署：若硬件配置充足，推荐使用 Ollama 运行开源模型（如 Qwen 系列）。
• 云端 API：配置不足时可直接调用第三方 API。

本文以阿里百炼 API 为例。在提供商列表中选择 MiniMax（当前版本暂未直接内置百炼/通义千问选项，且 OpenAI Compatible 模式对百炼 API 的兼容性有待验证）。填入对应 API 地址与密钥即可。

配置完成后，可通过内置对话框测试模型响应。

角色设定：在卡片编辑模块中，可自定义 AI 的身份背景、性格描述与行为逻辑。

配置本地 TTS 语音服务

若需免费且低延迟的语音合成，可部署本地 TTS 服务。本文使用开源工具 openai-edge-tts（基于 Kokoro-82M 等模型的 OpenAI TTS 兼容仿真器）。

1. 克隆并安装依赖，启动服务：

   # 安装依赖并运行
   python /app/server.py
   

   终端显示 Server running on http://localhost:5050 即表示服务启动成功。

2. 返回 AIRI 设置，进入语音配置页。

   • 服务端地址：填入 http://localhost:5050/v1（注意：无需追加 /audio/speech 路径）。
   • API 密钥：可任意填写（本地服务默认已关闭密钥验证）。

配置完成后即可在对话中听到 AI 语音反馈。免费方案音质有限，若对音质有较高要求，建议切换至 MiniMax 或阿里百炼的官方 TTS 模型。

扩展模块配置

在 机体模块 设置中，支持接入 Discord、X（Twitter）、Minecraft 及 Factorio 等平台。以 Discord 为例，仅需填入 Bot Token 即可完成对接，配置流程较为简便。其他平台可按需自行探索。

总结与资源

AIRI 项目目前处于快速迭代期，社区活跃度高，功能持续完善。以下为项目官方仓库与相关工具链接：

• AIRI 发布页：https://github.com/moeru-ai/airi/releases/tag/v0.9.0-alpha.1
• openai-edge-tts：https://github.com/travisvn/openai-edge-tts