✧博客
登录注册
返回首页
技术分享

SillyTavern（酒馆）安装及使用教程

2026年5月29日mikulomo
#开源#SillyTavern

项目介绍

什么是 SillyTavern

SillyTavern 是一个本地部署的 AI 交互前端界面，可以对接文本生成 LLM、图像生成引擎和 TTS 语音模型。该项目始于 2023 年 2 月，作为 TavernAI 1.2.8 的分支发展而来，目前拥有 300 多名贡献者，完全免费且开源。硬件需求极低，任何能运行 Node.js 20 的系统均可运行；如果要在本地跑模型，建议配备 3000 系列以上且显存不少于 6GB 的 NVIDIA 显卡。

版本分支

  • release 分支：稳定版，每月更新一次，推荐绝大多数用户使用。
  • staging 分支：开发预览版，包含最新功能但可能存在不稳定因素，仅推荐高级用户使用。

运行模式

  • Standalone 模式（默认）：配置和数据存储在 SillyTavern 安装目录下，适合大多数用户。
  • Global 模式：使用系统级路径存储配置和数据，适用于多实例共享数据的情况。

API 连接支持

SillyTavern 只是一个前端界面，需要后端 API 提供模型推理能力。支持的 API 可分为本地和云端两大类：

  • 本地 API：KoboldCpp、llama.cpp、Ollama、Oobabooga、TabbyAPI 等。
  • 云端 API：AI Horde（免费）、OpenAI、Claude（Anthropic）、NovelAI、OpenRouter 等。

API 分为 Chat Completion（聊天补全）和 Text Completion（文本补全）两种类型。

核心概念

SillyTavern 围绕“角色卡”构建——角色卡是一组用于设定 LLM 行为风格的提示词集合，每个对话必须绑定一个角色卡。用户可以使用内置角色 Seraphina，也可以自己创建角色卡。

扩展机制

SillyTavern 内置了多种扩展（翻译、图像生成、语音合成、聊天摘要等），用户也可以通过粘贴 Git 仓库 URL 的方式安装第三方扩展。

World Info（世界观信息）：可以创建丰富的背景设定库，帮助节省角色卡中的 token 消耗。Group Chats（群聊）：支持多个角色在同一对话中互相聊天及与用户互动。

完整安装教程

一、安装前的准备工作

系统要求

  • 操作系统：Windows 7 以上版本不支持（需要 Node.js 20，而 Windows 7 无法运行），建议使用 Windows 10/11；macOS / Linux 均可正常运行。
  • Node.js：推荐安装最新的 LTS 版本。
  • Git：用于克隆仓库和更新。
  • 硬件：本地不跑模型的话，以上硬件就足够了。

下载安装基础工具

  1. 安装 Node.js：访问 https://nodejs.org 下载并安装最新 LTS 版本。
  2. 安装 Git：
    • Windows：访问 https://gitforwindows.org/ 安装 Git for Windows。
    • macOS：如未安装，可用 Homebrew 安装（brew install git）。
    • Linux：通过包管理器安装（如 Ubuntu 的 sudo apt install git）。

二、Windows 安装指南

方式一：通过 Git 克隆安装（推荐）

⚠️ 特别提醒：绝对不要安装在 Program Files、System32 等 Windows 受控文件夹中，也不要使用管理员权限运行 Start.bat。

  1. 打开“文件资源管理器”（Win+E），选择一个不受 Windows 监视的文件夹（例如 C:\MySpecialFolder）。

  2. 在地址栏中输入 cmd 并回车，打开命令行。

  3. 在命令行中输入以下命令之一并回车克隆代码：

    git clone https://github.com/SillyTavern/SillyTavern -b release

    克隆完成后，在文件夹内找到 Start.bat 文件。

  4. 双击 Start.bat。系统会自动安装 Node.js 依赖，然后 SillyTavern 服务启动，浏览器会自动打开 http://localhost:8000 或类似地址。

方式二：使用 SillyTavern Launcher 安装（更简单）

  1. 按下 Win + R 键打开运行对话框，输入以下命令安装 Git（如已安装可跳过）：

    cmd /c winget install -e --id Git.Git

  2. 按下 Win + E 打开文件资源管理器，导航到要安装启动器的文件夹。

  3. 在地址栏输入 cmd 并回车，执行以下命令：

    git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher && start installer.bat

  4. 按照安装程序指引完成安装即可。

三、Linux / macOS 安装指南

Linux 用户

  1. 通过包管理器安装 Git 和 Node.js。

  2. 打开终端，克隆仓库（二选一）：

    git clone https://github.com/SillyTavern/SillyTavern -b release

    或使用 staging 分支（不推荐普通用户）：

    git clone https://github.com/SillyTavern/SillyTavern -b staging

  3. 进入 SillyTavern 文件夹：

    cd SillyTavern

  4. 启动脚本：

    ./start.sh

    或

    bash start.sh

    浏览器会自动打开 SillyTavern 界面。

macOS 用户

  1. 打开终端，安装 Homebrew 包管理器：

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  2. 安装 Git：

    brew install git

  3. 克隆 SillyTavern 仓库：

    git clone https://github.com/SillyTavern/SillyTavern -b release

  4. 进入目录并启动：

    cd SillyTavern
./start.sh

四、配置 API 连接

SillyTavern 本身不包含 AI 模型，需要接入 API 才能使用聊天功能。以下介绍三种常用方式：

方式一：使用免费的 AI Horde（零成本，无需注册）

AI Horde 是由志愿者提供的免费 AI 服务，开箱即用。

  1. SillyTavern 启动后，在引导界面输入角色名称。

  2. 点击顶栏的 API Connections 按钮。

  3. 输入 AI Horde 的 API Key，可直接使用 0000000000 临时体验，或前往 https://aihorde.net 获取免费 key。

  4. 选择几个 AI 模型（勾选几个即可），关闭 API Connections 窗口。

  5. 在底部输入框中输入消息并发送，稍等片刻即可收到 AI 回复。

方式二：接入 OpenAI

  1. 前往 https://platform.openai.com 注册并登录。

  2. 点击右上角头像 → View API Keys → Create new secret key，生成 API Key 并立即保存下来，注意不要分享给任何人。

  3. 在 SillyTavern 顶栏点击 API Connections → API 下拉菜单选择 Chat Completion (OpenAI) → Chat Completion Source 选择 OpenAI。

  4. 粘贴 API Key，点击 Connect 按钮，确认状态变为 Valid。

  5. 在底部输入框发送消息进行测试。

方式三：本地运行模型（Ollama）

  1. 前往 https://ollama.com 下载安装 Ollama。

  2. 在终端中下载所需模型，例如：

    ollama pull llama3.2:1b

  3. 在 SillyTavern 顶栏点击 API Connections → API 下拉菜单选择 Chat Completion (Ollama)。

  4. 点击 Connect，选择已下载的模型即可开始对话。

五、添加角色卡（Character Card）

角色卡定义了 AI 的行为和风格，每个对话都必须绑定一张角色卡。

使用内置角色

SillyTavern 自带默认角色 Seraphina，安装完成后可直接与之对话。

导入社区角色卡

  1. 点击顶栏的 Character Management（最右侧图标）。
  2. 选择 Import Character，上传角色卡文件（可以是 JSON 或 PNG 图片文件，角色信息隐藏在图片二进制数据中）。

下载扩展角色库

  1. 点击顶栏的 Extensions（叠起来的方块图标）。
  2. 选择 Download Extensions & Assets → Load Asset List，可浏览社区制作的角色卡、预设、背景和声音。

六、常用扩展简介

SillyTavern 自带多种扩展，可在 Extensions 面板中启用或禁用。常用扩展包括：

  • 翻译：将聊天消息翻译成其他语言。
  • 图像生成：接入 Stable Diffusion、FLUX 或 DALL-E API，让 AI 生成图像。
  • 语音输出：通过 ElevenLabs、Silero 或系统 TTS 为聊天消息添加语音。
  • 聊天摘要：自动生成聊天历史摘要。
  • 快捷回复：一键式快捷回复按钮。

安装第三方扩展时，在 Extensions → Install Extension 中粘贴扩展的 Git 仓库 URL 即可。

七、常见问题排障

1. 安装 Node.js 后仍提示未安装

建议重启命令行/终端，或检查系统环境变量 PATH 是否包含 Node.js 路径。

2. Start.bat 一闪而过就关闭

通常是命令行或配置文件缺少依赖。建议在命令行内手动运行 Start.bat，查看具体的报错信息。

3. 浏览器无法访问 SillyTavern（localhost 拒绝连接）

SillyTavern 默认端口为 8000。请确保启动时终端窗口保持运行状态，未手动关闭；同时检查防火墙是否拦截了 Node.js。

如需允许局域网其他设备访问，编辑 config.yaml 将 listen 选项设为 true。

4. 更新 SillyTavern

进入安装目录，执行：

  • Windows：重新双击 Start.bat（会自动拉取更新）
  • Linux/macOS：git pull

八、实用建议

  • 加入社区获取资源：强烈建议加入 SillyTavern 官方 Discord 或中文社区（如“类脑”/“旅程”等），可获取大量角色卡、预设和正则。
  • 不要部署到公网：SillyTavern 本身并非为公网访问设计，建议只在本地网络使用。
  • 从 AI Horde 入门：新手可以直接用免费的 AI Horde 体验，熟练后再考虑 OpenAI 或本地部署。
  • 数据目录：默认模式下，所有角色卡和聊天记录存储在 SillyTavern 安装目录的 data/ 文件夹中。
  • Global 模式：如果希望多实例共享配置，启动时添加 --global 参数即可。
分享

评论

加载中...