Skip to content

chatfire-AI /huobao-drama

Novel in, finished short-drama episode out, with script and storyboard
PlatformCC-BY-NC-SA-4.0English README
Stars
18k
30 days
+1.3k
Last push
2 days ago
huobao-drama screenshot from its README
From the huobao-drama README on GitHub.

About huobao-drama

Huobao Drama takes a novel and builds a whole short-drama episode in your browser. It rewrites the script, pulls out characters, scenes and props, then makes reference images. From there you break the script into shots, generate clips and merge with FFmpeg. It's non-commercial only, and you need paid API keys before anything runs.

Best for: One-person studios and small teams who want one guided, self-hosted pipeline instead of five separate tools.

From the huobao-drama README on GitHub. Tap an image to see it full size.

What it does

  • Runs four built-in AI agents: script rewrite, extraction, storyboard, prompts
  • Extracts characters, scenes and props, then makes reference images in batch
  • Breaks the script into shots with editable video prompts and @character refs
  • Generates clips in batch, with one-click retry for failed tasks
  • Merges shots into a full episode with FFmpeg, subtitles included
  • Keeps agent skills as SKILL.md files you can edit in the UI

Quickstart

Rewritten from the README. Check the repo for the latest steps.

  1. 1
    Easiest: download the macOS or Windows installer from GitHub Releases. FFmpeg and the SQLite database are built in.
  2. 2
    Or run from source with Node.js 20+: clone the repo, run npm install in backend and frontend, then npm run dev in each (two terminals).
  3. 3
    Open http://localhost:3013 (the API runs at http://localhost:5679/api/v1)
  4. 4
    In Settings, paste a Huobao API key under "Huobao Quick Setup", or add providers by hand
  5. 5
    Create a project, paste your novel, then run AI Rewrite, extraction and storyboard breakdown
  6. 6
    Select shots and click Start Merging to export the episode

Models and languages

Models it works with

  • Seedance 2.0
  • MiniMax H3
  • Wan 3.0
  • Gemini
  • OpenAI

Interface and docs

  • Chinese
  • English
  • Japanese
  • Korean

Common questions

What people ask when they look this repo up, answered from its issues and docs.

Is there a Huobao Drama desktop app?
Yes. GitHub Releases has installers for macOS (Apple Silicon and Intel) and Windows, with FFmpeg and the SQLite database built in. There's also a Docker image, huobao/huobao-drama. You only need Node.js 20+ if you run from source. Source
Why does macOS say the Huobao Drama app is damaged?
The build isn't signed, so Gatekeeper blocks it. The file is fine. Run sudo xattr -cr /Applications/HuobaoDrama.app once, or double-click the fix script inside the dmg. On Windows, click "More info", then "Run anyway". Source
Do I have to buy a Huobao API key?
No. The key just fills in text, image and video settings in one click. You can add providers by hand: any OpenAI-compatible API for text, OpenAI, Gemini or Volcano Engine for images, and Seedance 2.0, MiniMax H3 or Wan 3.0 for video. Source
Why doesn't Seedance work in the Huobao Drama desktop app?
Seedance needs a public URL (PUBLIC_BASE_URL) to fetch your local reference images. The desktop app doesn't have one. Run Huobao on a server with that set, or pick MiniMax or Wan for video. Source
I upgraded from an old version. Where did my projects go?
New versions store data in SQLite. Set your old MySQL connection (DATABASE_URL or MYSQL_HOST) and it imports the tables once on first start. Images and videos in the old data/static/ folder don't move, so copy them over yourself. Source

Head-to-head

Alternatives

Other platform projects people compare with huobao-drama.

Anning01

novelvids

Writes storyboards and video from a novel or a reference clip

Platform
  • Seedance 2.0
  • Seedance 2.0 Fast
  • Seedance 2.0 Mini
  • +7
377 GitHub stars+35/30dyesterdayCC-BY-NC-4.0

LingGuoAI

LingGuo-Drama

Self-hosted workbench that turns a script into a mini-drama or motion comic

Platform
  • OpenAI
  • Volcengine
  • MiniMax
1.7k GitHub stars+87/30d2 months agoMIT

sorker

ai-shotlive

Server pipeline that turns a .txt novel into episode scripts and clips

Platform
  • Veo 3.1
  • Sora-2
  • Seedance
  • +7
351 GitHub stars+10/30d2 months agoCC-BY-NC-SA-4.0

HBAI-Ltd

Toonflow-app

One infinite canvas for AI short dramas and comic dramas

Platform
  • Seedance 2.0
  • GPT Image 2
  • Claude Opus 4.6
  • +2
22k GitHub stars+4k/30dyesterdayMIT

Featured on OpenMicroDrama

Do you maintain huobao-drama? Add this badge to your README so English speakers can find our write-up.

Featured on OpenMicroDrama
markdown
[![Featured on OpenMicroDrama](https://openmicrodrama.com/badges/featured.svg)](https://openmicrodrama.com/projects/chatfire-ai-huobao-drama)

The badge links to this page. Want your description changed? Email support@openmicrodrama.com.

Reviewed Oct 13, 2026. LICENSE is CC BY-NC-SA 4.0: free for personal and non-commercial use; commercial use is not allowed without permission. The README pushes a paid Huobao API key service (api.firemux.com); you can also add other providers yourself. We write these descriptions ourselves. The repo's own docs are the final word.