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

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.

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
    Clone and install: the command below, then cd backend && npm install and the next command
    git clone https://github.com/chatfire-AI/huobao-drama.git
    cd ../frontend && npm install
  2. 2
    Start both parts in two terminals: cd backend && npm run dev and cd frontend && npm run dev
  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

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
- GitHub starsCC-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
- GitHub starsMIT

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

Platform
  • Veo 3.1
  • Sora-2
  • Seedance
  • +7
- GitHub starsCC-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
- GitHub starsMIT

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 1, 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.