traubi/sillytavern

SillyTavern Docker镜像

镜像概述

本镜像基于开源项目SillyTavern（由Cohee1207和RossAscends开发，项目地址：https://github.com/SillyTavern/SillyTavern）构建，提供一个轻量级、可快速部署的AI角色互动Web应用环境。SillyTavern是一款专注于AI角色聊天与角色扮演的应用，支持通过Web界面与自定义或预设AI角色进行自然语言交互。

核心功能和特性

• Web界面交互：提供直观的浏览器界面，支持角色创建、管理和实时对话
• 多AI后端兼容：支持集成多种AI模型服务（如OpenAI、Claude、本地部署模型等）
• 角色定制：允许自定义角色的性格、背景故事、对话风格等参数
• 聊天记录管理：自动保存对话历史，支持查看、导出和继续对话
• 轻量级部署：通过Docker容器化，简化依赖管理和环境配置

使用场景和适用范围

• 个人用户进行AI角色聊天、沉浸式角色扮演体验
• 开发者快速测试AI对话应用功能和界面交互
• 教育场景中用于AI辅助教学或互动式学习
• 娱乐领域构建个性化AI聊天机器人

使用方法和配置说明

基本部署（docker run）

bash
docker run -d -p 8080:8080 --name sillytavern [镜像名称]

说明：

• -p 8080:8080：将容器的8080端口映射到主机，通过 http://localhost:8080 访问应用
• --name sillytavern：指定容器名称为sillytavern
• [镜像名称]：替换为实际的Docker镜像名称

持久化数据存储

为避免容器重启导致角色数据和聊天记录丢失，建议挂载数据卷：

bash
docker run -d -p 8080:8080 \
  -v ./sillytavern-data:/app/data \
  --name sillytavern [镜像名称]

说明：

• ./sillytavern-data：主机上的本地目录，用于持久化存储应用数据
• /app/data：容器内的数据存储路径

环境变量配置

可通过环境变量调整应用参数（具体支持的变量以镜像实际配置为准）：

bash
docker run -d -p 8080:8080 \
  -e AI_BACKEND="openai" \
  -e API_KEY="your-api-key" \
  -e PORT=8080 \
  --name sillytavern [镜像名称]

常用环境变量：

• AI_BACKEND：默认AI后端服务（如"openai"、"claude"、"local"等）
• API_KEY：AI服务的API密钥（如OpenAI API Key）
• PORT：容器内部服务端口（默认8080）

注意事项

• 首次启动后，需通过Web界面完成AI后端配置（输入API密钥、选择模型等）
• 确保主机端口未被占用，如需修改端口可调整 -p 参数（如 -p 8888:8080 映射到主机8888端口）
• 持久化数据卷建议定期备份，防止数据丢失
• 部分AI后端可能需要***环境或本地模型部署支持