chatfire-ai/huobao-drama — explained in plain English
Analysis updated 2026-06-24
Turn a one-sentence story idea into a complete short drama video with AI-generated visuals and voiceovers
Create AI-scripted short films for social media without any video editing skills
Prototype storytelling ideas rapidly before committing to manual production
Self-host a video drama generation tool using Docker Compose with your own AI provider API keys
| chatfire-ai/huobao-drama | marp-team/marp | portkey-ai/gateway | |
|---|---|---|---|
| Stars | 11,739 | 11,711 | 11,710 |
| Language | TypeScript | TypeScript | TypeScript |
| Setup difficulty | hard | easy | easy |
| Complexity | 4/5 | 2/5 | 3/5 |
| Audience | vibe coder | developer | developer |
Figures from each repo's GitHub metadata at analysis time.
Requires API keys for multiple AI services such as OpenAI and MiniMax, Docker Compose is the easiest path but still needs per-provider configuration in a YAML file.
Huobao Drama is an AI-powered platform that turns a one-sentence idea into a complete short-form video drama. You describe what you want, and the system generates the script, designs the characters, creates the visual scenes, adds voiceovers, and assembles the final video, all without you touching any of those steps individually. The process works through a pipeline of five AI agents. One rewrites your input into a properly formatted screenplay. A second extracts the characters and scenes. A third breaks the screenplay into individual shots. A fourth assigns a voice to each character. A fifth generates the image prompts needed to produce the visuals. The platform supports multiple AI service providers for different tasks, including OpenAI, Gemini, MiniMax, and Alibaba for image generation, and several providers for video clips and text-to-speech. The technical stack is split between a Nuxt 3 and Vue 3 frontend and a backend built on the Hono web framework. Data is stored in a local SQLite database that the application creates automatically on first start. Video rendering uses FFmpeg, which must be installed separately (or is included if you run the Docker version). Configuration of which AI service providers to use and their API keys happens through a YAML file and the web interface rather than environment variables. Deployment can be done with Docker Compose, which packages the frontend and backend into a single image with FFmpeg already included. A traditional server setup is also documented, with an example Nginx reverse proxy configuration. The project is released under a Creative Commons BY-NC-SA 4.0 license, meaning it is free for non-commercial use with attribution. The project is primarily documented in Chinese, though the core concepts and setup steps follow a standard web application pattern and can be followed with the help of a translation tool.
An AI platform that turns a one-sentence idea into a complete short-form video drama by automatically generating the script, characters, visuals, voiceovers, and final assembled video.
Mainly TypeScript. The stack also includes TypeScript, Nuxt 3, Vue 3.
Free for non-commercial use with attribution, you must share modifications under the same license and cannot use this for commercial purposes.
Setup difficulty is rated hard, with roughly 1h+ to a first successful run.
Mainly vibe coder.
This repo across BitVibe Labs
Verify against the repo before relying on details.