Toonflow

项目简介

Toonflow 是面向短剧、漫剧和短视频创作者的开源 AI 创作工具，把剧本、角色场景资产、图像与视频生成整合到无限画布中，并可通过 AI Agent、MCP 与插件扩展工作流。项目支持本地部署和自由接入模型。

核心功能

• 剧本与分镜创作：在文本节点中整理故事、人物设定和镜头描述，并使用语言模型辅助创作与审阅。
• 角色与场景资产管理：导入参考图片，或通过图片生成节点制作角色、场景和分镜图。
• 视频镜头生成：连接文本与图片参考，选择视频模型和生成模式，按镜头生成视频片段。
• 无限画布：在同一画布中组织剧本、角色、场景与视频片段。
• 开放扩展：通过 MCP 连接外部工具与服务，通过插件市场扩展节点、工具与创作能力，并开放提示词、工具和 A2A 以支持自定义 Agent 行为及外部协作。
• 本地部署与模型接入：支持桌面、Android、Docker 与服务器部署，可配置第三方 API 或接入本地 ComfyUI 和 LLM。

适用场景

• 制作 AI 短剧、漫剧与短视频：完成剧本与分镜、角色和场景素材制作、视频镜头生成以及素材预览整理。
• 需要本地保存项目与素材的创作团队：项目与素材可保存在自己的设备或服务器。
• 希望接入自有模型或 ComfyUI 工作流的创作者：可配置语言模型与媒体模型服务，并通过自定义供应商适配接入已有 ComfyUI 工作流。
• 需要多语言界面的团队：支持 21 种界面语言。

快速开始

• 从发布页下载 Windows、macOS 或 Android ARM64 客户端安装使用。
• Docker 部署时，先安装 Git、Docker Engine 和 Docker Compose，再克隆源码并在仓库根目录执行 docker compose up -d --build。
• 服务器安装可使用项目指定的 Bun 1.3.14，安装依赖并构建后运行启动命令。

部署与要求

• Windows 安装器会自动检测并安装 WebView2；若安装后打开闪退，需手动安装 WebView2 运行时。
• macOS 版面向 Apple Silicon，将 Toonflow 拖入“应用程序”后直接打开；如遇系统安全提示，可按官方说明处理。
• Android 版仅支持 ARM64 设备，下载 toonflow-版本号-android-arm64.apk 安装；手机内置本地 Bun 后端，也可连接已开启共享的电脑或远程后端。
• Docker 部署需 Git、Docker Engine 和 Docker Compose，基于 Bun 1.3.14 构建，镜像内包含 FFmpeg；配置、插件和项目文件保存在 Docker 命名卷 toonflowData 中，挂载至容器的 /app/data/。
• 服务器安装以 Ubuntu/Debian 为例，需要 Git、curl、unzip、ffmpeg 和 Bun 1.3.14；服务使用固定端口 3000，业务页面与 API 没有独立登录鉴权，需通过防火墙或安全组限制访问来源，公网访问需配置带认证的反向代理。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。
• 第三方模型服务的 API 调用可能产生费用；使用本地模型或 ComfyUI 时，需要自行准备运行环境与算力。
• 服务器安装时业务页面与 API 没有独立登录鉴权。
• 公网访问需配置带认证的反向代理。