Repolode
Enviar
HKUDS

HKUDS/ViMax

Framework agéntico de generación de video que convierte una idea, un guion o una novela en un video con varios planos mediante agentes coordinados.

Ver en GitHubSitio web
Estrellas
12,707
Forks
1,927
Issues abiertos
53
Último commit
hace 20 días

¿Qué es?

ViMax es un framework agéntico de creación de video que automatiza el proceso desde una narración hasta un video terminado. Abarca la escritura de guiones, la creación de storyboards, el diseño de personajes y referencias, la planificación de planos, la generación de imágenes y videos, y el montaje final. Así, se puede partir de una idea breve o de un texto extenso sin tener que producir cada plano manualmente.

El proyecto ofrece varios flujos de trabajo: Idea2Video desarrolla una idea breve para crear personajes, guiones y storyboards; Script2Video convierte un guion explícito en secuencias de varias escenas que se pueden controlar; Novel2Video adapta obras de ficción extensas a narrativas visuales episódicas; y AutoCameo incorpora a una persona o mascota de una foto de referencia en historias generadas. La generación de planos compatibles y recursos multimedia puede ejecutarse en paralelo.

ViMax se puede controlar desde una TUI de línea de comandos con sesiones reanudables o desde una Web UI local con proyectos con nombre, carga de archivos, vistas previas de recursos y storyboards, y configuración de proveedores. Requiere Python 3.12, usa uv para gestionar el entorno y funciona con proveedores configurables de modelos de chat, imágenes y video.

Funciones clave

  • 01Genera un video completo a partir de una idea breve, con guion, storyboard y planos.
  • 02Convierte guiones explícitos en videos con varias escenas y planos.
  • 03Adapta obras de ficción extensas a narrativas visuales episódicas.
  • 04Mantiene la apariencia de una persona o mascota coherente en las escenas generadas.
  • 05Ofrece una TUI interactiva y una Web UI local para controlar la planificación, las revisiones y el renderizado.
  • 06Genera en paralelo planos compatibles y recursos multimedia.

Casos de uso

  • Crear prototipos de cortometrajes o tráilers a partir de una idea escrita.
  • Convertir un guion en un video preliminar con varios planos para revisarlo.
  • Adaptar un capítulo de una novela a un video episódico de estilo animado.
  • Crear relatos cortos personalizados en los que aparezca una foto del usuario.

Inicio rápido

  1. 1

    Instala uv (consulta la documentación de uv enlazada en el README).

  2. 2

    Clona el repositorio.

    git clone https://github.com/HKUDS/ViMax.git
  3. 3

    Entra en el directorio del proyecto e instala las dependencias.

    cd ViMax && uv sync
  4. 4

    Crea una configuración local del agente, añade tus claves de API y, después, inicia la TUI.

    cp configs/agent.example.yaml configs/agent.local.yaml

Antes de usarlo

  • Se necesitan claves de API de proveedores de LLM y de generación de imágenes y vídeos, lo que puede suponer costes considerables.
  • Antes de ejecutar nada, hay que configurar un archivo YAML con los detalles de los modelos y proveedores.
  • El README indica que solo se admiten Linux y Windows.

Temas

#video-generation#ai-agents#llm#storyboard#screenwriting#image-generation#python#multimodal#agentic-aigc

Preguntas frecuentes

¿Qué es ViMax?
Framework agéntico de generación de video que convierte una idea, un guion o una novela en un video con varios planos mediante agentes coordinados. ViMax es un framework agéntico de creación de video que automatiza el proceso desde una narración hasta un video terminado. Abarca la escritura de guiones, la creación de storyboards, el diseño de personajes y referencias, la planificación de planos, la generación de imágenes y videos, y el montaje final. Así, se puede partir de una idea breve o de un texto extenso sin tener que producir cada plano manualmente.
¿ViMax es gratuito? ¿Qué licencia tiene?
ViMax es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ViMax sigue mantenido?
Mantenimiento activo. El último commit de ViMax fue el 30 sept 2026.
¿Para qué puedo usar ViMax?
Crear prototipos de cortometrajes o tráilers a partir de una idea escrita. Convertir un guion en un video preliminar con varios planos para revisarlo. Adaptar un capítulo de una novela a un video episódico de estilo animado. Crear relatos cortos personalizados en los que aparezca una foto del usuario.
¿Cómo se instala ViMax?
Instala uv (consulta la documentación de uv enlazada en el README). Clona el repositorio.: git clone https://github.com/HKUDS/ViMax.git Entra en el directorio del proyecto e instala las dependencias.: cd ViMax && uv sync Crea una configuración local del agente, añade tus claves de API y, después, inicia la TUI.: cp configs/agent.example.yaml configs/agent.local.yaml
¿Dónde consigo ViMax?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/HKUDS/ViMax

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados