SillyTavern 快速上手:免费搭建 AI 角色扮演聊天前端(附安装命令)
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
SillyTavern 是一个面向进阶用户的 LLM 聊天前端,本身不生成内容,而是把你本地的 Node.js 服务与 OpenAI、Claude、KoboldAI 等模型后端连起来,提供角色卡、世界书、预设等管理界面。适合已经有一个模型 API 或本地推理服务、但缺一个统一操作台的人。跑起来后,你会在浏览器里得到一个可建角色、选背景、发对话的完整聊天工作台。
启动后你会看到什么
服务启动成功后,浏览器自动打开http://localhost:8000。页面左侧是角色列表,中间是聊天区,下方是输入框。
选一个角色后,点击角色头像旁的背景按钮,就能从内置的 20 多张场景里挑一张,比如日式街道、海滩白天,聊天背景即时切换。发送消息后,回复会按你配置的后端模型返回。

环境准备清单
- Node.js 20 或更高版本。
package.json里engines字段明确写了"node": ">= 20",低于 20 的旧版可能装依赖时报错 - 能访问终端(Windows 可用 PowerShell 或 CMD,Linux/macOS 用 Terminal)
- 一个可用的模型后端。项目只负责前端与服务端转发,API Key 需要在启动后的设置页里自己填
- 无需额外数据库,用户数据默认存在
./data目录(见default/config.yaml)
安装与启动
第一条命令克隆仓库:
git clone https://gitcode.com/GitHub_Trending/si/SillyTavern.git它会创建一个SillyTavern目录,包含全部源码和默认内容。
第二条命令进入目录、装依赖并启动(三句连在一起算一条启动流程):
cd SillyTavern && npm install && npm startnpm install会按package-lock.json下载 Express、Jimp 等依赖;npm start执行node server.js,服务默认监听 8000 端口。
验证启动是否成功:终端打印出监听地址后,浏览器访问http://localhost:8000。default/config.yaml中browserLaunch.enabled默认为true,启动成功时浏览器会自动弹出登录/角色选择页面,看到该页面即代表跑通了。
三个最影响初次体验的功能
角色卡导入与管理。项目自带角色卡解析器src/character-card-parser.js和校验器src/validator/TavernCardValidator.js,支持.json和.charx格式。你把角色卡文件拖进页面即可导入,头像、简介、开场白自动解析。
预设与世界书配置。default/content/presets/下按后端分了目录,context/、sysprompt/等子目录里是几十份现成的提示词模板(Llama、Gemma、Mistral 等)。切换不同模型时直接套用对应模板,不用手写。
背景与表情资源。内置背景图在default/content/backgrounds/,角色表情包示例在default/content/Seraphina/,含 28 种情绪图,可在扩展设置中绑定给角色,让头像随对话情绪切换。

常见卡点
- Node 版本过低:
npm install报EBADENGINE或依赖编译失败。原因是指定要求 Node >= 20,换 Node.js 最新 LTS 后重装即可。 - 依赖安装失败:多为网络中断导致 node_modules 不完整。清掉
node_modules和 npm 缓存后重新执行npm install。 - 端口被占用:8000 已被其他程序占用时服务起不来。改
default/config.yaml里的port值再重启,或释放原端口。 - 浏览器没自动打开:手动访问
http://localhost:8000即可;如需局域网访问,把config.yaml的listen改为true并重启。

到这里,你已经完成了克隆、装依赖、启动服务三步,并能在浏览器里正常操作聊天界面。下一步建议在设置页接入你的模型后端,然后参考仓库 README 中的文档说明,把角色卡导入流程走一遍。
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考