简介
AIRI 是一款开源 AI 桌面宠物项目，支持多平台运行、自定义形象、实时语音交互及多模型接入。本文记录其完整部署流程，涵盖环境配置、API 接入、本地 TTS 服务搭建及扩展模块设置。
基础安装与界面设置
项目支持 Windows、macOS 与 Linux 平台，请根据系统架构下载对应版本。
启动后桌面将显示 AI 宠物，支持调整形象与尺寸。建议先完成大模型连接后再进行外观定制。
语言切换：进入 设置 > 外观 > 通用，将语言切换为中文并重启应用。
安全连接：开启 WebSocket 安全连接可启用实时加密通信，同时支持将 Web 版安装为移动端应用。
接入大模型 API
在模型提供商设置中，可根据硬件条件选择本地部署或云端 API。
- 本地部署：若硬件配置充足，推荐使用 Ollama 运行开源模型（如 Qwen 系列）。
- 云端 API：配置不足时可直接调用第三方 API。
本文以阿里百炼 API 为例。在提供商列表中选择 MiniMax（当前版本暂未直接内置百炼/通义千问选项，且 OpenAI Compatible 模式对百炼 API 的兼容性有待验证）。填入对应 API 地址与密钥即可。
配置完成后，可通过内置对话框测试模型响应。
角色设定：在卡片编辑模块中，可自定义 AI 的身份背景、性格描述与行为逻辑。
