HBAI-Ltd/Toonflow-app



 |   | 

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

---

🌐 多语言支持

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 视频

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

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

云平台部署

🎉 官方认证算力合作平台 —— 智星云

> 智星云 是 Toonflow 官方授权的商用镜像服务商，已合法搭载、分发并支持商用全套 Toonflow AI 短剧制作镜像，开箱即用，无需手动部署。

> - 🌐 官网：https://www.ai-galaxy.com

- 📖 镜像部署图文教程：点击查看教程

📄 点击展开文字版教程

一、租用 GPU 阶段教程

1. 智星云 - 算力市场 - 4090 / 4090 Plus，点击「立即租用」进入租用详情页。 > 💡 建议开启「按小时自动续租」模式，防止正在跑视频时实例到期停工。 2. 镜像选择：windows10LTSCwin10_Toonflow - 创建实例。 3. 等待实例启动 30s ~ 60s，查看链接方式 - RDP 登录文件下载 - 点击复制密码 - 双击已下载好的云端连接文件。 4. 将复制好的密码粘贴并登录，连接进入云端桌面。 > 💡 鼠标移到云端桌面顶端稍作停留，会显示切换桌面操作栏，可点击“——”切换回自己的电脑桌面，或点击“□”缩小布置到自己的电脑桌面作为操作窗口。

二、配置 Toonflow、启动 ComfyUI 阶段教程

1. 先配置调用 Agent 的模型：打开桌面上的 Toonflow - 模型服务 - OpenAI 标准接口 - 填入 API 密钥以及请求地址。 默认账号：admin　密码：admin123（建议登录后修改密码） > 💡 这里直接使用智星云的 AI 大模型 Token 服务，官方接口，稳定安全，低至 6 折（小说转剧本调用一次，约花费 6.4 毛钱）。

• 智星云调用模型 Token 请求地址：https://token.ai-galaxy.com/v1
• 智星云 Token 充值步骤：Token 市场 - 账户概览 - 充值 - 将智星云账户余额或算力券充值到 Token 账户中。
• 充值完成后进入「Key 管理」- 新建 API 管理，名称填 Toonflow 或其他均可，点击确定并复制 API 密钥。

2. 回到步骤 1，将生成的 API 密钥和请求地址粘贴到 Toonflow 模型服务中，填好后点击空白处，系统会提示「供应商配置已更新」。 点击「手动添加」，回到智星云 - Token 市场页面，复制完整的模型名称。 > 💡 一个 Key 可以调用智星云上的所有模型，选择你想用的即可，推荐 deepseek-v4-pro。 > 将模型名称完整复制粘贴到 Toonflow 中并确认，完成模型配置。 3. 配置完成后检查两处：

• 模型服务中的三个模型调用开关是否已开启
• Agent 配置中调用的模型是否与你配置的一致（不一致时点击选择改正即可）

4. 启动 ComfyUI：云端桌面 - 绘世启动器 - 一键启动。 5. 启动大约需要 1~2 分钟，启动完成后保持页面开启状态即可。

---

🔧 开发流程指南

[!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 克隆：

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

从 Gitee 克隆（国内推荐）：

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

2. 安装依赖

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

   yarn install
   

3. 启动开发环境

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

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

     yarn dev
     

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

• 方式二：启动 Electron 桌面客户端

     yarn dev:gui
     

> 此命令会同时启动后端服务和 Electron 桌面窗口，自带内置前端页面，开箱即用，无需额外配置。适合想要完整体验所有功能的开发者。

• 方式三：生产模式启动

     yarn start
     

> 以生产模式直接运行编译后的服务（需先执行 yarn build）。

4. 项目打包

• 编译并生成 TypeScript 文件：

     yarn build
     

• 打包为 Windows 平台可执行程序：

     yarn dist:win
     

• 打包为 Mac 平台可执行程序：

     yarn dist:mac
     

• 打包为 Linux 平台可执行程序：

     yarn dist:linux
     

5. 代码质量检查

• 进行全局语法和规范检查：

     yarn lint
     

6. AI 调试面板（可选）

启动 AI SDK 的可视化调试工具，方便调试 AI 调用：

   yarn debug:ai
   

前端开发

如需修改前端界面，请前往前端仓库进行开发：

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

前端构建后，将 dist 目录内容复制到本项目的 data/web 目录即可集成。

项目结构

📂 build/                    # 编译产物
📂 data/                     # 运行时数据
│  ├─ 📂 models/            # 本地推理模型（ONNX）
│  ├─ 📂 oss/               # 对象存储（素材/角色/场景）
│  ├─ 📂 serve/             # 生产环境入口
│  ├─ 📂 skills/            # Agent 技能提示词
│  └─ 📂 web/               # 前端编译产物（内置）
📂 docs/                     # 文档资源
📂 env/                      # 环境配置
📂 scripts/                  # 构建与辅助脚本
📂 src/
├─ 📂 agents/               # AI Agent 模块
│  ├─ 📂 productionAgent/   # 生产 Agent
│  └─ 📂 scriptAgent/       # 剧本 Agent
├─ 📂 lib/                  # 公共库（数据库初始化、响应格式）
├─ 📂 middleware/            # 中间件
├─ 📂 routes/               # 路由模块
│  ├─ 📂 agents/            # Agent 记忆管理
│  ├─ 📂 artStyle/          # 画风管理
│  ├─ 📂 assets/            # 素材管理
│  ├─ 📂 assetsGenerate/    # 素材生成
│  ├─ 📂 cornerScape/       # 分镜管理
│  ├─ 📂 general/           # 通用接口
│  ├─ 📂 login/             # 登录认证
│  ├─ 📂 migrate/           # 数据迁移
│  ├─ 📂 modelSelect/       # 模型选择
│  ├─ 📂 novel/             # 小说管理
│  ├─ 📂 other/             # 其他功能
│  ├─ 📂 production/        # 制作管理
│  ├─ 📂 project/           # 项目管理
│  ├─ 📂 script/            # 剧本生成
│  ├─ 📂 scriptAgent/       # 剧本 Agent 接口
│  ├─ 📂 setting/           # 系统设置
│  ├─ 📂 task/              # 任务管理
│  └─ 📂 test/              # 测试接口
├─ 📂 socket/               # WebSocket 实时通信
├─ 📂 types/                # TypeScript 类型声明
├─ 📂 utils/                # 工具函数
├─ 📄 app.ts                # 应用入口
├─ 📄 core.ts               # 核心初始化
├─ 📄 env.ts                # 环境变量处理
├─ 📄 err.ts                # 错误处理
├─ 📄 logger.ts             # 日志模块
├─ 📄 router.ts             # 路由注册
└─ 📄 utils.ts              # 通用工具
📄 Dockerfile                # Docker 构建文件
📄 electron-builder.yml      # Electron 打包配置
📄 skillList.json            # 技能清单
📄 LICENSE                   # 许可证（Apache-2.0）
📄 NOTICES.txt               # 第三方依赖声明
📄 package.json              # 项目配置
📄 tsconfig.json             # TypeScript 配置

---

🔗 相关仓库

| 仓库 | 说明 | GitHub | Gitee | | ---------------- | ---------------------------------- | -------------------------------------------------- | ------------------------------------------------ | | Toonflow-app | 完整客户端（本仓库，推荐普通用户） | GitHub | Gitee | | Toonflow-web | 前端源代码（适合前端开发者） | GitHub | Gitee |

💡 提示：如果您只是想使用 Toonflow，直接下载本仓库的客户端即可。前端仓库仅供需要二次开发或定制前端界面的开发者使用。

---

👨‍👩‍👧‍👦 微信交流群

拉群小助手:

也可以点击图标加入 Discord：

或点击邀请连接： https://discord.gg/HEjKmpNpAZ

---

💌 联系我们

📧 邮箱：ltlctools@outlook.com

---

📜 许可证

Toonflow 基于 Apache-2.0 协议开源发布，并附有补充商业协议。

许可证详情：https://www.apache.org/licenses/LICENSE-2.0

补充协议

• 若将本软件以产品形式分发给 2 个及以上独立第三方使用，须取得 HBAI-Ltd 书面商业授权。
• ≤ 5 个法人联合运营内部使用，不对外提供服务的，视为内部使用，无需授权。
• 不得删除或修改 Toonflow 中的标识或版权信息。

永久免费场景

• ✅ 用 Toonflow 制作内容并获得平台分账
• ✅ 二次开发供自己团队内部使用
• ✅ ≤ 5 个法人联合运营内部使用
• ✅ 个人学习、研究、非商业用途

商业授权定价

| 阶段 | 年销售额 | 年费 | | --------- | ----------- | -------------------- | | 🌱 扶持期 | < ¥10 万 | 申请即可免费授权 | | 🚀 初创期 | ¥10–50 万 | ¥5,000/年 | | 📈 成长期 | ¥50–150 万 | ¥20,000/年 | | 🏢 规模期 | ¥150–500 万 | ¥80,000/年 | | 🌐 企业级 | > ¥500 万 | 面议 |

不追溯条款：v1.0.8 发布前基于 AGPL-3.0 使用的用户，继续按 AGPL-3.0 执行，不受本协议变更约束。

完整协议详见 LICENSE 文件。

---

⭐️ 星标历史

---

🙏 致谢

感谢以下开源项目为 Toonflow 提供强大支持：

• Express - 快速、开放、极简的 Node.js Web 框架
• AI SDK - 面向 TypeScript 的 AI 工具包
• Better-SQLite3 - 高性能 SQLite3 绑定库
• Sharp - 高性能 Node.js 图像处理库
• Axios - 基于 Promise 的 HTTP 客户端
• Zod - TypeScript 优先的模式验证库
• Socket.IO - 实时双向事件通信引擎
• Electron - 跨平台桌面应用开发框架
• Hugging Face Transformers - 本地 ML 推理库

感谢以下组织/单位/个人为 Toonflow 提供支持：

Logo	名称	支持方式	简介	官网
	秘塔	💻 算力赞助	秘塔科技提供高性价比的 MiniMax H3 视频生成服务：768P 仅 0.09 元/秒，2K 仅 0.15 元/秒。支持原生 2K、音画同步，API 兼容 OpenAI 协议，同时支持 ComfyUI、无限画布，无需自行部署 GPU。 🎁 通过 专属链接注册，即可领取赠送额度及专属优惠。商务对接可加微信：metasota12	官网
	APIMart	💻 算力赞助	感谢 APIMart 赞助了本项目！APIMart 是专注 AI 图片/视频生成的低价 API 平台，GPT-Image-2 低至 $0.006/张，1 美元可出图 160+ 张。图片、视频一套异步 API 通吃，提交任务拿 ID、回调取结果，跑批万张不超时、换模型不改代码。按量付费、无月费，通过此注册链接注册即可开用。	官网
	算能云	💻 算力赞助	致力于打造更快、更稳、更省的一站式模型推理API服务平台	官网
	腾讯混元3D	🌐 世界模型技术支持	腾讯混元3D AI创作引擎基于腾讯混元3D生成大模型2.5版本，业界首个一站式3D内容AI创作平台。具备文生、图生3D、3D动画生成、纹理生成等功能，支持草图生3D、3D人物生成，有低多边形模型生成优势。	官网
	智星云	💻 算力支持 🖼️ 镜像支持	国内知名专业算力服务品牌，提供便宜稳定的算力，服务国内清北、复旦、浙大等上千所985/211高校实验室、中科院及5000余家AI企业。	官网

完整的第三方依赖清单请查阅 NOTICES.txt

copyright © 北京爱阿科技有限公司