|   | 

简体中文 | 繁體中文 | English | ไทย | Tiếng Việt | 日本語 | Русский

<img src="https://github.com/HBAI-Ltd/Toonflow-app/raw/v1.1.8/docs/logo.png" alt="Toonflow Logo" height="120"/>







<a href="https://git.io/typing-svg" target="_blank">






    <img alt="Typing SVG" src="https://readme-typing-svg.demolab.com?font=Fira+Code&size=40&duration=3000&pause=1000&color=000000&center=true&vCenter=true&width=600&lines=Toonflow;AI%E7%9F%AD%E5%89%A7%E5%B7%A5%E5%8E%82;%E5%8A%A8%E5%8A%A8%E6%89%8B%E6%8C%87%EF%BC%8C%E5%B0%8F%E8%AF%B4%E7%A7%92%E5%8F%98%E5%89%A7%E9%9B%86%EF%BC%81" />



</a>







<a href="https://github.com/HBAI-Ltd/Toonflow-app/stargazers">
  <img src="https://img.shields.io/github/stars/HBAI-Ltd/Toonflow-app?style=for-the-badge&logo=github" alt="Stars Badge" />
</a>
<a href="https://www.apache.org/licenses/LICENSE-2.0" target="_blank">
  <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg?style=for-the-badge" alt="Apache-2.0 License Badge" />
</a>
<a href="https://github.com/HBAI-Ltd/Toonflow-app/releases">
  <img alt="release" src="https://img.shields.io/github/v/release/HBAI-Ltd/Toonflow-app?style=for-the-badge" />
</a>






<a href="https://github.com/HBAI-Ltd/Toonflow-app/network/members">
  <img src="https://img.shields.io/github/forks/HBAI-Ltd/Toonflow-app?style=for-the-badge&logo=github&color=orange" alt="Forks Badge" />
</a>
<a href="https://atomgit.com/HBAI-Ltd/Toonflow-app">
  <img src="https://img.shields.io/badge/AtomGit-G--Star%20No.540-FF6B35?style=for-the-badge&logo=git&logoColor=white" alt="AtomGit G-Star No.540" />
</a>
<a href="https://discord.gg/HEjKmpNpAZ">
  <img src="https://img.shields.io/badge/Discord-Community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord" />
</a>






<a href="https://github.com/HBAI-Ltd/Toonflow-app/issues">
  <img src="https://img.shields.io/github/issues/HBAI-Ltd/Toonflow-app?style=for-the-badge&color=F48D73" alt="Issues" />
</a>
<a href="https://github.com/HBAI-Ltd/Toonflow-app/graphs/contributors">
  <img src="https://img.shields.io/github/contributors/HBAI-Ltd/Toonflow-app?style=for-the-badge&color=2088FF" alt="Contributors" />
</a>
<a href="https://github.com/HBAI-Ltd/Toonflow-app/commits">
  <img src="https://img.shields.io/github/last-commit/HBAI-Ltd/Toonflow-app?style=for-the-badge&color=blueviolet" alt="Last Commit" />
</a>






<img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/TypeScript/typescript2.svg" alt="TypeScript" />&nbsp;
<img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/NodeJS/nodejs2.svg" alt="Node.js" />&nbsp;
<img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Docker/docker2.svg" alt="Docker" />&nbsp;
<img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Electron/electron2.svg" alt="Electron" />






<img src="https://mobaicons.com/icons/typescript,nodejs,electron,docker,socket?perline=5" alt="Tech Stack Icons" />

🚀 一站式短剧工程：从文本到角色，从分镜到视频，0门槛全流程AI化，创作效率提升10倍+！

GVP - Gitee最有价值开源项目

---

🌐 多语言支持

Toonflow 支持以下语言界面：

语言	Language
简体中文	Chinese (Simplified)
繁體中文	Chinese (Traditional)
English	English
ไทย	Thai
Tiếng Việt	Vietnamese
日本語	Japanese
Русский	Russian

💡 更多语言适配中，欢迎贡献翻译！

---

🌟 主要功能

Toonflow 是面向短剧生产的 AI 工作台，围绕“策划 → 编剧 → 分镜 → 出片”构建完整闭环，并支持本地化、可编程、可持续迭代的生产流程。

• ✅ 无限画布生产工作台
  以类无限画布形式组织剧本、角色、分镜、素材与视频节点，支持自由编排、回溯与并行生产，不受线性步骤限制。
• ✅ 三层 Agent 协作体系
  决策层、执行层、监督层协同工作，覆盖任务拆解、内容生成、质量审阅与修订反馈，提升稳定性与成片一致性。
• ✅ 持久化 Agent 记忆
  基于本地 ONNX 向量检索的跨会话记忆系统，支持短期消息、长期摘要和语义召回，确保多轮创作连续性。
• ✅ 可编程供应商系统
  支持在设置中心直接编写供应商 TypeScript 逻辑并即时生效，无需改源码或重启，便于私有化和多模型接入。
• ✅ 章节事件图谱驱动改编
  自动提取原著章节事件并结构化存储，剧本改编按事件图谱精准调用上下文，减少长文本信息丢失。
• ✅ Skill 文件化配置
  ScriptAgent 与 ProductionAgent 的核心提示词外化为 Markdown Skill 文件，支持在线编辑与快速调优。

---

📦 应用场景

• 短视频内容创作
• 小说影视化实验
• AI 文学改编工具
• 剧本开发与快速原型
• 视频素材生成

---

🔰 使用指南

快速上手

1. 启动应用并登录（默认账号：admin / admin123）。
2. 在设置中心完成模型供应商配置（文本/图像/视频模型）。
3. 新建项目并导入原著，执行章节事件提取。
4. 进入 ScriptAgent 生成故事骨架、改编策略与结构化剧本。
5. 切换到 ProductionAgent，在无限画布中组织分镜、素材与视频节点。
6. 对分镜图进行节点化精调后回流工作台，完成视频拼接与导出。

📺 视频教程

https://www.bilibili.com/video/BV1oXD7BqEqJ

Toonflow 12 分钟快速上手 AI 视频 👉 点击观看

📱 手机微信扫码观看

---

📸 演示截图与视频

以下截图及视频来自使用 Toonflow 制作的一段 AI 短剧 Demo，全程约 2 小时完成，涵盖剧本生成、分镜制作及剪辑环节。

🎬 Demo 视频

https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9

如无法播放，请点击下载视频

Demo 信息

项目	详情
制作周期	约 2 小时
视频模型	Seedance 2.0
图片模型	GPT Image 2
语言模型	Claude Opus 4.6
成片总时长	约 2 分钟（原始素材 3 分钟，剪除废片约 1 分钟）

成本明细

模型类型	费用
语言模型	约 ¥10
视频模型（全量生成）	约 ¥120
图片模型	不足 ¥1
合计	约 ¥130

声明：Demo 原始分辨率为 1080×1882，发布版本已压缩至 480p。如涉及版权问题，请联系我们删除处理。

---

🚀 安装

前置条件

在安装和使用本软件之前，请准备以下内容：

• ✅ 大语言模型 AI 服务接口地址
• ✅ Sora 或豆包视频服务接口地址
• ✅ Nano Banana Pro 图片生成模型服务接口

本机安装

1. 下载与安装

操作系统	GitHub	说明
Windows	Release	官方发布安装包
Linux	Release	官方发布安装包
macOS	Release	官方发布安装包

[!CAUTION] MacOS 系统请到 设置-隐私与安全性 配置安全性否则可能因证书问题无法正常打开

参考知乎文档：https://www.zhihu.com/question/433389276

因 Gitee OS 环境限制及 Release 文件上传大小限制，暂不提供 Gitee Release 下载地址。

2. 启动服务

安装完成后，启动程序即可开始使用本服务。

⚠️ 首次登录
账号：admin
密码：admin123

Docker 部署

前置条件

• 已安装 Docker（版本 20.10+）

方式一：在线部署

待完善，暂时使用本地构建。

方式二：本地构建

使用本地已有的源码直接构建，适合开发者或已克隆仓库的用户，这需要你在本地安装 git：

# 先克隆项目（如已有则跳过）
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app

# 使用 docker-compose 本地构建并启动
yarn docker:local

# 或者手动构建
docker build -t toonflow .
docker run -d -p <本地端口>:10588 -v <本地数据路径>:/app/data toonflow

# 此时在相应端口的 /web/index.html 路径即可访问页面
# 例如 http://localhost:10588/web/index.html

服务端口说明

端口	用途	部署映射
10588	软件界面	10588:10588

环境变量说明：

变量	说明
NODE_ENV	运行环境，prod 表示生产环境
PORT	服务监听端口（默认 10588）
OSSURL	文件存储访问地址，用于静态资源访问

---

云端部署

一、服务器环境要求

• 系统：Ubuntu 20.04+ / CentOS 7+
• Node.js：24.x（推荐，最低 23.11.1+）
• 内存：2GB+

二、服务器部署

1. 安装环境

# 安装 Node.js
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 24
# 安装 Yarn 和 PM2
npm install -g yarn pm2

2. 部署项目

从 GitHub 克隆：

cd /opt
git clone https://github.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
yarn install
yarn build

从 Gitee 克隆（国内推荐）：

cd /opt
git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git
cd Toonflow-app
yarn install
yarn build

3. 配置 PM2

创建 pm2.json 文件：

{
  "name": "toonflow-app",
  "script": "data/serve/app.js",
  "instances": "max",
  "exec_mode": "cluster",
  "env": {
    "NODE_ENV": "prod",
    "PORT": 10588,
    "OSSURL": "http://127.0.0.1:10588/"
  }
}

环境变量说明：

变量	说明
NODE_ENV	运行环境，prod 表示生产环境
PORT	服务监听端口
OSSURL	文件存储访问地址，用于静态资源访问

---

4. 启动服务

pm2 start pm2.json
pm2 startup
pm2 save

5. 常用命令

pm2 list              # 查看进程
pm2 logs toonflow-app # 查看日志
pm2 restart all       # 重启服务
pm2 monit             # 监控面板

⚠️ 首次登录
账号：admin
密码：admin123

6. 部署前端网站

如需单独部署或定制前端界面，请参考前端仓库：

• GitHub：Toonflow-web
• Gitee：Toonflow-web

💡 说明：本仓库已内置编译好的前端资源，普通用户无需单独部署前端。前端仓库仅供需要二次开发的开发者使用。

---

🔧 开发流程指南

[!CAUTION] 🚧 PR 提交规范 🚧

⛔ master 分支不接受任何 PR ｜ ✅ 请将 PR 提交到 develop 分支

欢迎开发者们共同参与 Toonflow 的共创。如有兴趣加入，请在交流群内联系主理人 ACT

🛠️ 技术栈

类别	技术
运行时	Node.js 23.11.1+
语言	TypeScript 5.x
后端框架	Express 5
数据库	SQLite（better-sqlite3 / knex）
AI 集成	Vercel AI SDK（OpenAI / Anthropic / Google / DeepSeek / 智谱 / MiniMax / 通义千问 / xAI）
本地推理	@huggingface/transformers（ONNX）
实时通信	Socket.IO
桌面客户端	Electron 40
图像处理	Sharp
容器化	Docker

开发环境准备

• Node.js：版本要求 23.11.1 及以上
• Yarn：推荐作为项目包管理器

快速启动项目

1. 克隆项目

从 GitHub 克隆：

bash git clone https://github.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app

从 Gitee 克隆（国内推荐）：

bash git clone https://gitee.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app

1. 安装依赖

请先在项目根目录下执行以下命令以安装依赖项：

bash yarn install

1. 启动开发环境

本项目包含 后端 API 服务 和 前端页面 两部分，请根据需要选择启动方式：

• 方式一：仅启动后端服务

  bash yarn dev

  ⚠️ 此命令仅启动后端 API 服务（端口 10588），不包含前端页面。直接访问 http://localhost:10588 只能调用 API 接口，无法看到完整的网页界面。如需同时使用前端页面，请配合前端项目单独启动，或使用下方的 GUI 模式。

-