SillyTavern 快速上手:免费搭建 AI 角色扮演聊天前端(附安装命令)
2026/9/2 9:42:47 网站建设 项目流程

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 多张场景里挑一张,比如日式街道、海滩白天,聊天背景即时切换。发送消息后,回复会按你配置的后端模型返回。

![SillyTavern 内置的海滩白天聊天背景](https://raw.gitcode.com/GitHub_Trending/si/SillyTavern/raw/51ad27fb86d39a3daca3adaa970375c9670c12df/default/content/backgrounds/landscape beach day.png?utm_source=gitcode_repo_files)

环境准备清单

  • Node.js 20 或更高版本。package.jsonengines字段明确写了"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 start

npm install会按package-lock.json下载 Express、Jimp 等依赖;npm start执行node server.js,服务默认监听 8000 端口。

验证启动是否成功:终端打印出监听地址后,浏览器访问http://localhost:8000default/config.yamlbrowserLaunch.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 种情绪图,可在扩展设置中绑定给角色,让头像随对话情绪切换。

![SillyTavern 内置的中世纪城市夜景聊天背景](https://raw.gitcode.com/GitHub_Trending/si/SillyTavern/raw/51ad27fb86d39a3daca3adaa970375c9670c12df/default/content/backgrounds/cityscape medieval night.jpg?utm_source=gitcode_repo_files)

常见卡点

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

![SillyTavern 内置的酒馆白天聊天背景](https://raw.gitcode.com/GitHub_Trending/si/SillyTavern/raw/51ad27fb86d39a3daca3adaa970375c9670c12df/default/content/backgrounds/tavern day.jpg?utm_source=gitcode_repo_files)

到这里,你已经完成了克隆、装依赖、启动服务三步,并能在浏览器里正常操作聊天界面。下一步建议在设置页接入你的模型后端,然后参考仓库 README 中的文档说明,把角色卡导入流程走一遍。

【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询