About this project

Huobao Drama is a full-stack TypeScript platform for automated AI short-drama production. It automates the entire pipeline from idea to finished episode: LLM-based script generation, AI image generation for character designs and scene backgrounds, text-to-video and image-to-video model generation, and FFmpeg-based per-shot compositing with subtitle handling and full-episode stitching. Core capabilities include: - Character management: AI-generated character designs, batch generation, and image upload/management. - Video tasks: automatic AI video-task generation, scene descriptions, video prompt generation, and batch video generation per task. - Video generation: text-to-video generation, FFmpeg per-shot compositing and subtitle handling, and full-episode stitching and export. - Asset management: unified asset library, local storage support, and task progress tracking. - Four built-in Mastra AI agents with database-backed configuration and editable Skill extensions: script_rewriter (novel to formatted script), extractor (intelligent extraction and dedup of characters/scenes/props), storyboard_breaker (script to storyboard sequence breakdown), and prompt_generator (image prompts for characters/scenes/props plus storyboard video prompts). Multi-provider support includes text (OpenAI-compatible APIs, Gemini), image (OpenAI, Gemini, Volcano Engine), and video (Volcano Engine Seedance 2.0, MiniMax H3, Alibaba Bailian Wan 3.0). The UI ships in Chinese, English, Japanese, and Korean, with a global setting for AI-generated content language. Architecture: frontend uses Nuxt 3 + Vue 3 + TypeScript with pure CSS; backend uses Hono + Drizzle ORM + Mastra AI Agents + better-sqlite3; desktop is an Electron app with esbuild and electron-builder. The database is bundled SQLite (WAL mode, zero-install) with automatic table creation on first launch. FFmpeg/FFprobe binaries are bundled via npm packages. Deployment options include development mode, single-service mode, server deployment with Nginx reverse proxy, Docker deployment with multi-arch images and in-app updates via Watchtower, and a prebuilt Electron desktop app for macOS and Windows with built-in auto-update. Legacy MySQL data can be automatically migrated to SQLite on startup or via a manual import script.