chatfire-AI / huobao-drama

🎬 Huobao Drama - AI Short Drama Production Platform **Full-stack AI Short Drama Automation Platform Based on Go + Vue3** Features • Quick Start • Deployment 简体中文 | English | 日本語 --- 📖 About Huobao Drama is an AI-powered short drama production platform that automates the entire workflow from script generation, character design, storyboarding to video composition. 火宝短剧商业版地址：火宝短剧商业版 火宝小说生成：火宝小说生成 🎯 Core Features • **🤖 AI-Driven**: Parse scripts using large language models to extract characters, scenes, and storyboards • **🎨 Intelligent Creation**: AI-generated character portraits and scene backgrounds • **📹 Video Generation**: Automatic storyboard video generation using text-to-video and image-to-video models • **🔄 Complete Workflow**: End-to-end production workflow from idea to final video。 🛠️ Technical Architecture Based on **DDD (Domain-Driven Design)** with clear layering: 🎥 Demo Videos Experience AI short drama generation: **Sample Work 1** **Sample Work 2** Watch Video 1 | Watch Video 2 --- ✨ Features 🎭 Character Management • ✅ AI-generated character portraits • ✅ Batch character generation • ✅ Character image upload and management 🎬 Storyboard Production • ✅ Automatic storyboard script generation • ✅ Scene descriptions and shot design • ✅ Storyboard image generation (text-to-image) • ✅ Frame type selection (first frame/key frame/last frame/panel) 🎥 Video Generation • ✅ Automatic image-to-video generation • ✅ Video composition and editing • ✅ Transition effects 📦 Asset Management • ✅ Unified asset library management • ✅ Local storage support • ✅ Asset import/export • ✅ Task progress tracking --- 🚀 Quick Start 📋 Prerequisites | Software | Version | Description | | ----------- | ------- | ------------------------------- | | **Go** | 1.23+ | Backend runtime | | **Node.js** | 18+ | Frontend build environment | | **npm** | 9+ | Package manager | | **FFmpeg** | 4.0+ | Video processing (**Required**) | | **SQLite** | 3.x | Database (built-in) | Installing FFmpeg **macOS:** **Ubuntu/Debian:** **Windows:** Download from FFmpeg Official Site and configure environment variables Verify installation: ⚙️ Configuration Copy and edit the configuration file: Configuration file format ( ): **Key Configuration Items:** • : Debug mode switch (recommended true for development) • : Service port • : Allowed CORS origins for frontend • : SQLite database file path • : Local file storage path • : Static resource access URL • : AI service provider configuration (API keys configured in Web UI) 📥 Installation 🎯 Starting the Project Method 1: Development Mode (Recommended) **Frontend and backend separation with hot reload** • Frontend: • Backend API: • Frontend automatically proxies API requests to backend Method 2: Single Service Mode **Backend serves both API and frontend static files** Access: 🗄️ Database Initialization Database tables are automatically created on first startup (using GORM AutoMigrate), no manual migration needed. --- 📦 Deployment ☁️ Cloud One-Click Deployment (Recommended 3080Ti) 👉 优云智算，一键部署 > ⚠️ **Note**: Please save your data to local storage promptly when using cloud deployment --- 🐳 Docker Deployment (Recommended) Method 1: Docker Compose (Recommended) 🚀 China Network Acceleration (Optional) If you are in China, pulling Docker images and installing dependencies may be slow. You can speed up the build process by configuring mirror sources. **Step 1: Create environment variable file** **Step 2: Edit file and uncomment the mirror sources you need** **Step 3: Build with docker compose (required)** > **Important Note**: > > - ⚠️ You must use to automatically load mirror source configurations from the file > - ❌ If using command, you need to manually pass parameters > - ✅ Always recommended to use for building **Performance Comparison**: | Operation | Without Mirrors | With Mirrors | | ---------------- | --------------- | ------------ | | Pull base images | 5-30 minutes | 1-5 minutes | | Install npm deps | May fail | Fast success | | Download Go deps | 5-10 minutes | 30s-1 minute | > **Note**: Users outside China should not configure mirror sources, use default settings. Method 2: Docker Command > **Note**: Linux users need to add to access host services **Local Build** (optional): **Docker Deployment Advantages:** • ✅ Ready to use with default configuration • ✅ Environment consistency, avoiding dependency issues • ✅ One-click start, no need to install Go, Node.js, FFmpeg • ✅ Easy to migrate and scale • ✅ Automatic health checks and restarts • ✅ Automatic file permission handling 🔗 Accessing Host Services (Ollama/Local Models) The container is configured to access host services using . **Configuration Steps:** • **Start service on host (listen on all interfaces)** • **Frontend AI Service Configuration** • Base URL: • Provider: • Model: --- 🏭 Traditional Deployment • Build Generated files: • - Backend executable • - Frontend static files (embedded in backend) • Prepare Deployment Files Files to upload to server: • Server Configuration • Manage Service with systemd Create service file : Start service: **⚠️ Common Issue: SQLite Write Permission Error** If you encounter error: **Reason:** • SQLite requires write permission on both the database file **and** its directory • Needs to create temporary files in the directory (e.g., , ) • **Key**: Ensure systemd matches data directory owner **Common Usernames:** • Ubuntu/Debian: , • CentOS/RHEL: , • Custom deployment: , , current logged-in user • Nginx Reverse Proxy --- 🎨 Tech Stack Backend • **Language**: Go 1.23+ • **Web Framework**: Gin 1.9+ • **ORM**: GORM • **Database**: SQLite • **Logging**: Zap • **Video Processing**: FFmpeg • **AI Services**: OpenAI, Gemini, Doubao, etc. Frontend • **Framework**: Vue 3.4+ • **Language**: TypeScript 5+ • **Build Tool**: Vite 5 • **UI Components**: Element Plus • **CSS Framework**: TailwindCSS • **State Managem…