# Huobao Drama — card for AI agents

Open-source platform that automates AI short-drama production from script and characters to storyboard and video compositing.

Category: AI video generators and platforms · maker chatfire-ai · checked 2026-11-10

## Price
- Price: Free
- Free tier: Free to self-host for noncommercial use under CC BY-NC-SA 4.0

## License
CC BY-NC-SA 4.0 — https://github.com/chatfire-ai/huobao-drama/blob/HEAD/LICENSE

- commercial: **no** (Non-commercial only)
  > reproduce and Share the Licensed Material, in whole or in part, for NonCommercial purposes only
  (https://github.com/chatfire-ai/huobao-drama/blob/HEAD/LICENSE)
- attribution: **required** (Credit required)
  > The License Elements of this Public License are Attribution, NonCommercial, and ShareAlike.
  (https://github.com/chatfire-ai/huobao-drama/blob/HEAD/LICENSE)
- in app: **no** (Cannot ship inside an app)
  > produce, reproduce, and Share Adapted Material for NonCommercial purposes only.
  (https://github.com/chatfire-ai/huobao-drama/blob/HEAD/LICENSE)

## Rules to follow
- Use only for noncommercial purposes; do not build it into a commercial product or service.
- Credit the author, link the CC BY-NC-SA 4.0 license and mark any changes you make.
- Release any adapted material under the same or a compatible license (BY-NC-SA).
- AI provider keys for text, image and video models are configured separately and are not covered by this license.

## How to connect
- Download only
- Repository: https://github.com/chatfire-ai/huobao-drama
- Website: https://github.com/chatfire-ai/huobao-drama

## Notes
Added automatically. License read from the official pages.

## Numbers (AgentGid data)
- Gid Score: 39
- GitHub stars: 17,717

## Lines to paste into your prompt or AGENTS.md

```
- Huobao Drama (AI video generators and platforms). Open-source platform that automates AI short-drama production from script and characters to storyboard and video compositing. Price: free; non-commercial only; credit required; cannot ship inside an app.
  Connect: download from https://github.com/chatfire-ai/huobao-drama (no API).
  Rule: Use only for noncommercial purposes; do not build it into a commercial product or service.
  Rule: Credit the author, link the CC BY-NC-SA 4.0 license and mark any changes you make.
  Rule: Release any adapted material under the same or a compatible license (BY-NC-SA).
  Rule: AI provider keys for text, image and video models are configured separately and are not covered by this license.
  License: https://github.com/chatfire-ai/huobao-drama/blob/HEAD/LICENSE (checked 2026-11-10; details: https://agentgid.com/assets/huobao-drama/)
```

## Links
- AgentGid page: https://agentgid.com/assets/huobao-drama/
- Is it free for commercial use? https://agentgid.com/assets/huobao-drama/commercial-use/
- Source: https://github.com/chatfire-ai/huobao-drama/blob/HEAD/LICENSE
- Source: https://github.com/chatfire-ai/huobao-drama


## Huobao Drama: turn a story into an AI short drama

Huobao Drama is a free app that turns a story or novel text into a short video drama, step by step. AI helpers write the script, list the characters and scenes, draw reference pictures, split the story into shots and make a video clip for each shot. The app then joins the clips into a finished episode.

### Where to use it
- Turn a novel into episodes: Paste a chapter of your story and let the AI rewrite it as a shooting script, split into episodes with scenes and characters marked.
- Same characters in every shot: The app pulls a list of characters, places and props from the script and draws one reference picture for each. Those pictures guide every video clip, so faces stay the same.
- From storyboard to a finished episode: The AI cuts each episode into shots and writes a prompt for each one. You check them, make all clips in one batch, and join the ones you like into an episode.
- Try it on your own computer: Run the app on your laptop and open it in the browser. The database is a single file, and video tools come built in, so nothing else needs installing.
- A shared studio on a server: Run one copy on a server so a small non-commercial team, such as a student film club, works on the same projects.
- An animatic for a school film: Turn a class screenplay into rough moving shots to plan camera angles and timing before filming. (idea, not from the official pages)

### How to start
- Easiest path on a Mac or Windows PC is the ready desktop app from the GitHub releases page; it updates itself.
- Or run it from the code with Node.js 20 or newer.

```
# Install backend dependencies
cd backend && npm install
# Install frontend dependencies
cd ../frontend && npm install
```

- Open Settings and add model services for text, images and video; until then a banner asks you to do it.

### License
CC BY-NC-SA 4.0: free for personal, learning and non-commercial projects only. Paid services, commercial deployments and resale need written permission from the author, and changed versions must keep credit and the same license.

### Good to know
- The app does not make pictures or video by itself. It sends the work to outside AI services you set up, and those services usually charge per use.
- Video comes from hosted models such as Seedance 2.0, MiniMax H3 and Wan 3.0 on Alibaba Cloud. The open Wan 2.2 you run yourself is not in the list.
- The Mac and Windows apps are not signed. Your computer warns about them on first launch, and the fix means overriding a security check.
- Some video models fail on real people or sensitive scenes because of their content checks; the app then suggests trying another model.
- The picture shape, wide or tall, is chosen when you create a project and cannot be changed later.

Checked 2026-11-10 against: https://github.com/chatfire-ai/huobao-drama, https://github.com/chatfire-ai/huobao-drama/blob/HEAD/README.md, https://github.com/chatfire-ai/huobao-drama/blob/HEAD/LICENSE, https://github.com/chatfire-ai/huobao-drama/releases.atom

### Mistakes to avoid
- Don't: deploying it for a client, inside a paid product or as a paid service → Do: use it only for personal or non-commercial work, or get written permission from the author first (The license is CC BY-NC-SA 4.0 and the README forbids commercial use without written permission.)
- Don't: putting provider keys in .env or environment variables → Do: let the person enter keys in the Settings page of the app (Keys are stored in the app database through the Settings page, not read from files.)
- Don't: npm run generate, then npm start in backend, and the pages return 404 → Do: copy frontend/.output/public to frontend/dist before starting the backend (The backend only reads frontend/dist.)
- Don't: using Seedance with local reference images in the desktop app or without a public address → Do: set PUBLIC_BASE_URL on a server deployment, or pick another video model on the desktop (Seedance needs a public URL to fetch local assets.)

### Questions
- Can I sell episodes or offer it as a paid service? Not without written permission from the author; the license allows only non-commercial use.
- Do I need to install FFmpeg or a database? No. Both come built in.
- Where does the desktop app keep my projects? In your user folder under Application Support/HuobaoDrama on a Mac, so removing the app keeps your data.
- Which interface languages are there? Chinese, English, Japanese and Korean, with a setting for the language of AI-written content.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
