SillyTavern零基础部署:3步搭好你的本地AI角色扮演引擎
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
SillyTavern 是一个专为重度用户打造的本地 LLM 对话前端(LLM Frontend for Power Users)——它本身不生产任何内容,而是把你已经拥有的各家 AI 服务(OpenAI、Claude、Google、Ollama 等十多家)接到一个统一的对话界面上,让你在这里配置人设、铺设世界观、切换模型,专注和 AI 角色打交道。如果你想在一台普通电脑上跑起SillyTavern 部署全流程,跟着这篇文章走一遍,大约十几分钟就能完成。
先搞清楚它是干什么的
把 SillyTavern 想象成餐厅的"点餐台":厨房(各家大模型 API)你不用自己建,但菜单怎么摆、菜品怎么描述、上菜顺序怎么排,都由点餐台决定。它干的正是这件事:
- 统一入口:在 src/endpoints/ 目录下能看到 openai.js、anthropic.js、google.js、novelai.js 等模块,对应着界面里可切换的多种 AI 后端;
- 角色卡片:每个角色是一张"卡"(V2 格式),人设、开场白、示例对话都存在里面,随时可导入导出;
- 世界书:在 public/scripts/world-info.js 背后是一套关键词触发机制,聊天中提到关键词时,相关设定会自动注入上下文——这是它和"套壳聊天框"最大的区别;
- 本地化:所有角色、聊天记录都存在本机
data/目录里,不依赖任何在线账号。
SillyTavern 可设置的酒馆风格对话场景背景
快速上手:本地部署三连
1. 准备环境
只需要 Node.js 18 或更高版本。验证命令:
node -v # 输出 v18+ 即可,否则先升级 Node2. 拉取代码并安装
git clone https://gitcode.com/GitHub_Trending/si/SillyTavern cd SillyTavern npm install # 安装依赖,耗时取决于网速3. 启动
npm start首次启动会自动生成配置文件(模板在 default/config.yaml),并在data/目录下建好你自己的数据区。启动日志会提示服务地址,默认端口是8000,浏览器打开即可看到登录页。
端口被占用时,编辑
default/config.yaml中的port: 8000改为空闲端口再启动即可。
整个流程用图表示就是:
第一次对话:从选 AI 到建角色
启动后按这个顺序走一遍,你就摸熟了它 80% 的基础操作:
- 连接 AI 服务:进入 AI 设置页(Power User 面板),填入你要用的后端,比如 OpenAI 兼容的 API 地址与密钥。预设格式可参考 default/content/presets/openai/ 目录下的 JSON 样例;
- 创建角色:在角色管理页点"新建",填名字、人设描述和开场白——这些就是角色卡片的内容;
- 开始聊天:选中角色,输入第一句话。之后可以在聊天栏顶部随时更换背后的模型,人设和聊天记录都不变,这就是"一次配置,多模型切换"。
SillyTavern 中可自定义的角色对话背景:海滩白昼场景
让它"更像你设定的世界":进阶三板斧
基础聊通之后,三个进阶功能值得依次解锁:
| 功能 | 它解决什么 | 在哪里 |
|---|---|---|
| 世界书(World Info) | 剧情里反复出现的地名、名词 AI 记不住 | 世界书管理页,按关键词触发 |
| 表情系统(Expressions) | 角色只有头像没有情绪变化 | public/img/default-expressions/ 内置 28 张默认表情,可整套替换 |
| 背景与头像动画 | 对话界面单调 | 背景图支持多张随机切换 |
世界书的工作方式值得多说一句:它不是"把设定全塞进提示词",而是关键词命中才注入。比如你写了一本"星环历法"世界书,只有对话里出现"星环""历法"这类词,对应条目才会进入上下文——既省 token 又不串味。
三种部署方式怎么选
本地跑通之后,如果想在别的机器上继续用,按下面的对比挑一种:
| 方式 | 适合谁 | 一句话说明 |
|---|---|---|
| 源码部署(上面演示的) | 想改配置、看源码 | 最灵活,升级就是git pull+ 重启 |
| Docker | 已有服务器的 | 仓库内 docker/docker-compose.yml 与 Dockerfile 就是为此准备的,数据卷映射到data/ |
| Colab 笔记本 | 没本地环境想白嫖算力 | 仓库 colab/GPU.ipynb 提供了一个现成的 notebook |
无论哪种方式,记住数据都在data/目录下:换机器时把这个目录拷走,角色、聊天记录、世界书就都跟过去了。
小结
到这里,你已经完成了 SillyTavern 从零到能用的全部链路:装环境、起服务、接模型、建角色、铺世界书。剩下的玩法——多角色群聊、快捷回复、主题定制——都藏在 Power User 设置里等你自己逛。
你打算用 SillyTavern 打造的第一个角色是什么?评论区聊聊你的设定吧。
(本文依据仓库当前版本的实际目录结构与 package.json 脚本编写,具体界面以最新版为准。)
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考