ToonFlow的安装部署

Release ToonFlow v1.1.8 · HBAI-Ltd/Toonflow-app

  • Windows :下载 .exe 文件,双击运行安装向导即可。如遇 DLL 缺失,请安装 VC++ 运行库

第一步:ToonFlow 本地的安装部署

考虑到您本地使用的是 RTX 3050 (6GB 显存),为了减轻系统负担,强烈建议采用**Windows 桌面版(Electron)**进行部署,这种方式几乎零配置且内置了后端环境。

  1. 下载安装包 :前往 ToonFlow 的 GitHub Releases 页面,下载适用于 Windows 的最新安装包(例如 ToonFlow-Setup-x.x.x.exe)。

wget -c https://github.com/HBAI-Ltd/Toonflow-app/releases/download/v1.1.8/ToonFlow-1.1.8-win-x64-setup.exe

  1. 安装与启动:双击运行安装程序,安装完成后直接启动 ToonFlow 应用。
  2. 默认登录 :首次启动时,使用系统默认的账号密码登录(账号:admin,密码:admin123)。
  3. 前置模型配置:进入软件左下角的"设置"面板,在"模型配置"中,您需要配置文本模型(用于剧本生成)、图像模型(用于生成分镜图)以及视频模型的 API 接口地址。

参考:【AI短剧漫剧Agent工具开源】新版Toonflow 12分钟快速上手_哔哩哔哩_bilibili

第二步:ToonFlow 和 ComfyUI 的结合方式

ToonFlow 与 ComfyUI 的结合,本质上是**"ToonFlow 作为流程控制与提示词工厂,ComfyUI 作为底层视频渲染引擎"**的协作模式。

  1. 工作流逻辑 :ToonFlow 的 ScriptAgent 负责将您的小说或故事梗概转化为结构化的分镜剧本;随后 ProductionAgent 会根据分镜生成精准的图像/视频提示词。ToonFlow 会将这些提示词传递给底层的视频生成模块。
  2. API 对接与调用:在 ToonFlow 的设置中心配置好视频模型接口后,ToonFlow 会在后台通过 API 调用 ComfyUI 的服务(通常通过本地端口或 API 接口转发)。ToonFlow 负责将分镜图、提示词等参数打包发送给 ComfyUI,ComfyUI 在后台执行 Wan2.1 的推理计算,生成视频片段后返回给 ToonFlow 进行最终的剪辑与拼接。

第三步:需要什么样的工作流 JSON

在结合 Wan2.1 时,您需要准备或构建一个**"标准 Wan2.1 图生视频(Image-to-Video)工作流 JSON"**。由于您本地已经成功部署了 Wan2.1,您可以直接复用现有的工作流并进行微调:

  1. 核心节点要求 :该 JSON 工作流必须包含 Wan2.1 的核心链路节点,即:UNet加载器(加载 Wan2.1 1.3B FP8 模型) -> CLIP Text Encode(处理提示词) -> CLIP Vision Encode(处理分镜图) -> K采样器(I2V 模式) -> VAE 解码 -> 保存视频
  2. 参数适配 :由于您的显存为 6GB,在保存或修改该 JSON 工作流时,务必将 K采样器 的步数(steps)控制在 15-20 步左右,并将分辨率(Width/Height)限制在 512x512 或 720p 以下,以确保 ToonFlow 在调用 ComfyUI 进行批量分镜渲染时不会因显存溢出而中断。
  3. 获取与导入 :如果您之前已经保存了适配 3050 显卡的 Wan2.1 工作流,它默认保存在 ComfyUI\user\default\workflows 目录下(格式为 .json)。您可以直接在 ToonFlow 的视频模型配置中,指向该工作流文件的路径,或者在 ToonFlow 的无限画布中加载该 JSON 进行节点化精调。

通过这种"前台 ToonFlow 控流程 + 后台 ComfyUI 跑 Wan2.1"的组合,您就能在本地实现从文本到 AI 短剧的自动化生产闭环。