Risuai

本地运行，自由创作，让 AI 角色扮演更沉浸

Risuai 是一款基于 Tauri 和 TypeScript 构建的桌面应用，专为 LLM 角色扮演场景设计。它解决了现有 AI 聊天工具在角色扮演体验上的不足，提供用户友好的界面和强大的自定义功能。核心能力包括：支持接入 GPT、Claude、Gemini、Llama、Mistral 等多种主流大模型，内置丰富的角色预设和故事编辑工具，让用户轻松创建和管理自己的角色与剧情。同时，它集成了 MCP 客户端，可扩展外部工具和知识库，增强互动性。跨平台桌面特性带来流畅的本地体验，适合深度角色扮演和互动小说创作。

开源 unknown 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1691

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类对话助手

开发团队kwaroran

所属国家

官网地址https://risuai.net

GitHubhttps://github.com/kwaroran/Risuai

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议GPL-3.0

主要语言TypeScript

技术栈/模型ai,characters,chat,chatbot,claude,gemini,gpt,llama,llm,mcp,mcp-client,mistral,roleplay,tauri

GitHub 星标★ 1691

30天Star增速

HF 下载量

上线时间2023-04-12 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：Docker 5 步

环境要求

Docker 与 Docker Compose（使用 Docker 方式时需要）
可访问 raw.githubusercontent.com 的网络（Docker 方式会拉取 docker-compose.yml）
现代浏览器（通过 Web 访问 Risuai）
桌面版需从 GitHub Releases 下载对应系统的安装包

安装与启动步骤

1选择使用方式

README 给出三种安装途径：官网 risuai.net（推荐）、GitHub Releases 下载桌面版、Docker 自建，按需选一种即可。
2官网直接使用

不想本地安装可直接打开官网使用，无需 Docker 或下载安装包，适合快速体验。
3下载桌面版

访问 GitHub Releases 页面，按自己的操作系统下载对应安装包并安装，获得跨平台桌面体验。
4Docker 一键启动

用 README 提供的一行命令拉取 docker-compose.yml 并后台启动容器，适合 Web 托管场景。
```
curl -L https://raw.githubusercontent.com/kwaroran/Risuai/refs/heads/main/docker-compose.yml | docker compose -f - up -d
```
5访问 Web 界面

容器启动后，在浏览器打开 http://localhost:6001 即可进入 Risuai 界面。

如何确认成功

浏览器访问 http://localhost:6001，能正常显示 Risuai 界面即表示启动成功。

常见问题

Q：Docker 启动后打不开 http://localhost:6001 怎么办？

A：先确认容器是否在运行（docker compose ps），再检查 6001 端口是否被其他程序占用；端口以 README 给出的 6001 为准。

Q：不熟悉命令行怎么用 Risuai？

A：README 推荐直接使用官网 https://risuai.net，或从 GitHub Releases 下载桌面版安装包，这两种方式都不需要 Docker。

Q：Docker 方式适合什么场景？

A：README 说明该方式尤其适合 Web 托管，方便把 Risuai 部署到服务器上供浏览器访问。

Q：Risuai 支持哪些模型接口？

A：README 列出的支持包括 OpenAI、Claude、Gemini、DeepInfra、Ooba、OpenRouter 等，具体在应用内按界面提示配置即可。

注意事项

README 明确推荐优先使用官网方式，Docker 只是可选方案。
Docker 方式默认访问地址为 http://localhost:6001，请勿自行改动。
docker-compose.yml 从 GitHub main 分支实时拉取，使用时需保证网络可访问 raw.githubusercontent.com。

核心亮点

支持多模型接入，灵活切换 GPT/Claude/本地模型
内置 MCP 客户端，可扩展工具和知识库，玩法更丰富
基于 Tauri 构建，启动快、内存占用低，桌面体验流畅

不足之处

文档/社区待观察
角色扮演场景对模型上下文长度要求高，长剧情易截断

适用场景

沉浸式互动小说创作
个性化 AI 伴侣聊天
游戏 NPC 对话设计

替代项目

SillyTavern、TavernAI、KoboldAI

项目介绍

Risuai 是对话助手领域的开源项目，由 kwaroran 开发，2023 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（1,691）位列前 30%，在对话助手分类的 905 个项目里位列前 15%。

近 45 天，它的 GitHub 星标从 1,589 增加到 1,691，净增 102。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：沉浸式互动小说创作。同类可对比的替代方案包括 SillyTavern、TavernAI、KoboldAI。

上一篇：tmi.js

下一篇：xiaozhi-android-client