Risuai：多模型 AI 角色扮演聊天软件

项目简介

Risuai（简称 Risu）是一款跨平台的 AI 聊天软件兼 Web 应用，面向喜欢用大语言模型进行角色扮演、剧情创作的用户。它把多模型接入、角色设定、表情立绘、长期记忆等功能集中在一个界面里，既可以直接在官网使用，也可以自建部署。

主要功能

• 多 API 支持：可接入 OpenAI、Claude、Gemini、DeepInfra、Ooba、OpenRouter 等多种服务。
• 表情图片：根据角色当前的情绪显示对应立绘。
• 群组聊天：在一个会话中同时让多个角色参与。
• 插件系统：自行扩展功能与模型提供方，并可分享给他人。
• 正则脚本：用正则改写模型输出，实现自定义界面等效果。
• 翻译器：自动翻译输入与输出，跨语言角色扮演更轻松。
• Lorebook（世界书/记忆书）：让角色记住更多背景设定。
• 主题：内置 Classic、WaifuLike、WaifuCut 三套主题。
• 提示词编排：可调整提示顺序、在提示中扮演角色、使用条件与变量。
• 界面与无障碍：可定制、移动端友好。
• TTS：把输出文本转成语音。
• 附加素材：为角色嵌入图片、音频、视频，可显示在聊天中或作为背景。
• 长期记忆：HypaMemoryV2/V3 记忆压缩与 SupaMemory 上下文管理，维持长对话连贯性。

安装与使用

推荐直接访问官网使用：

• Risuai Website
• 桌面版见 GitHub Releases

也可以用 Docker 自建部署，适合放在服务器上：

curl -L https://raw.githubusercontent.com/kwaroran/Risuai/refs/heads/main/docker-compose.yml | docker compose -f - up -d

启动后浏览器访问 http://localhost:6001 即可。

本地开发需要 Node.js 22.13+ 与 pnpm。更详细的说明见项目 Wiki。

注意事项

• 项目以 GPL-3.0 许可证开源。
• 使用各家模型 API 时需自备对应的密钥与额度。
• 遇到问题可加入官方 Discord 社区 交流。

本作品整理自 GitHub 开源项目 kwaroran/Risuai，原作者 @kwaroran，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。