夜雨聆风学习资料网

ARTICLE · 995695

14.9K Star!开源 AI 短剧工具 Toonflow:把小说一步步变成动画短剧!

14.9K Star!开源 AI 短剧工具 Toonflow:把小说一步步变成动画短剧!

AI 视频生成工具越来越多,生成一张图片或一段视频已经不算难。真正麻烦的,是把一部长篇小说稳定地改编成连续的短剧。

小说篇幅长、人物关系复杂,前后情节容易衔接不畅。单独生成每个镜头时,角色外貌、画面风格和故事节奏也容易发生变化。

Toonflow 是一个专注于小说和原著改编的开源 AI 短剧创作工具。它将章节分析、AI 编剧、角色设定、分镜制作、素材生成和视频导出整合到一个桌面工作台中,让创作者可以围绕同一个项目持续修改,逐步将小说、原著或剧本转化为动画短剧。

Toonflow采用 Electron 构建桌面客户端,支持 Windows、macOS 和 Linux,也可以通过 Docker 或云服务器运行。

目前在 GitHub 上已荣获14.9K Star !

仓库显示项目采用 Apache-2.0 许可证。仓库提供了应用代码、构建脚本、桌面端配置、后端服务和内置前端资源,开发者可以据此进行研究和二次开发。

核心功能
章节事件图谱与 AI 编剧

导入小说后,Toonflow 会提取章节中的人物、事件和故事关系,并将其结构化保存。ScriptAgent 再基于这些内容生成故事骨架、改编策略和结构化剧本。

长篇小说直接交给模型时,前文信息很容易被后文覆盖。事件图谱让后续改编可以重新调用章节中的关键内容,减少人物关系和情节信息的遗漏。

无限画布与节点化制作

ProductionAgent 会在无限画布中组织剧本、角色、分镜、图片、视频和其他素材。创作者可以自由排列节点,回看前面的结果,也可以只调整某一个分镜后重新生成。

这种界面更接近一张可以持续修改的制作板。故事、素材和视频片段都能放在同一个项目里,多个镜头也可以并行处理。

三层 Agent 与本地记忆

Toonflow 将 Agent 分为决策层、执行层和监督层。决策层负责拆分任务,执行层负责生成内容,监督层负责检查结果并提出修订方向。

项目还使用本地 ONNX 向量检索保存 Agent 记忆,支持短期消息、长期摘要和语义召回。多次修改同一个项目时,系统可以继续参考此前的创作信息。

可配置模型与 Skill 文件

Toonflow 通过 Vercel AI SDK 接入多种文本模型,也支持配置图像和视频服务的接口地址。用户可以在设置中心编写供应商 TypeScript 逻辑,调整模型调用方式。

▲ Toonflow 支持在设置中心统一管理模型供应商,并配置不同类型的文本、图像、视频和音频模型

ScriptAgent 和 ProductionAgent 的核心提示词被放在 Markdown Skill 文件中。开发者可以直接修改这些文件,调整剧本风格、镜头描述和生产流程,不必频繁修改主程序代码。

技术架构

Toonflow 的技术架构可以简化为下面几个核心部分

Toonflow 的技术特点集中在 Agent 分工、本地记忆和可配置模型接入。用户可以通过 ScriptAgent 完成小说和剧本改编,再由 ProductionAgent 组织分镜和素材。SQLite 负责保存项目数据,ONNX 向量检索帮助 Agent 找回历史创作内容,Skill 文件则方便开发者调整提示词和创作流程。

快速上手

普通用户可以从 GitHub Release 下载 Windows、macOS 或 Linux 安装包。

开发者可以在本地运行项目。

git clone https://github.com/HBAI-Ltd/Toonflow-app.gitcd Toonflow-appyarn installyarn dev:gui

yarn dev 只启动后端 API,想直接体验完整桌面界面,应使用 yarn dev:gui。使用 AI 生成功能前,还需要准备文本、图像和视频模型的服务接口。

项目也提供云服务器部署方式,README 建议使用 Ubuntu 20.04 或更高版本、Node.js 24 和 PM2,默认服务端口为 10588。

GitHub:https://github.com/HBAI-Ltd/Toonflow-app

欢迎扫码加入社群

一起交流AI前沿技术!

小编免费共享AI开源项目知识库,

实现大家的AI资讯自由!

直接扫码或点击链接即可查看!

AI开源项目知识库:https://qyxznlkmwx.feishu.cn/wiki/BwWIwsCOuiMWGmkUzNHcKLvPnPh

点击下方名片「关注我们」第一时间收到推送

相关学习资料