hi ，社区的朋友们，很长时间没有更新我们最新的情况和动态了，这次我们带来了全新的模型和框架。增加了更多的模型对接，此次更新我们带来了更多的惊喜给各位开发者，同时我们承诺最少 3 个月的大版本更新，1-2 个月的小版本迭代更新，此次框架和之前有所不同。为帮助后面开源中融入更多的 agent 的理念重新打造

https://github.com/chatfire-AI/huobao-drama?tab=readme-ov-file#-项目简介

:open_book: 项目简介 Huobao Drama 是一个基于 AI 的短剧自动化生产平台，实现从剧本生成、角色设计、分镜制作到视频合成的全流程自动化。

火宝短剧商业版地址：火宝短剧商业版 火宝小说生成：火宝小说生成

:bullseye: 核心价值 :robot: AI 驱动：使用大语言模型解析剧本，提取角色、场景和分镜信息

:artist_palette: 智能创作：AI 绘图生成角色形象和场景背景

:video_camera: 视频生成：基于文生视频和图生视频模型自动生成分镜视频

:counterclockwise_arrows_button: 工作流：完整的短剧制作工作流，从创意到成片一站式完成

skills/ — Agent 技能定义 (SKILL.md)

:clapper_board: 分镜制作 :white_check_mark: AI 自动拆解分镜脚本

:white_check_mark: 场景描述和镜头设计

:white_check_mark: 分镜图片生成（文生图）

:white_check_mark: 宫格图生成、切分与分配

:white_check_mark: 帧类型选择（首帧/尾帧/分镜板）

:movie_camera: 视频生成 :white_check_mark: 图生视频自动生成

:white_check_mark: TTS 配音生成

:white_check_mark: FFmpeg 单镜头合成（视频 + 音频 + 字幕）

:white_check_mark: 整集拼接导出

:package: 资源管理 :white_check_mark: 素材库统一管理

:white_check_mark: 本地存储支持

:white_check_mark: 任务进度追踪

:robot: AI Agents 内置 5 个 Mastra Agent ，支持数据库配置和 Skill 扩展：

Agent 职责 script_rewriter 小说 → 格式化剧本改写 extractor 角色 + 场景智能提取与去重 storyboard_breaker 剧本 → 分镜序列拆解 voice_assigner 角色音色自动分配 grid_prompt_generator 角色/场景/宫格图提示词生成 :electric_plug: 多厂商适配 类型 支持厂商 图片 OpenAI 、Gemini 、MiniMax 、火山引擎、阿里、Chatfire 视频 MiniMax 、火山引擎/Seedance 、Vidu 、阿里 TTS MiniMax

:rocket: 快速开始 :clipboard: 环境要求 软件 版本要求 说明 Node.js 20+ 前后端运行环境 npm 9+ 包管理工具 FFmpeg 4.0+ 视频处理（必需） 安装 FFmpeg macOS:

brew install ffmpeg

Ubuntu/Debian:

sudo apt update && sudo apt install ffmpeg

Windows: 从 FFmpeg 官网 下载并配置环境变量

验证安装：

ffmpeg -version

:gear: 配置文件 复制并编辑配置文件：

cp configs/config.example.yaml configs/config.yaml

配置文件格式（ configs/config.yaml ）：

app: name: “Huobao Drama API” version: “1.0.0” debug: true

server: port: 5679 host: “0.0.0.0” cors_origins:

- "http://localhost:3013"

database: type: “sqlite” path: “./data/huobao_drama.db”

storage: type: “local” local_path: “./data/storage” base_url: “http://localhost:5679/static”

ai: default_text_provider: “openai” default_image_provider: “openai” default_video_provider: “doubao”

说明：AI 服务的具体 API Key 和模型参数在 Web 界面的「设置」页面中配置。

:inbox_tray: 安装依赖

克隆项目

git clone https://github.com/chatfire-AI/huobao-drama.git cd huobao-drama

安装后端依赖

cd backend && npm install

安装前端依赖

cd ../frontend && npm install

:bullseye: 启动项目 方式一：开发模式（推荐） 前后端分离，支持热重载：

终端 1：启动后端

cd backend npm run dev

终端 2：启动前端

cd frontend npm run dev

前端地址: http://localhost:3013

后端 API: http://localhost:5679/api/v1

前端自动代理 /api 和 /static 到后端

方式二：单服务模式 后端同时提供 API 和前端静态文件：

1. 构建前端

cd frontend && npm run generate

2. 启动后端

cd ../backend && npm start

访问: http://localhost:5679

:file_cabinet: 数据库 数据库表在首次启动时自动创建，无需手动迁移。默认路径 data/huobao_drama.db ，可通过环境变量覆盖：

DB_PATH=/path/to/your.db npm start