Toonflow App AI Agent

<img src="https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=6,11,20&height=200&section=header&text=Toonflow&fontSize=90&fontColor=ffffff&animation=fadeIn&fontAlignY=50" alt="Toonflow" 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> &nbsp;|&nbsp; <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> &nbsp;|&nbsp; <a href="https://atomgit.com/HBAI-Ltd/Toonflow-app"> <img src="./docs/images/atomgitLogo.svg" alt="AtomGit" height="20" /> </a> </p> <p align="center"> <strong>简体中文</strong> | <a href="./docs/readme/readmeZhTw.md">繁體中文</a> | <a href="./docs/readme/readmeEn.md">English</a> | <a href="./docs/readme/readmeJa.md">日本語</a> | <a href="./docs/readme/readmeRu.md">Русский</a> | <a href="./docs/readme/readmeVi.md">Tiếng Việt</a> | <a href="./docs/readme/readmeTh.md">ไทย</a> <br /> <a href="./docs/readme/readmeKo.md">한국어</a> | <a href="./docs/readme/readmeHi.md">हिन्दी</a> | <a href="./docs/readme/readmeId.md">Bahasa Indonesia</a> | <a href="./docs/readme/readmeMs.md">Bahasa Melayu</a> | <a href="./docs/readme/readmeFil.md">Filipino</a> | <a href="./docs/readme/readmeBn.md">বাংলা</a> | <a href="./docs/readme/readmeUr.md">اردو</a> <br /> <a href="./docs/readme/readmeTa.md">தமிழ்</a> | <a href="./docs/readme/readmeTe.md">తెలుగు</a> | <a href="./docs/readme/readmeMr.md">मराठी</a> | <a href="./docs/readme/readmePa.md">ਪੰਜਾਬੀ</a> | <a href="./docs/readme/readmeAr.md">العربية</a> | <a href="./docs/readme/readmeFa.md">فارسی</a> | <a href="./docs/readme/readmeTr.md">Türkçe</a> </p>

🌐 支持 21 种界面语言 · 查看支持的语言

<div align="center"> <p align="center"> <img src="./docs/images/logo.png" alt="Toonflow Logo" width="120" height="120" /> </p> <h1 align="center">Toonflow｜开源 AI 短剧、漫剧与视频创作平台</h1> <a href="https://git.io/typing-svg"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://readme-typing-svg.demolab.com?font=Fira+Code&size=40&duration=3000&pause=1000&color=FFFFFF&center=true&vCenter=true&width=600&lines=Toonflow;AI%E7%9F%AD%E5%89%A7%E5%B7%A5%E5%8E%82;%E8%AE%A9%E7%81%B5%E6%84%9F%E6%88%90%E4%B8%BA%E7%9C%8B%E5%BE%97%E8%A7%81%E7%9A%84%E6%95%85%E4%BA%8B" /> <img 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;%E8%AE%A9%E7%81%B5%E6%84%9F%E6%88%90%E4%B8%BA%E7%9C%8B%E5%BE%97%E8%A7%81%E7%9A%84%E6%95%85%E4%BA%8B" alt="Toonflow · AI 短剧工厂 · 让灵感成为看得见的故事" width="600" /> </picture> </a> <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="./LICENSE"> <img src="https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge" alt="MIT License Badge" /> </a> <a href="https://github.com/HBAI-Ltd/Toonflow-app/releases"> <img src="https://img.shields.io/github/v/release/HBAI-Ltd/Toonflow-app?style=for-the-badge" alt="Release" /> </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" height="28" />&nbsp; <img src="https://img.shields.io/badge/Bun-1.4.3-14151A?style=for-the-badge&logo=bun&logoColor=white" alt="Bun 1.4.3" />&nbsp; <img src="https://img.shields.io/badge/Vue-3-42B883?style=for-the-badge&logo=vuedotjs&logoColor=white" alt="Vue 3" />&nbsp; <img src="https://img.shields.io/badge/Desktop-Electrobun-8257E5?style=for-the-badge" alt="Electrobun" /> </p> <p align="center"> <a href="https://trendshift.io/repositories/24197?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-24197#achievements" target="_blank" rel="noopener noreferrer"> <img src="https://trendshift.io/api/badge/trendshift/repositories/24197/daily?language=HTML" alt="HBAI-Ltd/Toonflow-app | Trendshift HTML Repository Of The Day" width="250" height="55" /> </a> <a href="https://trendshift.io/repositories/24197?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-24197#achievements" target="_blank" rel="noopener noreferrer"> <img src="https://trendshift.io/api/badge/trendshift/repositories/24197/daily?language=Vue" alt="HBAI-Ltd/Toonflow-app | Trendshift Vue Repository Of The Day" width="250" height="55" /> </a> <a href="https://trendshift.io/repositories/24197?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-24197#achievements" target="_blank" rel="noopener noreferrer"> <img src="https://trendshift.io/api/badge/trendshift/repositories/24197/daily?language=TypeScript" alt="HBAI-Ltd/Toonflow-app | Trendshift TypeScript Repository Of The Day" width="250" height="55" /> </a> </p> <p align="center"> <a href="https://trendshift.io/repositories/24197?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-24197#achievements" target="_blank" rel="noopener noreferrer"> <img src="https://trendshift.io/api/badge/trendshift/repositories/24197/weekly?language=Vue" alt="HBAI-Ltd/Toonflow-app | Trendshift Vue Repository Of The Week" width="250" height="55" /> </a> <a href="https://trendshift.io/repositories/24197?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-24197#achievements" target="_blank" rel="noopener noreferrer"> <img src="https://trendshift.io/api/badge/trendshift/repositories/24197/weekly?language=HTML" alt="HBAI-Ltd/Toonflow-app | Trendshift HTML Repository Of The Week" width="250" height="55" /> </a> <a href="https://trendshift.io/repositories/24197?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-24197#achievements" target="_blank" rel="noopener noreferrer"> <img src="https://trendshift.io/api/badge/trendshift/repositories/24197/weekly?language=TypeScript" alt="HBAI-Ltd/Toonflow-app | Trendshift TypeScript Repository Of The Week" width="250" height="55" /> </a> </p> <p align="center"> <a href="https://trendshift.io/repositories/24197?utm_source=trendshift-badge&amp;utm_medium=badge&amp;utm_campaign=badge-trendshift-24197#achievements" target="_blank" rel="noopener noreferrer"> <img src="https://trendshift.io/api/badge/trendshift/repositories/24197/monthly?language=HTML" alt="HBAI-Ltd/Toonflow-app | Trendshift HTML Repository Of The Month" width="250" height="55" /> </a> </p>

Toonflow 是面向短剧、漫剧和短视频创作者的开源 AI 创作工具。通过无限画布编写剧本与分镜、管理角色和场景素材、生成图片与视频。支持本地部署、自由接入模型，并可通过 AI Agent、MCP 与插件扩展创作流程。

</div> <div align="center"> <table> <tr> <td width="50%" align="center"> <a href="./docs/images/gStar.png"> <img src="./docs/images/gStar.png" alt="Toonflow AtomGit G-Star 认证证书 No.540" width="100%" /> </a> </td> <td width="50%" align="center"> <a href="./docs/images/gvp.jpg"> <img src="./docs/images/gvp.jpg" alt="Toonflow Gitee GVP 认证证书" width="100%" /> </a> </td> </tr> </table> </div> <p align="center"> <a href="https://github.com/HBAI-Ltd/Toonflow-app/releases">下载客户端</a> · <a href="https://qcn7xdsqgc4z.feishu.cn/docx/RXFqdgR2Xo0dXZxGfd0cZCGgnwf">使用教程</a> · <a href="https://api.toonflow.net/console/plugIn">插件市场</a> · <a href="https://qcn7xdsqgc4z.feishu.cn/docx/KNBNd9naqolsy6xjAOCcEAkqnRd">开发者文档</a> · <a href="https://api.toonflow.net/">官方模型平台</a> </p>

---

1. 💛 赞助与支持

感谢以下合作伙伴对 Toonflow 开源项目的支持。

<table> <tr> <td width="50%" valign="top"> <a href="https://metaso.cn/minimax-h3/?s=toon"><img src="./docs/images/sponsors/metaso.svg" alt="秘塔" height="28" valign="middle" /> <strong>秘塔</strong></a> <br /> _{秘塔科技提供高性价比的 MiniMax H3 视频生成服务：768P 仅 0.09 元/秒，2K 仅 0.15 元/秒。支持原生 2K、音画同步，API 兼容 OpenAI 协议，同时支持 ComfyUI、无限画布，无需自行部署 GPU。} <br /><br /> _{🎁 通过 <a href="https://metaso.cn/minimax-h3/?s=toon">专属链接注册</a>，即可领取赠送额度及专属优惠。商务对接可加微信：metasota12} </td> <td width="50%" valign="top"> <a href="https://go.apimart.ai/gh-toonflow-app"><img src="./docs/images/sponsors/apiMart.jpg" alt="APIMart" height="28" valign="middle" /> <strong>APIMart</strong></a> <br /> _{感谢 APIMart 赞助了本项目！APIMart 是专注 AI 图片/视频生成的低价 API 平台，GPT-Image-2 低至 $0.006/张，1 美元可出图 160+ 张。图片、视频一套异步 API 通吃，提交任务拿 ID、回调取结果，跑批万张不超时、换模型不改代码。按量付费、无月费，通过此<a href="https://go.apimart.ai/gh-toonflow-app">注册链接</a>注册即可开用。} </td> </tr> <tr> <td width="50%" valign="top"> <a href="https://www.compshare.cn/video-studio?ytag=GPU_YY_YX_git_toonflow"><img src="./docs/images/sponsors/compShare.png" alt="优云智算" height="28" valign="middle" /> <strong>优云智算</strong></a> <br /> _{优云智算提供高性价比 H3 视频生成服务，涵盖文生视频、首尾帧及全能参考。支持最长 30s 视频、原生 2K 画质，768P 仅 0.08 元/秒。支持 API 调用、企业高并发、自助开票。} <br /><br /> _{🎁 通过 <a href="https://www.compshare.cn/video-studio?ytag=GPU_YY_YX_git_toonflow">专属链接注册</a>，可得免费 5 元平台体验金！} </td> <td width="50%" valign="top"></td> </tr> </table> <details> <summary><strong>👉成为赞助商👈</strong></summary> <p align="center"> <img src="./docs/images/businessQr.png" alt="商务合作微信二维码" width="200" /> </p> <p align="center">_{此联系方式仅用于商务合作接洽，不提供问题答疑。使用问题欢迎在交流群交流，需求与 BUG 可通过反馈表提交。感谢理解。}</p> </details>

---

2. 🌟 亮点

Toonflow 是面向短剧、漫剧与短视频制作的开源 AI 创作平台，把剧本、资产与视频片段整合进同一张无限画布。

能力	说明
🏠 本地部署	项目与素材保存在自己的设备或服务器，支持桌面、Android、Docker 与服务器部署。
🖼️ 无限画布	在同一画布中组织剧本、角色、场景与视频片段。
🔌 MCP	通过 MCP 连接外部工具与服务。
🧩 插件市场	通过插件市场扩展节点、工具与创作能力。
🤖 开放 Agent	开放提示词、工具和 A2A，支持自定义 Agent 行为及外部协作。
🔧 自由接入模型	配置第三方 API，也可接入本地 ComfyUI 和 LLM。
🌐 多语言支持	支持 21 种界面语言。

如何用 Toonflow 制作 AI 短剧与漫剧

1. 编写剧本与分镜：在文本节点中整理故事、人物设定和镜头描述，使用语言模型辅助创作，再审阅与修改内容。
2. 准备角色与场景素材：导入参考图片，或通过图片生成节点制作角色、场景和分镜图。
3. 生成视频镜头：连接文本与图片参考，选择视频模型和生成模式，按镜头生成视频片段。
4. 预览、整理与下载：在无限画布中预览和组织图片、视频片段，下载素材后按创作需求继续处理。

支持的参考素材、视频时长、分辨率和音频能力取决于所选模型与供应商。

常见问题

Toonflow 可以用于哪些 AI 短剧和漫剧制作环节？

Toonflow 提供文本、图片与视频生成节点，可用于剧本与分镜创作、角色和场景素材制作、视频镜头生成，以及素材的预览与整理。创作者需要审阅和调整内容，具体生成能力取决于配置的模型。

Toonflow 免费吗？模型调用需要付费吗？

Toonflow 采用 MIT 开源许可，可自行部署。第三方模型服务的 API 调用可能收费；使用本地模型或 ComfyUI 时，需要自行准备相应的运行环境与算力。作品示例中的制作费用仅代表该案例，不是固定价格。

可以接入自己的模型和 ComfyUI 工作流吗？

可以配置语言模型与媒体模型服务，也可通过自定义供应商适配接入已有的 ComfyUI 工作流。具体接入方式取决于服务 API、模型与工作流，可参考使用教程与开发者文档。

<a id="languages"></a>

多语言支持

支持的语言：简体中文、繁體中文、English、日本語、Русский、Tiếng Việt、ไทย、한국어、हिन्दी、Bahasa Indonesia、Bahasa Melayu、Filipino、বাংলা、اردو、தமிழ்、తెలుగు、मराठी、ਪੰਜਾਬੀ、العربية、فارسی、Türkçe。

---

3. 📸 截图

<div align="center">

<a href="./docs/images/screenshots/projectHome.png"><img src="./docs/images/screenshots/projectHome.png" alt="Toonflow 项目首页与灵感创作" width="80%" /></a><br />_{项目首页与灵感创作}

<a href="./docs/images/screenshots/quickStart.png"><img src="./docs/images/screenshots/quickStart.png" alt="Toonflow 首次启动与快速配置" width="80%" /></a><br />_{首次启动与快速配置}

<a href="./docs/images/screenshots/canvasDark.png"><img src="./docs/images/screenshots/canvasDark.png" alt="Toonflow 深色主题画布与 AI 助手" width="80%" /></a><br />_{创作画布 · 深色主题}

<a href="./docs/images/screenshots/canvasLight.png"><img src="./docs/images/screenshots/canvasLight.png" alt="Toonflow 浅色主题画布与 AI 助手" width="80%" /></a><br />_{创作画布 · 浅色主题}

<a href="./docs/images/screenshots/assetCanvas.png"><img src="./docs/images/screenshots/assetCanvas.png" alt="Toonflow 角色、场景与道具资产画布" width="80%" /></a><br />_{角色、场景与道具资产}

<a href="./docs/images/screenshots/directorStudio.png"><img src="./docs/images/screenshots/directorStudio.png" alt="Toonflow 3D 导演台与镜头预演" width="80%" /></a><br />_{3D 导演台与镜头预演}

<a href="./docs/images/screenshots/characterImageGeneration.png"><img src="./docs/images/screenshots/characterImageGeneration.png" alt="Toonflow 角色三视图图片生成" width="80%" /></a><br />_{角色三视图与图片生成}

<a href="./docs/images/screenshots/videoGeneration.png"><img src="./docs/images/screenshots/videoGeneration.png" alt="Toonflow 多参考素材视频生成" width="80%" /></a><br />_{多参考素材视频生成}

<a href="./docs/images/screenshots/nodeMenu.png"><img src="./docs/images/screenshots/nodeMenu.png" alt="Toonflow 节点菜单与分组操作" width="80%" /></a><br />_{节点菜单与分组操作}

<a href="./docs/images/screenshots/pluginMarket.png"><img src="./docs/images/screenshots/pluginMarket.png" alt="Toonflow 插件市场" width="80%" /></a><br />_插件市场

</div>

---

4. 🚀 下载并安装

4.1 客户端安装

操作系统	GitHub
Windows x64	EXE 安装包
Windows ARM64	EXE 安装包
macOS Apple Silicon（ARM64，macOS 14 及以上）	DMG 安装包
macOS Intel（x64，macOS 14 及以上）	DMG 安装包
Linux x64（Debian / Ubuntu）	DEB 安装包
Linux ARM64（Debian / Ubuntu）	DEB 安装包
Android ARM64	APK 下载

Android 版仅支持 ARM64 设备，下载发布页中的 toonflow-版本号-android-arm64.apk 安装。手机内置本地 Bun 后端，可独立运行；也可从首页「设备互联」扫码或手动连接已开启共享的电脑或远程后端（支持局域网与公网）。

Windows 安装器会自动检测并安装 WebView2；如果安装后打开闪退，请前往 WebView2 下载页面 手动安装运行时。

Windows 的 Intel / AMD 电脑选择 toonflow-版本号-Setup.exe，ARM64 电脑选择 toonflow-版本号-win-arm64-Setup.exe。ARM64 需要 .NET Framework 4.8.1，较新的 Windows 11 已内置。

Linux 选择对应架构的 toonflow-版本号-linux-x64.deb 或 toonflow-版本号-linux-arm64.deb，在下载目录执行 sudo apt install ./安装包文件名.deb，安装后从应用菜单打开。安装需要联网；apt 会准备 FFmpeg、curl、unzip、CA 证书等依赖，安装脚本在解包应用前下载固定版本的 Bun 并校验大小与 SHA-256，配置阶段再安装运行时。下载或校验失败会在解包前中止安装。

macOS 两种架构均使用统一的 Electrobun SDK，最低支持 macOS 14。选择对应架构的 toonflow-版本号-macos-arm64.dmg 或 toonflow-版本号-macos-x64.dmg，打开后将 toonflow.app 拖入“应用程序”，再从“应用程序”打开 Toonflow。正式发布流程使用 Developer ID Application 签署应用与 DMG，并完成 Apple 公证。旧版 Intel Mac 客户端首次迁移时须下载完整 DMG 覆盖安装，不能通过旧版增量更新直接迁移；安装前退出应用并备份原数据目录。

macOS 若遇到系统安全提示，请按以下顺序处理。

<details> <summary><strong>macOS 无法安装或打开时的处理方法</strong></summary>

1. 在“隐私与安全性”中允许 Toonflow

如果提示“无法验证开发者”或“Apple 无法检查 App 是否包含恶意软件”，先尝试打开 Toonflow，再前往“系统设置 → 隐私与安全性”，找到 Toonflow 被阻止的提示，点击“仍要打开”，并按提示确认。详见 Apple 官方说明。

2. 仍因系统隔离限制无法打开时，再尝试移除隔离属性

确认应用来自官方发布页，并已放入“应用程序”后，在终端执行以下命令，再重新打开。应用名称或安装位置不同时，请调整路径。

sudo xattr -rd com.apple.quarantine /Applications/toonflow.app

3. 最后手段：临时允许任何来源的 App

前两种方法均无效且确认应用来源可信时，可尝试在终端执行：

sudo spctl --master-disable

随后打开“系统设置 → 隐私与安全性”，在“安全性”中的“允许从以下位置下载的 App”选择“任何来源”（如果系统提供该选项），并按提示确认。不同 macOS 版本的选项与命令支持可能不同。

此操作会放宽所有 App 的安全限制。完成后建议将允许来源恢复为“App Store 和被认可的开发者”。

</details>

更多操作说明请查看 使用教程。

---

4.2 Docker 安装

先安装 Git、Docker Engine 和 Docker Compose；Windows / macOS 可使用 Docker Desktop 的 Linux 容器模式。仓库提供 Dockerfile、Compose 配置 和 构建排除规则，基于 Bun 1.4.3 构建，镜像内包含 FFmpeg。

<details> <summary><strong>展开 Docker 安装步骤</strong></summary>

克隆源码后，在仓库根目录执行：

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，该命令会删除数据卷。

docker compose logs -f toonflow  # 查看日志
docker compose stop             # 停止服务
docker compose start            # 再次启动
docker compose down             # 删除容器，保留数据卷

需要增加项目目录时，可在页面的“选择服务器工作目录”弹窗中点击“新建文件夹”。弹窗也支持文件和文件夹的重命名、删除。也可在服务运行期间通过命令行创建：

docker compose exec toonflow mkdir -p /app/data/workspaces/newProject

备份时先停止服务，复制完成后再启动：

docker compose stop
docker compose cp toonflow:/app/data ./toonflowBackup
docker compose start

</details>

---

4.3 服务器安装

适用于直接在 Linux 服务器上运行 Web 与 Server。以下以 Ubuntu / Debian 为例，使用项目指定的 Bun 1.4.3。

<details> <summary><strong>展开服务器安装步骤</strong></summary>

安装运行环境：

sudo apt-get update
sudo apt-get install -y git curl unzip ffmpeg
curl -fsSL https://bun.com/install | bash -s "bun-v1.4.3"
export PATH="$HOME/.bun/bin:$PATH"
bun --version

克隆源码并启动：

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 部署指南，将工作目录设为仓库目录，启动命令设为 Bun 的绝对路径加 run start:server，使用有权读写该目录的用户运行。

</details>

---

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 云平台部署

合作平台 智星云 提供官方授权的 Toonflow 商用镜像，可直接使用预装环境。具体步骤见 镜像部署图文教程。

---

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. 👨‍👩‍👧‍👦 微信交流群

拉群小助手:

<img src="./docs/images/qr.png" alt="Toonflow QR" height="400"/>

也可以点击图标加入 Discord：

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

---

7. 💌 联系我们

📧 邮箱：ltlctools@outlook.com

---

8. 📜 开源许可

Toonflow 采用 MIT 许可证。第三方依赖和素材遵循各自的许可与版权声明。

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

---

9. 🙏 致谢

• 合作伙伴：算能云、腾讯混元 3D、智星云。
• 项目贡献者：感谢参与代码开发、文档完善、插件分享和问题排查的所有贡献者。
• 社区用户：感谢持续提供反馈、分享创作成果并支持项目发展的所有用户。

仰起脸笑的像满月：贡献 Codex 20x 开发算力。 西安中星数字智能科技有限公司：贡献苹果证书签名。

<p align="center">_{Free code signing provided by <a href="https://signpath.io/">SignPath.io</a>, certificate by <a href="https://signpath.org/">SignPath Foundation</a>.}</p> <div align="center">

Copyright © 2026 北京爱阿科技有限公司

</div> <img src="https://capsule-render.vercel.app/api?type=waving&color=gradient&customColorList=6,11,20&height=90&section=footer" alt="Toonflow 页脚" width="100%" />