explaingit

chatfire-ai/huobao-drama

11,739TypeScriptAudience · vibe coderComplexity · 4/5LicenseSetup · hard

TLDR

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.

Mindmap

mindmap
  root((huobao-drama))
    What it does
      Idea to video pipeline
      Script generation
      Character and scene design
      Voiceover and assembly
    Tech stack
      Nuxt 3 and Vue 3
      Hono backend
      SQLite database
      FFmpeg rendering
    AI providers
      OpenAI and Gemini
      MiniMax for images
      Text to speech services
    Setup
      Docker Compose deploy
      YAML config file
      Multiple API keys needed
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Turn a one-sentence story idea into a complete short drama video with AI-generated visuals and voiceovers

USE CASE 2

Create AI-scripted short films for social media without any video editing skills

USE CASE 3

Prototype storytelling ideas rapidly before committing to manual production

USE CASE 4

Self-host a video drama generation tool using Docker Compose with your own AI provider API keys

Tech stack

TypeScriptNuxt 3Vue 3HonoSQLiteFFmpegDocker

Getting it running

Difficulty · hard Time to first run · 1h+

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.

Free for non-commercial use with attribution, you must share modifications under the same license and cannot use this for commercial purposes.

In plain English

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.

Copy-paste prompts

Prompt 1
I have huobao-drama running locally. Write me a YAML config snippet to use OpenAI for script generation and MiniMax for image generation
Prompt 2
Generate a short drama prompt for huobao-drama about a programmer who discovers their AI assistant has become sentient, format it as a one-sentence input
Prompt 3
How do I add support for a new AI image provider in the huobao-drama Hono backend without breaking existing providers?
Prompt 4
Write a Docker Compose override file for huobao-drama that mounts a local FFmpeg binary instead of the bundled one
Prompt 5
Walk me through how the five AI agents in huobao-drama divide the work from my input sentence to the finished video file
Open on GitHub → Explain another repo

← chatfire-ai on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.