HBAI-Ltd / Toonflow-app

 |  中文 | English Toonflow AI短剧工厂 动动手指，小说秒变剧集！ AI剧本 × AI影像 × 极速生成 🔥 > 🚀 **一站式短剧工程**：从文本到角色，从分镜到视频，0门槛全流程AI化，创作效率提升10倍+！ --- 🌟 主要功能 Toonflow 是一款 AI 工具，能够利用 AI 技术将小说自动转化为剧本，并结合 AI 生成的图片和视频，实现高效的短剧创作。借助 Toonflow，可以轻松完成从文字到影像的全流程，让短剧制作变得更加智能与便捷。 • ✅ **角色生成** 自动分析原始小说文本，智能识别并生成角色设定，包括外貌、性格、身份等详细信息，为后续剧本与画面创作提供可靠基础。 • ✅ **剧本生成** 基于选定事件和章节，系统自动生成结构化剧本，涵盖对白、场景描述、剧情走向，实现从文学文本到影视剧本的高效转换。 • ✅ **分镜制作** 根据剧本内容，智能生成分镜提示词与画面设计，细化前中后景、角色动态、道具设定和场景布局，自动根据剧本生成分镜，为视频制作提供完整路线蓝图。 • ✅ **视频合成** 集成 AI 图像与视频技术，可使用 AI 生成视频片段。整合在线编辑，支持个性化调整输出，让影视创作高效协同、快捷落地。 --- 📦 应用场景 • 短视频内容创作 • 小说影视化实验 • AI 文学改编工具 • 剧本开发与快速原型 • 视频素材生成 --- 🔰 使用指南 📺 视频教程 https://www.bilibili.com/video/BV1na6wB6Ea2 **Toonflow 8 分钟快速上手 AI 视频** 👉 点击观看 📱 手机微信扫码观看 --- 🚀 安装 前置条件 在安装和使用本软件之前，请准备以下内容： • ✅ 大语言模型 AI 服务接口地址 • ✅ Sora 或豆包视频服务接口地址 • ✅ Nano Banana Pro 图片生成模型服务接口 本机安装 • 下载与安装 | 操作系统 | GitHub 下载 | 夸克网盘下载 | 说明 | | :------: | :----------------------------------------------------------- | :---------------------------------------------- | :------------- | | Windows | Release | 夸克网盘 | 官方发布安装包 | | Linux | Release | 夸克网盘 | 官方发布安装包 | | macOS | Release | 夸克网盘 | 官方发布安装包 | > 目前仅支持 Windows 版本，其他系统将陆续开放。 > 因 Gitee OS 环境限制及 Release 文件上传大小限制，暂不提供 Gitee Release 下载地址。 • 启动服务 安装完成后，启动程序即可开始使用本服务。 > ⚠️ **首次登录** > 账号： > 密码： Docker 部署 前置条件 • 已安装 Docker（版本 20.10+） • 已安装 Docker Compose（版本 2.0+） 方式一：在线部署（推荐） 从 GitHub / Gitee 自动拉取源码并构建镜像： **支持的构建参数：** | 参数 | 说明 | 默认值 | 示例 | | -------- | ------------ | -------- | ------------------ | | | 代码仓库源 | | / | | | 指定版本标签 | 最新 tag | | | | 指定分支 | 默认分支 | / | **版本选择优先级**：指定 TAG > 指定 BRANCH > 自动获取最新 tag > 默认分支 **指定参数示例：** 方式二：本地构建 使用本地已有的源码直接构建，适合开发者或已克隆仓库的用户： 服务端口说明 | 端口 | 用途 | 在线部署映射 | 本地构建映射 | | ------- | -------------- | ------------- | ------------- | | | Nginx 前端页面 | 随机端口 | | | | 后端 API 服务 | | | 数据持久化 默认日志目录会挂载到宿主机 目录。如需持久化上传文件或数据库，可在 中添加 volumes： 常用操作命令 > ⚠️ **首次登录** > 账号： > 密码： 云端部署 一、服务器环境要求 • **系统**：Ubuntu 20.04+ / CentOS 7+ • **Node.js**：24.x（推荐，最低 23.11.1+） • **内存**：2GB+ 二、服务器部署 • 安装环境 • 部署项目 **从 GitHub 克隆：** **从 Gitee 克隆（国内推荐）：** • 配置 PM2 创建 文件： **环境变量说明：** | 变量 | 说明 | | ---------- | ---------------------------------- | | | 运行环境， 表示生产环境 | | | 服务监听端口 | | | 文件存储访问地址，用于静态资源访问 | --- • 启动服务 • 常用命令 > ⚠️ **首次登录** > 账号： > 密码： • 部署前端网站 如需单独部署或定制前端界面，请参考前端仓库： • **GitHub**：Toonflow-web • **Gitee**：Toonflow-web > 💡 **说明**：本仓库已内置编译好的前端资源，普通用户无需单独部署前端。前端仓库仅供需要二次开发的开发者使用。 --- 🔧 开发流程指南 > [!CAUTION] > 🚧 **PR 提交规范** 🚧 > > ⛔ 分支不接受任何 PR ｜ ✅ 请将 PR 提交到 分支 开发环境准备 • **Node.js**：版本要求 23.11.1 及以上 • **Yarn**：推荐作为项目包管理器 快速启动项目 • **克隆项目** **从 GitHub 克隆：** **从 Gitee 克隆（国内推荐）：** • **安装依赖** 请先在项目根目录下执行以下命令以安装依赖项： • **启动开发环境** 本项目包含 **后端 API 服务** 和 **前端页面** 两部分，请根据需要选择启动方式： • **方式一：仅启动后端服务（开发调试用）** > ⚠️ 此命令仅启动后端 API 服务（端口 60000），**不包含前端页面**。直接访问 只能调用 API 接口，无法看到完整的网页界面。如需同时使用前端页面，请配合前端项目单独启动，或使用下方的 GUI 模式。 • **方式二：启动 Electron 桌面客户端（推荐完整体验）** > 此命令会同时启动后端服务和 Electron 桌面窗口，自带内置前端页面，开箱即用，无需额外配置。适合想要完整体验所有功能的开发者。 **两种模式对比：** | 命令 | 启动内容 | 前端页面 | 适用场景 | | -------------- | ------------------------ | -------- | -------------------------------- | | | 仅后端 API（端口 60000） | ❌ 无 | 后端开发调试、配合前端项目联调 | | | 后端 + Electron 桌面端 | ✅ 内置 | 完整功能体验、桌面客户端开发调试 | • **项目打包** • 编译并生成 TypeScript 文件： • 打包为 Windows 平台可执行程序： • 打包为 Mac 平台可执行程序： • 打包为 Linux 平台可执行程序： • **代码质量检查** • 进行全局语法和规范检查： • **AI 调试面板（可选）** 启动 AI SDK 的可视化调试工具，方便调试 AI 调用： 前端开发 如需修改前端界面，请前往前端仓库进行开发： • **GitHub**：Toonflow-web • **Gitee**：Toonflow-web 前端构建后，将 目录内容复制到本项目的 目录即可集成。 项目结构 --- 🔗 相关仓库 | 仓库 | 说明 | GitHub | Gitee | | ---------------- | ---------------------------------- | -------------------------------------------------- | ------------------------------------------------ | | **Toonflow-app** | 完整客户端（本仓库，推荐普通用户） | GitHub | Gitee | | **Toonflow-web** | 前端源代码（适合前端开发者） | GitHub | Gitee | > 💡 **提示**：如果您只是想使用 Toonflow，直接下载本仓库的客户端即可。前端仓库仅供需要二次开发或定制前端界面的开发者使用。 --- 📝 开发计划 我们正持续优化产品，以下为近期开发重点： • 核心功能升级 • 基于 AI 智能润色视频提示词，自动拆解生成分镜脚本，支持多镜头智能融合与平滑过渡 • 扩展小说以外的剧本、漫画脚本、游戏对话文本等多种格式的智能解析 • 生产流程优化 • 强化长篇内容中角色的服装、化妆、道具一致性，支持多剧集关联记忆和着装自动生成 • 支持多章节同时处理，后台任务管理，进度实时监控和中断恢复 • 视觉生成增强 • 内置多种视觉风格包，支持一键风格转换和用户自定义风格保存 • 分析剧情情绪曲线，自动建议高潮点和节奏变化，优化分镜安排生产流程优化 --- 👨‍👩‍👧‍👦 微信交流群 ~~交流群 1~~ ~~交流群 2~~ ~~交流群 3~~ ~~交流群 4~~ ~~交流群 5~~ ~~交流群 6~~ ~~交流群 7~~ ~~交流群 8~~ ~~交流群 9~~ ~~交流群 10~~ ~~交流群 11~~ ~~交流群 12~~ ~~交流群 13~~ 拉群小助手: --- 💌 联系我们 📧 邮箱：ltlctools@outlook.com --- 📜 许可证 Toonflow 基于 AGPL-3.0 协议开源发布，许可证详情：https://www.gnu.org/licenses/agpl-3.0.html 您可以在遵循 AGPL-3.0 相关条款与条件的情况下，将 Toonflow 用于包括商业目的在内的各类用途。 如需获得免于 AGPL-3.0 限制的专有商业许可，请通过邮箱与我们联系。 --- ⭐️ 星标历史 --- 🙏 致谢 感谢以下开源项目为 Toonflow 提供强大支持： • Express - 快速、开放、极简的 Node.js Web 框架 • AI - 面向 TypeScript 的 AI 工具包 • Better-SQLite3 - 高性能 SQLite3 绑定库 • Sharp - 高性能 Node.js 图像处理库 • Axios - 基于 Promise 的 HTTP 客户端 • Zod - TypeScript 优先的模式验证库 • Aigne - LLM API 统一管理与接入中间件 • Electron - 跨平台桌面应用开发框架 感谢以下组织/单位/个人为 Toonflow 提供支持： 算能云 提供算力赞助 [官网] 完整的第三方依赖清单请查阅