Repolode
Submit
chatfire-AI

chatfire-AI/huobao-drama

Open-source full-stack platform that turns a novel or one-sentence idea into a short drama, automating script, character, storyboard and video generation with AI.

View on GitHub
Stars
17,068
Forks
3,178
Open issues
38
Last commit
2 days ago

What is it?

Huobao Drama is an AI-driven production pipeline for short dramas. You paste source text such as a novel, and LLMs rewrite it into a formatted script, extract characters, scenes and props, and break the script into storyboard shots with video prompts. Image models generate consistent reference images for characters and scenes, and text-to-video or image-to-video models render each shot.

The app is built with Nuxt 3 and Vue 3 on the frontend, and Hono, Drizzle ORM and Mastra agents on the backend, storing data in a bundled SQLite file. FFmpeg, bundled as an npm package, stitches shots into a full episode for playback or download. Supported providers include OpenAI-compatible APIs, Gemini, Volcano Engine Seedance, MiniMax and Alibaba Bailian Wan. The interface is available in Chinese, English, Japanese and Korean.

Beyond the web app, it ships as an Electron desktop build for macOS and Windows, a Docker image, and a server deployment option. The license is CC BY-NC-SA 4.0, which prohibits commercial use without permission.

Key features

  • 01Generates a formatted script from source novel text using LLMs.
  • 02Extracts characters, scenes and props, and generates reference images for them.
  • 03Breaks scripts into storyboard shots with video prompts.
  • 04Supports multiple text, image and video model providers via settings in the web UI.
  • 05Stitches per-shot clips into a full episode with FFmpeg.
  • 06Runs as a web app, Electron desktop app, or Docker container.

Use cases

  • Turning a web novel or serialized story into short-form episodic video.
  • Prototyping a short drama's characters, scenes and storyboard before filming.
  • Experimenting with AI video generation pipelines across several model providers.
  • Self-hosting a bilingual short-drama production tool for a small team.

Quick start

  1. 1

    Clone the repository

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

    Install backend dependencies (run inside the backend folder)

    npm install
  3. 3

    Install frontend dependencies (run inside the frontend folder)

    npm install
  4. 4

    Start the backend and frontend in development mode, each in its own terminal

    npm run dev

Things to know

  • The README states the license is CC BY-NC-SA 4.0, which is non-commercial.
  • AI features need API keys from model providers and do not work until they are configured in the Settings page.
  • Requires Node.js 20+ and npm 9+.

In collections

AI video generationAI video & audio tools

Topics

#ai-video#short-drama#llm#text-to-video#storyboard#ffmpeg#electron#vue

FAQ

What is huobao-drama?
Open-source full-stack platform that turns a novel or one-sentence idea into a short drama, automating script, character, storyboard and video generation with AI. Huobao Drama is an AI-driven production pipeline for short dramas. You paste source text such as a novel, and LLMs rewrite it into a formatted script, extract characters, scenes and props, and break the script into storyboard shots with video prompts. Image models generate consistent reference images for characters and scenes, and text-to-video or image-to-video models render each shot.
Is huobao-drama free to use? What license does it have?
huobao-drama is open source under the Other license. Check the license terms before using it in commercial products.
Is huobao-drama still maintained?
Actively maintained. The last commit to huobao-drama was on Nov 5, 2026.
What can I use huobao-drama for?
Turning a web novel or serialized story into short-form episodic video. Prototyping a short drama's characters, scenes and storyboard before filming. Experimenting with AI video generation pipelines across several model providers. Self-hosting a bilingual short-drama production tool for a small team.
How do I install huobao-drama?
Clone the repository: git clone https://github.com/chatfire-AI/huobao-drama.git Install backend dependencies (run inside the backend folder): npm install Install frontend dependencies (run inside the frontend folder): npm install Start the backend and frontend in development mode, each in its own terminal: npm run dev
Where can I get huobao-drama?
The source code and installation instructions are on GitHub: https://github.com/chatfire-AI/huobao-drama

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects