Huobao Drama: Generador de Drama Corto IA de Código Abierto

El video de formato corto está en todas partes, desde clips de TikTok hasta YouTube Shorts, pero el ciclo creativo sigue siendo muy manual. Los guionistas trazan, los artistas dibujan, los editores ensamblan. Huobao Drama rompe ese ciclo convirtiendo una sola línea de texto en un microfilm terminado, impulsado totalmente por software de código abierto y modelos de lenguaje grandes (LLMs).

¿Por qué una herramienta de drama corto de código abierto?

• Democratización de la creación de contenido con IA – Un equipo pequeño puede producir clips con aspecto profesional sin herramientas propietarias costosas.
• Personalización – Conecta tus propios LLMs, modelos de imagen o video, y ajusta el flujo de trabajo para adaptarlo a la cadena de producción de tu estudio.
• Crecimiento impulsado por la comunidad – Desde colaboradores en GitHub hasta discusiones en Discord, el proyecto prospera gracias a la retroalimentación y las solicitudes de funcionalidades de la comunidad.

Arquitectura Principal

La pila está dividida de manera ordenada en cuatro capas, siguiendo los principios de Domain‑Driven Design que mantienen la lógica de negocio limpia y la infraestructura modular.

├─ API Layer (Gin HTTP)          // Exponer puntos finales REST
├─ Application Services Layer    // Orquesta la lógica de dominio
├─ Domain Layer                  // Modelos para guiones, escenas, personajes
└─ Infrastructure Layer          // Base de datos, clientes AI, almacenamiento de archivos

Go impulsa el backend (versión 1.23+), mientras que Vue 3 + TypeScript + Vite construyen una interfaz de usuario amigable. El proyecto utiliza modernc.org/sqlite alojado en GitHub para un controlador SQLite puro en Go, garantizando dependencias cero de C‑go y compilaciones multiplataforma.

Qué puede hacer la plataforma

• Análisis inteligente de guiones – Un LLM procesa una entrada de una frase y extrae la lista de personajes, los escenarios y las escenas del storyboard.
• Generación de personajes y escenas – Los modelos OpenAI o Gemini generan retratos detallados e imágenes de fondo.
• Creación de storyboard – Genera solicitudes de texto a imagen para cada plano, creando una secuencia de fotogramas.
• Síntesis de video – Dos enfoques: texto a video (Sora) e imagen a video (FFMPEG + modelo). Combina ambos para obtener resultados de alta calidad.
• Edición y transiciones – Corte automático, fundidos y sincronización de audio.
• Gestión de recursos – Biblioteca central de activos, soporte de exportación/importación y seguimiento de progreso en tiempo real.

Inicio rápido – Docker Compose

Docker ofrece la forma más sencilla de probar Huobao Drama. El archivo docker-compose.yml descarga la última imagen, monta un directorio de datos local y expone los puertos 5678 (API) y 3012 (frontend).

# Descargar la imagen y comenzar la pila
$ docker compose up -d

# Ver registros
$ docker compose logs -f

# Detener la pila
$ docker compose down

Toda la configuración está en configs/config.yaml. Edita valores como ai.default_text_provider o server.port antes del primer lanzamiento.

Modo de desarrollo – Recarga caliente

¿Quieres ajustar el frontend o el backend? Clona el repositorio, instala las dependencias y ejecuta cada parte por separado:

# Backend
$ go run main.go
# Frontend
$ cd web && npm run dev

El frontend está configurado para redirigir las solicitudes API a localhost:5678, así puedes experimentar en tiempo real.

Guía de Contribución

• Forkea el repositorio, crea una rama de características y empuja los cambios.
• Escribe mensajes de commit claros y mantén los títulos de PR concisos.
• Ejecuta go vet y npm run lint antes de enviar.
• Revisa docs/CONTRIBUTING.md para estándares de codificación e instrucciones de pruebas.

Posibles Casos de Uso

1. Escuelas de cine experimentan con prototipado rápido de historias.
2. Equipos de marketing producen microvídeos con la marca para redes sociales.
3. Creadores de contenido generan infinitas ideas para Vlogs o YouTube.
4. Investigadores de IA prueban tuberías de texto a video con una tubería lista para usar.

Hoja de Ruta Futura

• Soporte para más proveedores de LLM (Claude, Llama‑2).
• Generación de video acelerada por GPU con ejecución opcional de ONNX.
• UI multilingüe y análisis de guiones.
• Panel de análisis para métricas de producción.

Participa

Ya seas desarrollador, diseñador o narrador, hay un lugar para ti. Únete al repositorio de GitHub, haz un fork y comienza a programar. Para preguntas rápidas, deja una nota en las discusiones o contacta a los mantenedores por Discord.

Deja que Huobao Drama convierta la próxima gran idea en un cortometraje pulido en pocos clics, todo impulsado por IA de código abierto.