Toonflow-app — AI 视频生成工具中文文档
Toonflow-app — AI 视频生成工具中文文档 是 AI Skill Hub 本期精选AI工具之一。已获得 8.3k 颗 GitHub Star，综合评分 9.1 分，整体质量较高。我们强烈推荐将其纳入你的 AI 工具库，帮助提升工作效率。
**为什么要使用开源工具而非商业 SaaS？**
对于个人开发者和有隐私需求的用户，本地部署的开源工具意味着数据不离本机，不受第三方服务商的数据政策约束。同时，开源工具通常没有使用次数限制和月度费用，一次安装即可长期使用，对于高频使用场景的总拥有成本（TCO）远低于订阅制商业工具。
**安装与环境准备**
Toonflow-app — AI 视频生成工具中文文档 依赖 HTML 运行环境。建议通过 pyenv（Python）或 nvm（Node.js）管理 HTML 版本，避免全局环境污染。对于新手用户，推荐先创建虚拟环境（python -m venv venv && source venv/bin/activate），再安装依赖，这样即使出现问题也可以随时删除虚拟环境重新开始，不影响系统稳定性。
**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues（已关闭的问题），大多数常见问题都已有解答。遇到 Bug 时，提供 pip list 的输出、完整错误堆栈和最小可复现示例，能显著提高开发者响应速度。AI Skill Hub 将持续追踪 Toonflow-app — AI 视频生成工具中文文档 的版本更新，及时通知重要功能变化。
Toonflow 是开源一站式 AI 短剧创作工具，将小说、剧本快速转化为动画短剧。集成 AI 编剧、智能分镜、角色与视频生成，跨平台桌面端轻量部署，助力创作者低成本批量产出视觉内容。Toonflow is an open-source AI tool that turns stories and scripts into animated short dramas. Features AI scriptwriting, storyboarding, character and video generation. A cross-platform desktop app for efficient content creation.
Toonflow-app — AI 视频生成工具中文文档 是一款基于 HTML 开发的开源工具，专注于 ai、ai-content-creation、ai-tool 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
Toonflow 是开源一站式 AI 短剧创作工具，将小说、剧本快速转化为动画短剧。集成 AI 编剧、智能分镜、角色与视频生成，跨平台桌面端轻量部署，助力创作者低成本批量产出视觉内容。Toonflow is an open-source AI tool that turns stories and scripts into animated short dramas. Features AI scriptwriting, storyboarding, character and video generation. A cross-platform desktop app for efficient content creation.
Toonflow-app — AI 视频生成工具中文文档 是一款基于 HTML 开发的开源工具，专注于 ai、ai-content-creation、ai-tool 等核心功能。作为 GitHub 开源项目，它拥有活跃的社区支持和持续的版本迭代，代码完全透明可审计，支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流，都能提供稳定可靠的解决方案。
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
# 克隆仓库 git clone https://github.com/HBAI-Ltd/Toonflow-app cd Toonflow-app # 查看安装说明 cat README.md # 按 README 完成环境依赖安装后即可使用
- 访问 GitHub 仓库页面
- 按照 README 文档完成依赖安装
- 根据系统环境完成初始化配置
- 参考官方示例或文档开始使用
- 遇到问题可在 GitHub Issues 中查找解答
# 查看帮助 toonflow-app --help # 基本运行 toonflow-app [options] <input> # 详细使用说明请查阅文档 # https://github.com/HBAI-Ltd/Toonflow-app
# toonflow-app 配置说明 # 查看配置选项 toonflow-app --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量（覆盖配置文件） export TOONFLOW_APP_CONFIG="/path/to/config.yml"
简介
<img src="https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=6,11,20&height=200§ion=header&text=Toonflow&fontSize=90&fontColor=ffffff&animation=fadeIn&fontAlignY=50" width="100%"/>
<p> <a href="https://github.com/HBAI-Ltd/Toonflow-app"> <img src="https://img.shields.io/badge/GitHub-181717?style=flat-square&logo=github&logoColor=white" alt="GitHub" /> </a> | <a href="https://gitee.com/HBAI-Ltd/Toonflow-app"> <img src="https://img.shields.io/badge/Gitee-C71D23?style=flat-square&logo=gitee&logoColor=white" alt="Gitee" /> </a> | <a href="https://gitcode.com/HBAI-Ltd/Toonflow-app"> <img src="./docs/atomgitLogo.svg" alt="Atomgit" style="height:20px"/> </a> </p>
<p align="center"> <strong>简体中文</strong> | <a href="./docs/README.zhtw.md">繁體中文</a> | <a href="./docs/README.en.md">English</a> | <a href="./docs/README.th.md">ไทย</a> | <a href="./docs/README.vi.md">Tiếng Việt</a> | <a href="./docs/README.ja.md">日本語</a> | <a href="./docs/README.ru.md">Русский</a> </p>
<img src="./docs/logo.png" alt="Toonflow Logo" height="120"/>
<p align="center"> <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> </p> <p align="center"> <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> </p> <p align="center"> <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> </p> <p align="center"> <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/TypeScript/typescript2.svg" alt="TypeScript" /> <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/NodeJS/nodejs2.svg" alt="Node.js" /> <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Docker/docker2.svg" alt="Docker" /> <img src="https://ziadoua.github.io/m3-Markdown-Badges/badges/Electron/electron2.svg" alt="Electron" /> </p> <p align="center"> <img src="https://mobaicons.com/icons/typescript,nodejs,electron,docker,socket?perline=5" alt="Tech Stack Icons" /> </p> <p align="center"> <img src="https://widgetbite.com/stats/HBAI-Ltd" alt="Visitors" /> </p> > 🚀 一站式短剧工程：从文本到角色，从分镜到视频，0门槛全流程AI化，创作效率提升10倍+！ </div>
---
🌐 多语言支持
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 服务接口地址
- ✅ Sora 或豆包视频服务接口地址
- ✅ Nano Banana Pro 图片生成模型服务接口
前置条件
- 已安装 Docker（版本 20.10+）
一、服务器环境要求
- 系统：Ubuntu 20.04+ / CentOS 7+
- Node.js：24.x（推荐，最低 23.11.1+）
- 内存：2GB+
🚀 安装
本机安装
1. 下载与安装
| 操作系统 | GitHub | 说明 |
|---|---|---|
| Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | 官方发布安装包 |
| Linux | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | 官方发布安装包 |
| macOS | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | 官方发布安装包 |
[!CAUTION] MacOS 系统请到 设置-隐私与安全性 配置安全性否则可能因证书问题无法正常打开 参考知乎文档：https://www.zhihu.com/question/433389276
因 Gitee OS 环境限制及 Release 文件上传大小限制，暂不提供 Gitee Release 下载地址。
Docker 部署
方式一：在线部署
待完善，暂时使用本地构建。
使用 docker-compose 本地构建并启动
yarn docker:local
云端部署
二、服务器部署
1. 安装环境
```bash
安装 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 克隆：**
**从 Gitee 克隆（国内推荐）：**
#### 3. 配置 PM2
创建 `pm2.json` 文件：
**环境变量说明：**
| 变量 | 说明 |
| ---------- | ---------------------------------- |
| `NODE_ENV` | 运行环境，`prod` 表示生产环境 |
| `PORT` | 服务监听端口 |
| `OSSURL` | 文件存储访问地址，用于静态资源访问 |
---
#### 4. 启动服务
#### 5. 常用命令
⚠️ 首次登录 账号：admin密码：admin123
6. 部署前端网站
如需单独部署或定制前端界面，请参考前端仓库：
- GitHub：Toonflow-web
- Gitee：Toonflow-web
💡 说明：本仓库已内置编译好的前端资源，普通用户无需单独部署前端。前端仓库仅供需要二次开发的开发者使用。
---
开发环境准备
- Node.js：版本要求 23.11.1 及以上
- Yarn：推荐作为项目包管理器
🔰 使用指南
快速上手
- 启动应用并登录（默认账号：
admin/admin123）。 - 在设置中心完成模型供应商配置（文本/图像/视频模型）。
- 新建项目并导入原著，执行章节事件提取。
- 进入 ScriptAgent 生成故事骨架、改编策略与结构化剧本。
- 切换到 ProductionAgent，在无限画布中组织分镜、素材与视频节点。
- 对分镜图进行节点化精调后回流工作台，完成视频拼接与导出。
📺 视频教程
https://www.bilibili.com/video/BV1oXD7BqEqJ 
Toonflow 12 分钟快速上手 AI 视频 👉 点击观看
📱 手机微信扫码观看
<img src="./docs/videoQR.png" alt="微信扫码观看" width="150"/>
---
📸 演示截图与视频
以下截图及视频来自使用 Toonflow 制作的一段 AI 短剧 Demo，全程约 2 小时完成，涵盖剧本生成、分镜制作及剪辑环节。
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
2. 启动服务
安装完成后，启动程序即可开始使用本服务。
⚠️ 首次登录 账号：admin密码：admin123
快速启动项目
- 克隆项目
从 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
- 启动开发环境
本项目包含 后端 API 服务 和 前端页面 两部分，请根据需要选择启动方式：
- 方式一：仅启动后端服务
yarn dev
⚠️ 此命令仅启动后端 API 服务（端口 10588），不包含前端页面。直接访问 http://localhost:10588 只能调用 API 接口，无法看到完整的网页界面。如需同时使用前端页面，请配合前端项目单独启动，或使用下方的 GUI 模式。
- 方式二：启动 Electron 桌面客户端
yarn dev:gui
此命令会同时启动后端服务和 Electron 桌面窗口，自带内置前端页面，开箱即用，无需额外配置。适合想要完整体验所有功能的开发者。
- 方式三：生产模式启动
yarn start
以生产模式直接运行编译后的服务（需先执行 yarn build）。
- 项目打包
- 编译并生成 TypeScript 文件：
yarn build
- 打包为 Windows 平台可执行程序：
yarn dist:win
- 打包为 Mac 平台可执行程序：
yarn dist:mac
- 打包为 Linux 平台可执行程序：
yarn dist:linux
- 代码质量检查
- 进行全局语法和规范检查：
yarn lint
- AI 调试面板（可选）
启动 AI SDK 的可视化调试工具，方便调试 AI 调用：
yarn debug:ai
🎬 Demo 视频
https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9
如无法播放，请点击下载视频
</div>
Demo 信息
| 项目 | 详情 |
|---|---|
| 制作周期 | 约 2 小时 |
| 视频模型 | Seedance 2.0 |
| 图片模型 | GPT Image 2 |
| 语言模型 | Claude Opus 4.6 |
| 成片总时长 | 约 2 分钟（原始素材 3 分钟，剪除废片约 1 分钟） |
- 构建多智能体协作系统的 Agent 开发者
- 构建企业知识库 / RAG 检索应用的团队
- 跨境业务、多语言内容运营团队
- 生产部署优先使用 Docker Compose 隔离依赖，并挂载 volume 持久化数据
- Agent 任务先做 dry-run 验证工具调用链，再开启自主执行
- API key 直接提交到 git 仓库（请用 .env 并加入 .gitignore）
- 容器内无法访问宿主机 localhost — 使用 host.docker.internal
- Docker：Toonflow-app 提供官方镜像，docker compose up 一键启动
- 云端托管：可放在 Vercel / Railway / Fly.io 等 PaaS 平台
- 开源免费，支持本地部署，数据完全自主可控
- 活跃的 GitHub 开源社区，持续迭代更新
- 提供详细文档和使用示例，新手友好
- 支持自定义配置，灵活适配不同使用环境
- 可作为基础组件集成进现有技术栈或进行二次开发
- 本地部署运行，保护数据隐私，满足合规要求
- 自定义集成到现有系统，扩展技术栈能力
- 作为开源基础组件进行商业化二次开发
- +GitHub 8.3k Star，社区高度认可
- +Apache-2.0 协议，可免费商用
- +AI Skill Hub 精选推荐
- +完全开源免费，无授权费用
- +本地部署，数据完全自主可控
- −安装和初始配置可能需要一定技术基础
- −功能完整性通常不如成熟商业产品
- −技术支持主要依赖开源社区，响应速度不稳定
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
✅ Apache 2.0 — 宽松开源协议，可商用，需保留版权声明和 NOTICE 文件，含专利授权条款。
经综合评估，Toonflow-app — AI 视频生成工具中文文档 在AI工具赛道中表现稳健，质量优秀。如果你已有明确的使用需求，可以直接上手体验；如果还在评估阶段，建议对比同类工具后再做决策。
| 原始名称 | Toonflow-app |
| 原始描述 | Toonflow 是开源一站式 AI 短剧创作工具，将小说、剧本快速转化为动画短剧。集成 AI 编剧、智能分镜、角色与视频生成，跨平台桌面端轻量部署，助力创作者低成本批量产出视觉内容。Toonflow is an open-source AI tool that turns stories and scripts into animated short dramas. Features AI scriptwriting, storyboarding, character and video generation. A cross-platform desktop app for efficie… |
| Topics | aiai-content-creationai-toolai-video-generationautomationcontent-generationvideo |
| GitHub | https://github.com/HBAI-Ltd/Toonflow-app |
| License | Apache-2.0 |
| 语言 | HTML |
收录时间：2026-05-22 · 更新时间：2026-05-22 · License：Apache-2.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。