Powered by

# Extras 安装

本页面包含在本地设备上安装 SillyTavern Extras 的说明。

在您的操作系统上本地安装 Extras 可能很困难或不可能（尤其是 Termux）。

# 使用 官方 Extras Colab

  • 设置简单
  • 免费使用
  • 不需要 Colab GPU 积分（使用 use_cpu 选项）
  • 详情请参见 Colab 指南页面。

# 在 Colab 中运行 Extras

  • 打开 官方 Extras Colab
  • 选择所需的 "Extra" 选项
  • 选择 use_cpu 来运行 Extras 而不需要 GPU 积分
    • 这会使 Stable Diffusion 变慢，但其他一切都会正常运行
  • 非必需，但建议：选择 secure 选项来生成 API 密钥以保护您的共享实例。
  • 点击左侧的启动按钮（看起来像三角形 '播放' 按钮）
  • 等待它完成所有内容的加载
  • 在输出底部查找 trycloudflare.com 链接。忽略 localhost 链接，它不会起作用（我们试过了！）。
  • 它将以文本 Running on 开头
  • 复制该行下列出的 API URL 链接。（不要复制 'localhost' URL，使用另一个）
  • 启动支持扩展的 SillyTavern：（如果需要，在 config.yaml 中将 enableExtensions 设置为 true）
  • 导航到 SillyTavern 的扩展菜单（点击页面顶部的 '堆叠块' 图标）。
  • 将 API URL 粘贴到顶部的框中。（不是 API 密钥框）
  • 如果您没有启用 secure 选项，请确保在使用官方 colab 时 API 密钥框完全为空。
  • 如果您启用了 secure 选项，请将生成的 API 密钥粘贴到 API 密钥框中。
  • API 密钥将出现在 colab 的控制台输出中，例如：Your API key is fee2f3f559
  • 点击 "Connect"

# 本地安装方法

# MiniConda（推荐）

推荐此方法，因为 Conda 为 Extras 需求包创建了一个'虚拟环境'，因此它们不会影响您系统范围的 Python 设置。

  1. 安装 Miniconda

    （重要！）阅读 如何使用 Conda

  2. 安装 git

    （一开始就用 git 安装 SillyTavern 的大佬可以跳过此步骤！）

    安装完两者后...

    在 CONDA 命令提示符窗口 中逐一输入/粘贴以下命令，每条命令后按 Enter。

  3. 创建一个新的 Conda 环境（我们称之为 extras）：

    conda create -n extras

  4. 激活新环境

    conda activate extras（您应该在命令提示符左侧看到 (extras) 弹出）

  5. 安装所需的系统包（这将需要一些时间）

    conda install python=3.11 git

  6. 克隆 Extras GitHub 仓库

    git clone https://github.com/SillyTavern/SillyTavern-extras

  7. 导航到您克隆的 Extras 仓库

    cd SillyTavern-extras

  8. 使用以下其中一个命令安装 Extras 的需求（再次需要时间）：

    • pip install -r requirements.txt - 用于基本功能
    • pip install -r requirements-rvc.txt - 用于实时语音克隆
    • pip install -r requirements-coqui.txt - 用于 Coqui TTS（不推荐）

    如果在此步骤遇到错误，请参见 常见问题 页面！

  9. 请参见下面的'安装后运行 Extras'

# 系统范围安装

这更容易，但会影响您系统范围的 Python 安装。

如果您使用许多具有不同需求的 Python 程序，这可能会导致冲突。

如果这是您第一次接触任何 Python 相关的东西，那应该不成问题。

  1. 安装 Python 3.11：https://www.python.org/downloads/release/python-3115/
  2. 安装 git：https://git-scm.com/downloads
  3. 打开命令提示符窗口并转到您拥有完全访问权限的文件夹。
  4. 克隆仓库：git clone https://github.com/SillyTavern/SillyTavern-extras，按 Enter。
  5. 克隆完成后，输入 cd SillyTavern-extras，按 Enter。
  6. 输入 python -m pip install -r requirements.txt
  7. 请参见下面的'安装后运行 Extras'

# 安装后运行 Extras

# 确认扩展已启用

  1. 在文本编辑器中打开名为 config.yaml 的文件。该文件位于 ST 的基本安装文件夹中。
  2. 查找读取 enableExtensions 的行。
  3. 确保该行有 true，而不是 false。

# 决定使用哪个模块

（这只需要做一次）

  • Extras 总是通过 Python 命令行启动。
  • python server.py 是最低要求，但它不启用任何有用的模块。
  • 要启用模块，您必须使用 --enable-modules= 修饰符，以及逗号分隔的模块名称列表

示例：python server.py --enable-modules=caption,summarize,classify

这将启用图像描述、聊天摘要和实时更新的角色表情。

下面是描述每个模块的表格。

名称 描述
caption 图像描述
summarize 文本摘要
classify 文本情感分类
sd Stable Diffusion 图像生成
silero-tts Silero TTS 服务器
edge-tts Microsoft Edge TTS 客户端
chromadb 向量存储服务器
coqui-tts Coqui TTS
rvc 实时语音克隆
  • 决定您想添加到 Python 命令行中的模块。
  • 它们将在下一步中使用。

注意：您的 Python 命令的模块列表中必须完全没有空格！

# 启动 Extras 服务器

仍在 Extras 安装文件夹内的命令提示符窗口中...

  1. 确保您的 conda 环境处于活动状态（如果您使用了 Conda 安装方法）
  2. 如果环境未激活，请输入 activate extras。
  3. 输入 python server.py --enable-modules=您的,选择的,模块,列表,在这里
  4. extras 服务器将加载。
  5. 一段时间后，它将在末尾显示一个 URL。对于本地安装，默认为 http://localhost:5100。
  6. 复制 API URL。

# 将 ST 连接到 Extras 服务器

  1. 启动您的 SillyTavern 服务器，并在浏览器中查看 SillyTavern 界面。
  2. 打开扩展面板（通过页面顶部的'堆叠块'图标）
  3. 将 API URL 粘贴到输入框中。
  4. 点击 Connect。

要再次运行 Extras，只需激活环境并在命令提示符中运行这些命令。

conda activate extras，按 Enter。 python server.py，按 Enter。

确保包含您的设置所需的 server.py 的附加选项（见下文）。

# 创建 .bat 文件以便轻松启动

这是可选的，仅适用于 Windows，但在 MacOS 上应该可以做类似的事情。

  1. 查看您的 Windows 桌面
  2. 右键单击，选择 新建，然后点击 文本文档
  3. 一个新文件将出现在您的桌面上，要求输入名称。
  4. 将文件命名为 STExtras.txt
  5. 在文本编辑器中打开新创建的文件。

  6. 将以下代码粘贴到其中：

    cd C:\_您的_\完整_\Extras_\文件夹_\路径_\
call conda activate extras
python server.py --enable-modules=您的,选择的,模块,列表,在这里,没有,空格
call conda deactivate
pause
  7. 用您的实际 Extras 安装文件夹路径替换占位符文件夹路径。
  8. 用您的实际命令行替换 python 命令行
  9. 使用新名称 STExtras.bat 保存文件（在大多数文本编辑器中使用 文件 >> 另存为）

您现在只需双击此 .bat 文件即可轻松启动 Extras。

如果您想更改模块列表（或 extras 服务器的任何其他命令行修饰符），只需编辑 .bat 文件内的 python 命令。

# Extras 安装常见问题

本节列出了安装 SillyTavern Extras 时遇到的常见问题和问题。

# 错误：无法在 Linux 上导入 'talkinghead' 模块

它需要安装一个额外的包，因为它不会自动安装，因为与 Colab 不兼容。安装其他要求后运行此命令：

pip install wxpython

# Extras 服务器无法连接到 AUTOMATIC1111 的 Stable Diffusion Web UI

无法连接到 http://127.0.0.1:7860 的远程 SD 后端！正在禁用 SD 模块...

确保您启动 Stable Diffusion 的 webui-user.bat 在 COMMANDLINE_ARGS 变量中包含 --api 命令行选项。

在您的 "webui-user.bat" 中查找并替换该行：set COMMANDLINE_ARGS=--api

它应该看起来像这样
它应该看起来像这样

如果 SD Web UI 的 API 模式被禁用，Extras 服务器将无法建立连接，您将无法生成图像！

# 仍然不起作用？

确保您以正确的顺序启动所有内容，等待每个程序完成加载后再进行下一步：

  1. Stable Diffusion Web UI
  2. SillyTavern Extras
  3. SillyTavern

如果 extras 服务器在之后加载，它将无法重新连接到 Stable Diffusion API。

# 安装 ChromaDB 时的 hnswlib wheel 构建错误

错误：无法为 hnswlib 构建 wheels，这是安装基于 pyproject.toml 的项目所必需的

在安装 ChromaDB 模块之前，您必须首先执行以下操作之一：

# 在 Mac 上安装 Python 需求时出错

错误：找不到 torch==2.0.0+cu117 的匹配发行版

Mac 不支持 CUDA，因此应该安装不带 CUDA 支持的 torch 包。

改用 requirements-silicon.txt 文件安装需求。

# 缺少模块？

  • 您必须在 Python 命令行中指定模块名称列表，使用 --enable-modules 修饰符。
  • 请参见 模块 部分。

# API 密钥框是做什么的？

  • SillyTavern 扩展面板中的 API 密钥框仅在您有以下情况时使用：
    • 在您的 Extras 安装文件夹中创建了一个名为 api_key.txt 的文本文件，其中包含您选择的 Extras '密码'。
    • 使用 --secure 命令行参数启动 extras。
  • 这使 Extras API '密码锁定'，因此只有在其 API 密钥框中拥有该密钥的用户才能访问它。
  • 这主要对想要制作自己的 Extras 公共部署（colab 等）的人有用。
  • 在自己的 PC 上为个人使用运行 Extras 的用户不应在 API 密钥框中输入任何内容。

# 移动设备/Android/Termux 怎么样？🤔

  • 社区中有些人通过 Termux 上的 Ubuntu 在手机上成功运行 Extras。
  • 但是，Extras 并不是为移动设备支持而制作的。
  • 不会为在 Android 设备上运行 Extras 的人提供支持。
  • 请将您所有的问题直接转给下面链接的指南创建者。

# ❗ 这是不受支持的

https://rentry.org/STAI-Termux#downloading-and-running-tai-extras

© Copyright 2025. All rights reserved.