面向开发者的 AI 角色扮演（RP）后端引擎。Headless 架构，SillyTavern 资产兼容，TypeScript 全栈。
TavernHeadless 把 AI 角色扮演的核心——会话、楼层、消息、变量、记忆、提示词编排、工具调用——做成了一套 RESTful 后端。它不绑定任何界面，前端可以自由替换。
已有的 SillyTavern 资产（预设、世界书、正则、角色卡）可以直接导入使用。
完整文档在 hersophia.github.io/TavernHeadless。
@tavern/sdk + @tavern/client-helpers，TypeScript 类型化接入。git clone https://github.com/HerSophia/TavernHeadless.git
cd TavernHeadless
pnpm install
cp .env.example .env
pnpm dev
启动后访问：
| 地址 | 说明 |
|---|---|
http://localhost:3000/docs/ |
Swagger UI |
http://localhost:3000/openapi.json |
OpenAPI 规范 |
http://localhost:3000/health |
健康检查 |
更多命令、认证配置、环境变量说明见文档站 快速开始。
在线文档站：hersophia.github.io/TavernHeadless
| 文档 | 说明 |
|---|---|
| 简介 & 快速开始 | 了解项目、跑起来 |
| 架构设计 | 系统架构、核心概念、数据模型 |
| API 参考 | 所有 REST 接口 |
| SDK 文档 | 官方接入指南 |
| 协作指南 | 参与开发需要知道的规则 |
仓库内设计文档（docs/ 目录）包含架构、数据库字典、测试与 CI 等详细说明。
| 层级 | 技术 |
|---|---|
| 后端框架 | Fastify |
| 语言 | TypeScript |
| 数据库 | SQLite + Drizzle ORM |
| LLM 接入 | Vercel AI SDK |
| 前端（管理台） | Vue 3 + Pinia + TailwindCSS |
| 包管理 | pnpm (monorepo) |
仓库内有两个前端：
apps/web：现役管理台（Vue 3 + Pinia + TailwindCSS），当前主用前端。apps/studio：正在开发、目前处于验证（实验）阶段的全新统一前端，以 NodeGraph 编辑器为核心（NodeGraph First），并作为现代化技术栈先锋（Vite / Vue / Tailwind / Vitest 等取最新大版本）。尚未稳定，不建议用于生产；其依赖栈可能与仓库其余部分不同，测试以其自身的任务运行。MIT
$ claude mcp add TavernHeadless \
-- python -m otcore.mcp_server <graph>