# Toonflow-app **Repository Path**: csjiabin/Toonflow-app ## Basic Information - **Project Name**: Toonflow-app - **Description**: No description available - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-09-24 - **Last Updated**: 2026-09-24 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README Toonflow

| |

TypeScript

**开源 AI 短剧漫剧视频创作平台** > 🚀 **一站式短剧创作**：集成剧本创作、资产管理、图像与视频生成，在无限画布中组织完整的创作流程。

下载客户端 · 使用教程 · 插件市场 · 开发者文档 · 官方模型平台

--- ## 1. 💛 赞助与支持感谢以下合作伙伴对 Toonflow 开源项目的支持。

秘塔 _{秘塔科技提供高性价比的 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、回调取结果，跑批万张不超时、换模型不改代码。按量付费、无月费，通过此注册链接注册即可开用。}

👉成为赞助商👈

商务合作微信二维码

_{此联系方式仅用于商务合作接洽，不提供问题答疑。使用问题欢迎在交流群交流，需求与 BUG 可通过反馈表提交。感谢理解。}

--- ## 2. 🌟 亮点 Toonflow 是面向短剧、漫剧与短视频制作的开源 AI 创作平台，把剧本、资产与视频片段整合进同一张无限画布。 | 能力 | 说明 | | --- | --- | | 🏠 **本地部署** | 项目与素材保存在自己的设备或服务器，支持桌面、Docker 与服务器部署。 | | 🖼️ **无限画布** | 在同一画布中组织剧本、角色、场景与视频片段。 | | 🔌 **MCP** | 通过 MCP 连接外部工具与服务。 | | 🧩 **插件市场** | 通过[插件市场](https://api.toonflow.net/console/plugIn)扩展节点、工具与创作能力。 | | 🤖 **开放 Agent** | 开放提示词、工具和 A2A，支持自定义 Agent 行为及外部协作。 | | 🔧 **自由接入模型** | 配置第三方 API，也可接入本地 ComfyUI 和 LLM。 | --- ## 3. 📸 截图

_{项目首页与灵感创作}

_{首次启动与快速配置}

_{创作画布 · 深色主题}

_{创作画布 · 浅色主题}

_{角色、场景与道具资产}

_{3D 导演台与镜头预演}

_{角色三视图与图片生成}

_{多参考素材视频生成}

_{节点菜单与分组操作}

_插件市场

--- ## 4. 🚀 下载并安装 ### 4.1 桌面安装 | 操作系统 | GitHub | | -------- | ------------------------------------------------------------ | | Windows | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | | macOS | [Release](https://github.com/HBAI-Ltd/Toonflow-app/releases) | Windows 安装器会自动检测并安装 WebView2；如果安装后打开闪退，请前往 [WebView2 下载页面](https://developer.microsoft.com/microsoft-edge/webview2/) 手动安装运行时。 macOS（Apple Silicon）将 Toonflow 拖入“应用程序”后直接打开即可，无需预先执行终端命令。若遇到系统安全提示，请按以下顺序处理。

macOS 无法安装或打开时的处理方法

**1. 在“隐私与安全性”中允许 Toonflow** 如果提示“无法验证开发者”或“Apple 无法检查 App 是否包含恶意软件”，先尝试打开 Toonflow，再前往“系统设置 → 隐私与安全性”，找到 Toonflow 被阻止的提示，点击“仍要打开”，并按提示确认。详见 [Apple 官方说明](https://support.apple.com/zh-cn/102445)。 **2. 仍因系统隔离限制无法打开时，再尝试移除隔离属性** 确认应用来自官方发布页，并已放入“应用程序”后，在终端执行以下命令，再重新打开。应用名称或安装位置不同时，请调整路径。 ```bash sudo xattr -rd com.apple.quarantine /Applications/toonflow.app ``` **3. 最后手段：临时允许任何来源的 App** 前两种方法均无效且确认应用来源可信时，可尝试在终端执行： ```bash sudo spctl --master-disable ``` 随后打开“系统设置 → 隐私与安全性”，在“安全性”中的“允许从以下位置下载的 App”选择“任何来源”（如果系统提供该选项），并按提示确认。不同 macOS 版本的选项与命令支持可能不同。此操作会放宽所有 App 的安全限制。完成后建议将允许来源恢复为“App Store 和被认可的开发者”。

更多操作说明请查看 [使用教程](https://qcn7xdsqgc4z.feishu.cn/docx/RXFqdgR2Xo0dXZxGfd0cZCGgnwf)。 --- ### 4.2 Docker 安装先安装 Git、[Docker Engine](https://docs.docker.com/engine/install/) 和 Docker Compose；Windows / macOS 可使用 Docker Desktop 的 Linux 容器模式。仓库提供 [Dockerfile](./Dockerfile)、[Compose 配置](./compose.yaml) 和 [构建排除规则](./.dockerignore)，基于 Bun 1.3.14 构建，镜像内包含 FFmpeg。

展开 Docker 安装步骤

克隆源码后，在仓库根目录执行： ```sh git clone https://github.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app docker compose up -d --build ``` 首次构建会安装依赖并编译内置节点、工具、Web 与 Server。启动后访问 `http://127.0.0.1:3000`；远程主机可按下方“访问与数据说明”通过 SSH 隧道访问。首次启动会初始化内置插件，并提供 `myProject` 工作目录。配置、插件和项目文件保存在 Docker 命名卷 `toonflowData` 中，挂载至容器的 `/app/data/`。卷的实际名称带有 Compose 项目前缀；停止或重建容器会保留数据，**请勿使用 `docker compose down -v`，该命令会删除数据卷**。 ```sh docker compose logs -f toonflow # 查看日志 docker compose stop # 停止服务 docker compose start # 再次启动 docker compose down # 删除容器，保留数据卷 ``` 需要增加项目目录时，可在页面的“选择服务器工作目录”弹窗中点击“新建文件夹”。弹窗也支持文件和文件夹的重命名、删除。也可在服务运行期间通过命令行创建： ```sh docker compose exec toonflow mkdir -p /app/data/workspaces/newProject ``` 备份时先停止服务，复制完成后再启动： ```sh docker compose stop docker compose cp toonflow:/app/data ./toonflowBackup docker compose start ```

--- ### 4.3 服务器安装适用于直接在 Linux 服务器上运行 Web 与 Server。以下以 Ubuntu / Debian 为例，使用项目指定的 [Bun 1.3.14](https://bun.sh/docs/installation)。

展开服务器安装步骤

安装运行环境： ```sh sudo apt-get update sudo apt-get install -y git curl unzip ffmpeg curl -fsSL https://bun.com/install | bash -s "bun-v1.3.14" export PATH="$HOME/.bun/bin:$PATH" bun --version ``` 克隆源码并启动： ```sh git clone https://github.com/HBAI-Ltd/Toonflow-app.git cd Toonflow-app bun install --frozen-lockfile # 构建内置节点、工具、Web 与 Server bun run build:server mkdir -p data/workspaces/myProject bun run start:server ``` 看到“服务启动成功”后，可在服务器本机访问 `http://127.0.0.1:3000`。上述命令以前台方式运行，按 `Ctrl+C` 停止；需要开机自启和进程托管时，可参考 [Bun 的 systemd 部署指南](https://bun.sh/guides/ecosystem/systemd)，将工作目录设为仓库目录，启动命令设为 Bun 的绝对路径加 `run start:server`，使用有权读写该目录的用户运行。

--- ### 4.4 访问与数据说明 - 当前服务使用固定端口 `3000`，业务页面与 API 没有独立登录鉴权。服务器安装时，请通过防火墙或安全组限制 `3000` 端口的访问来源；公网访问需配置带认证的反向代理。 - 个人远程使用可在自己的电脑上执行 `ssh -N -L 3000:127.0.0.1:3000 用户名@服务器地址`，保持连接后打开 `http://127.0.0.1:3000`，无需将服务器的 `3000` 端口向公网开放。 - 直接安装时，配置、插件与工作区默认保存在仓库的 `data/`；Docker 安装则保存在数据卷内的 `/app/data/`。迁移或备份时请完整保留。进入页面后选择服务器工作区内的 `myProject`，更多项目可在对应的 `workspaces/` 下创建子目录。 - 两种安装方式均包含系统 FFmpeg。模型服务的 API Key 仍需在页面内配置。 --- ### 4.5 云平台部署合作平台 [智星云](https://www.ai-galaxy.com/) 提供官方授权的 Toonflow 商用镜像，可直接使用预装环境。具体步骤见 [镜像部署图文教程](https://mp.weixin.qq.com/s/lq9X1ovQ1_TKeXMOLgicKg?scene=1)。 --- ## 5. 🎬 作品示例 https://github.com/user-attachments/assets/2d9fddac-dfdf-4640-b030-b09d7f7287e9 ### 案例信息 | 项目 | 原仓库记录 | | -------------- | --------------------------------------------------- | | 制作周期与成片 | 约 2 小时，成片约 2 分钟。 | | 视频模型 | Seedance 2.0 | | 图片模型 | GPT Image 2 | | 语言模型 | Claude Opus 4.6 | | 模型调用费用 | 约 ¥130，其中语言约 ¥10、视频约 ¥120、图片不足 ¥1。 | 费用为该案例的记录，仅供参考，实际成本取决于模型服务、生成次数与参数。演示视频为压缩后的 480p 版本。 --- ## 6. 🚀 TF-Router 官方中转平台

TF-Router 是 Toonflow 自营的官方模型中转平台，欢迎使用。其平台源码已完全开源，可自行部署审计：[HBAI-Ltd/TF-Router](https://github.com/HBAI-Ltd/TF-Router)。

致 Toonflow 社区的一封信（发于2026-06-08）

> ### 致 Toonflow 社区的一封信 > 130天。 > 不长，但足够让我们看清楚一些事情。 > 从第一行代码提交到今天，我们走过了 130天，发布了 20个版本，留下了 800+ 次Commits，写下了 213,765 行代码、640,810 个字符。 > 两次重构，一套供应商系统，一个我们引以为傲的工作流程。 > 我们以为这已经足够了。 > 但它不够。 > 有人跟我们说，想在 Toonflow 里加一个自己的模块，改半天看不懂。 > 有人跟我们说，社区太小，遇到问题找不到人。 > 有人跟我们说，商业条款让他们的项目无法落地。 > 我们听到了。 > 这 130 天里，团队成员轮流守在群里，7×24 小时回答每一个问题。没有赞助，没有补贴，全部是我们自己掏腰包支撑的人力成本。 > 不是因为我们有多少钱。 > 是因为我们相信这件事值得做。 > 所以，我们决定进行第三次重构。 > Toonflow 的每一次重构，都往更开源更开放的方向发展。 > 这一次重构，我们选择：彻底开放。 > 　 > 一、MIT License > 重构完成后我们决定把许可证从 Apache-2.0 更换为 MIT License 并去掉全部的商业附加条款。 > 它将完全的开放。没有任何的商业限制。 > 你可以用它做任何事。 > 　 > 二、全自由度插件系统 > 我们要重新设计整个插件架构。 > 故事板、全景图、时间轴、甚至——小游戏。 > 只要你想得到，就可以塞进来。 > 不是 Hack，是设计如此。 > 　 > 三、Drizzle ORM + 多数据库支持 > 升级至 Drizzle ORM。 > 本地、PostgreSQL、MySQL，按你的需要选择。 > 二开不再是噩梦。 > 　 > 四、Monorepo 全链路打通 > 插件开发、SDK 集成、发布上线，一条龙。 > 让贡献变得足够简单，简单到一个人就能做到。 > 　 > 五、新模块 > 无限画布 —— 不止于大，更在于自由 > 灵感模式 —— 为创作者而生 > 插件 Hub —— 让好插件被看见 > Skill Hub —— 让经验可以传递 > 供应商 Hub —— 生态从这里开始 > 完善的 Docker 整合 —— 部署不再是门槛 > 　 > 然后，说一件我们一直不太好意思说的事。 > 重构需要时间。这段时间里，服务器在跑，域名在续费，团队在熬夜，咖啡在涨价。 > 我们没有融资，没有广告，没有任何隐藏的商业计划。 > 但我们需要活着，才能继续把这件事做完。 > 所以我们上线了「Toonflow 官方中转平台」 TF-Router。 > 说实话，这个平台我们犹豫了很久。 > 这个平台，不是我们想做的，我们不想因为一个中转平台，让人觉得 Toonflow 开始"恰饭"了。 > 这个包袱，我们背了很久。 > 但很多用户没有开白资格，用不上 Seedance 2.0，反复问我们有没有办法。 > 我们想了很久，没办法最后只能决定搭一个，我们自己和火山签了Seedance年框合同。 > **同时，我们决定平台活动期间对Seedance 2.0平进平出，不赚一分钱差价。** > 活动结束后我们会正常收取一点点点点服务费——但现在，先让你们用上再说。 > 更重要的是——TF-Router平台源码已经全部开源打包【开源地址】。 > 你不信任我们？没关系，你可以自己看代码，自己部署，自己跑。 > 这就是我们的态度。 > 如果你愿意去试用，是对我们目前唯一能支撑下去的方式投一票信任。 > 如果你不愿意，也没关系，继续用 Toonflow，继续骂我们，继续提需求。 > 我们都在。 > 最后说一句真心话 > 我们只是一群相信「创作工具应该属于每个人」的普通人。 > Toonflow 从来不是我们的产品。 > 它是我们一起写的故事。 > 第三次重构，不是终点。 > 是我们重新出发的地方。 > 感谢每一个用过它、骂过它、给过建议的人。 > 你们才是让它走到今天的原因。 > 谢谢你们。

--- ## 7. 👨‍👩‍👧‍👦 微信交流群拉群小助手: Toonflow QR

也可以点击图标加入 Discord： [![Join our Discord](https://cdn.prod.website-files.com/6257adef93867e50d84d30e2/67d00cf7266d2c75571aebde_Example.svg)](https://discord.gg/HEjKmpNpAZ) 或点击邀请连接： [https://discord.gg/HEjKmpNpAZ](https://discord.gg/HEjKmpNpAZ) --- ## 8. 💌 联系我们 📧 邮箱：[ltlctools@outlook.com](mailto:ltlctools@outlook.com?subject=Toonflow咨询) --- ## 9. 📜 开源许可 Toonflow 采用 [MIT 许可证](./LICENSE)。第三方依赖和素材遵循各自的许可与版权声明。 [![Toonflow Star History](https://api.star-history.com/svg?repos=HBAI-Ltd/Toonflow-app&type=Date)](https://www.star-history.com/#HBAI-Ltd/Toonflow-app&Date) > **不追溯条款**：v1.0.8 发布前基于 AGPL-3.0 使用的用户，继续按 AGPL-3.0 执行，v1.0.8 ~ v1.1.8 继续按 Apache-2.0 与附加协议执行，不受本协议变更约束。 --- ## 10. 🙏 致谢 - **合作伙伴**：算能云、腾讯混元 3D、智星云。 - **项目贡献者**：感谢参与代码开发、文档完善、插件分享和问题排查的所有贡献者。 - **社区用户**：感谢持续提供反馈、分享创作成果并支持项目发展的所有用户。仰起脸笑的像满月：贡献 Codex 20x 开发算力。西安中星数字智能科技有限公司：贡献苹果证书签名。