Docker 启动后需访问 http://localhost:6001，默认端口不是 80；本地开发需 Node.js 22.13+ 与 pnpm；使用各 API 需自备对应服务商的密钥。
Risuai
kwaroranGPL-3.0活跃维护面向 LLM 角色扮演的易用客户端，可自建角色与剧情，接入 GPT、Claude、Gemini、Llama 等多种模型聊天。
Make your own story. User-friendly software for LLM roleplaying
v2026.10.295发布于 2026-11-09 08:32 UTC1,847star +67 / 7 天363fork同步于 2026-11-10 23:47 UTC
curl -L https://raw.githubusercontent.com/kwaroran/Risuai/refs/heads/main/docker-compose.yml | docker compose -f - up -d 硬件要求按 README 说明
README 未说明显存或 GPU 要求，作为跨平台应用可运行于桌面与浏览器；Docker 方式适合部署在服务器上。
有 Docker 镜像
跨平台 LLM 角色扮演聊天软件，支持多 API 与丰富定制功能
面向 LLM 角色扮演的易用客户端，可自建角色与剧情，接入 GPT、Claude、Gemini、Llama 等多种模型聊天。
核心能力
- 接入 OpenAI、Claude、Gemini、OpenRouter 等多个 API
- 按角色表情显示情绪图片，支持群聊多角色同场
- 用正则脚本改写模型输出，自定义界面与逻辑
- 内置 Lorebook 世界书与 HypaMemory 长期记忆压缩
- 支持插件扩展、TTS 语音与图片音视频素材嵌入
容易踩的坑
内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README
- v2026.10.295最新正式版2026-11-09 · 2026-11-09 08:32 UTC
这个版本没有写更新说明。
- v2026.10.2942026-11-04 · 2026-11-04 02:33 UTC
查看更新说明
- chore: update dependencies and update tests
- fix: update z-index for alert overlay in AlertComp component
- v2026.10.2932026-11-04 · 2026-11-04 01:55 UTC
查看更新说明
- fix: remove unused local Python backend
- fix: stop Tauri streamed fetch on abort and replace the 240s limit with an idle timeout
- fix: remove password check from hex validation in isHex function
- fix: dbwrite permssion
- fix: handle low level access confirmation in readModule function
- v2026.10.2922026-10-30 · 2026-10-30 03:43 UTC
这个版本没有写更新说明。
- v2026.10.2912026-10-30 · 2026-10-30 02:56 UTC
查看更新说明
- fix: restore SafeMutationObserver payloads across the iframe bridge
- feat: magic link for node server
用户点评
登录用户的真实使用记录，可按版本和硬件筛选共 0 条
还没有人点评。第一个说出真实体验的人最有价值。
Risuai
Risuai, or Risu for short, is a cross platform AI chatting software / web application with powerful features such as multiple API support, assets in the chat, regex functions and much more.
Screenshots
| Screenshot 1 | Screenshot 2 |
|---|---|
Features
- Multiple API Supports: Supports OpenAI, Claude, Gemini, DeepInfra, Ooba, OpenRouter... and More!
- Emotion Images: Display the image of the current character, according to his/her expressions!
- Group Chats: Multiple characters in one chat.
- Plugins: Add your features and providers, and simply share.
- Regex Script: Modify model's output by regex, to make a custom GUI and others
- Powerful Translators: Automatically translate the input/output, so you can roleplay without knowing model's language.
- Lorebook: Also known as world infos or memory book, which can make character memorize more.
- Themes: Choose it from 3 themes, Classic, WaifuLike, WaifuCut.
- Powerful Prompting: Change the prompting order easily, Impersonate inside prompts, Use conditions, variables... and more!
- Customizable, Friendly UI: Great Accessibility and mobile friendly
- TTS: Use TTS to make the output text into voice.
- Additional Assets: Embed your images, audios and videos to bot, and make it display at chat or background!
- Long-term Memory: Advanced memory systems including HypaMemoryV2/V3 memory compression, SupaMemory for context management to maintain long-term conversation context.
- And More!
You can get detailed information on https://github.com/kwaroran/Risuai/wiki (Work in Progress)
Community
Installation
- Risuai Website (Recommended)
- Github Releases
Development prerequisites
- Node.js 22.13+
- pnpm
Docker Installation
You can also run Risuai using Docker. This method is particularly useful for web hosting.
-
Run the Docker container:
curl -L https://raw.githubusercontent.com/kwaroran/Risuai/refs/heads/main/docker-compose.yml | docker compose -f - up -d -
Access Risuai at
http://localhost:6001in your web browser.