The project's README from github.com/HBAI-Ltd/Toonflow-app. As one markdown file: README.md.
简体中文 | 繁體中文 | English | ไทย | Tiếng Việt | 日本語 | Русский
Toonflow 支持以下语言界面:
| 语言 | Language |
|---|---|
| 简体中文 | Chinese (Simplified) |
| 繁體中文 | Chinese (Traditional) |
| English | English |
| ไทย | Thai |
| Tiếng Việt | Vietnamese |
| 日本語 | Japanese |
| Русский | Russian |
💡 更多语言适配中,欢迎贡献翻译!
Toonflow 是面向短剧生产的 AI 工作台,围绕“策划 → 编剧 → 分镜 → 出片”构建完整闭环,并支持本地化、可编程、可持续迭代的生产流程。
admin / admin123)。https://www.bilibili.com/video/BV1oXD7BqEqJ

Toonflow 12 分钟快速上手 AI 视频 👉 点击观看
📱 手机微信扫码观看
以下截图及视频来自使用 Toonflow 制作的一段 AI 短剧 Demo,全程约 2 小时完成,涵盖剧本生成、分镜制作及剪辑环节。
| 项目 | 详情 |
|---|---|
| 制作周期 | 约 2 小时 |
| 视频模型 | Seedance 2.0 |
| 图片模型 | GPT Image 2 |
| 语言模型 | Claude Opus 4.6 |
| 成片总时长 | 约 2 分钟(原始素材 3 分钟,剪除废片约 1 分钟) |
| 模型类型 | 费用 |
|---|---|
| 语言模型 | 约 ¥10 |
| 视频模型(全量生成) | 约 ¥120 |
| 图片模型 | 不足 ¥1 |
| 合计 | 约 ¥130 |
声明:Demo 原始分辨率为 1080×1882,发布版本已压缩至 480p。如涉及版权问题,请联系我们删除处理。
在安装和使用本软件之前,请准备以下内容:
| 操作系统 | GitHub | 说明 |
|---|---|---|
| Windows | Release | 官方发布安装包 |
| Linux | Release | 官方发布安装包 |
| macOS | Release | 官方发布安装包 |
[!CAUTION] MacOS 系统请到 设置-隐私与安全性 配置安全性否则可能因证书问题无法正常打开
因 Gitee OS 环境限制及 Release 文件上传大小限制,暂不提供 Gitee Release 下载地址。
安装完成后,启动程序即可开始使用本服务。
⚠️ 首次登录
账号:admin
密码:admin123
待完善,暂时使用本地构建。
使用本地已有的源码直接构建,适合开发者或已克隆仓库的用户,这需要你在本地安装 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 |
文件存储访问地址,用于静态资源访问 |
# 安装 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
从 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
创建 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 |
文件存储访问地址,用于静态资源访问 |
pm2 start pm2.json
pm2 startup
pm2 save
pm2 list # 查看进程
pm2 logs toonflow-app # 查看日志
pm2 restart all # 重启服务
pm2 monit # 监控面板
⚠️ 首次登录
账号:admin
密码:admin123
如需单独部署或定制前端界面,请参考前端仓库:
💡 说明:本仓库已内置编译好的前端资源,普通用户无需单独部署前端。前端仓库仅供需要二次开发的开发者使用。
🎉 官方认证算力合作平台 —— 智星云
智星云 是 Toonflow 官方授权的商用镜像服务商,已合法搭载、分发并支持商用全套 Toonflow AI 短剧制作镜像,开箱即用,无需手动部署。
- 🌐 官网:https://www.ai-galaxy.com
- 📖 镜像部署图文教程:点击查看教程
💡 建议开启「按小时自动续租」模式,防止正在跑视频时实例到期停工。
windows10LTSCwin10_Toonflow - 创建实例。💡 鼠标移到云端桌面顶端稍作停留,会显示切换桌面操作栏,可点击“——”切换回自己的电脑桌面,或点击“□”缩小布置到自己的电脑桌面作为操作窗口。
admin 密码:admin123(建议登录后修改密码)💡 这里直接使用智星云的 AI 大模型 Token 服务,官方接口,稳定安全,低至 6 折(小说转剧本调用一次,约花费 6.4 毛钱)。
https://token.ai-galaxy.com/v1Toonflow 或其他均可,点击确定并复制 API 密钥。💡 一个 Key 可以调用智星云上的所有模型,选择你想用的即可,推荐
deepseek-v4-pro。 将模型名称完整复制粘贴到 Toonflow 中并确认,完成模型配置。
[!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 |
克隆项目
从 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
安装依赖
请先在项目根目录下执行以下命令以安装依赖项:
yarn install
启动开发环境
本项目包含