Organiza la dirección de tu próximo vídeo con escenas, tiempos y prompts listos para desarrollar.

Una herramienta en Python para quienes planifican vídeos educativos y narrativos. A partir de un tema, organiza las escenas, los tiempos previstos y las indicaciones de imagen, voz y música en dos archivos. El historial local ayuda a variar las elecciones entre proyectos. Basta con tener Python 3.9 o superior: la creación del plan funciona sin conexión y sin clave de API. El guion final, el audio y el vídeo se producen después, con otras herramientas.
El motor entrega un documento de planificación. Tú revisas la narrativa y eliges cómo producir cada escena.

Origen y legado, mito y revelación, problema y solución, cronología inversa, lugares y objeto testigo.
Uno principal y dos de apoyo, con indicaciones para la cámara, las transiciones, el texto y el sonido.
El historial evita algunas elecciones recientes. Cuando se agotan las opciones, el motor puede repetirlas.
Las elecciones se sortean entre las opciones configuradas, teniendo en cuenta el historial. El motor no investiga el tema ni evalúa automáticamente si cada elección encaja con él.
No requiere instalar paquetes. Git permite descargar el repositorio; también puedes descargar el ZIP desde GitHub.
python3 --version
Los siguientes comandos usan ejemplos en portugués. La interfaz del motor y los textos generados permanecen en pt-BR.
Abre el terminal en la carpeta donde quieras guardar los archivos.
git clone https://github.com/inematds/motor-videos-narrativos.git cd motor-videos-narrativos python3 motor_video.py --help
La duración admitida va de 20 a 600 segundos. Hay formatos vertical, cuadrado y horizontal.
python3 motor_video.py --tema "Como o café chegou ao Brasil" --duracao 60 --formato 9:16 --objetivo "educar e gerar curiosidade" --publico "público geral" --cta "Comente o que você descobriu"
El terminal muestra la carpeta creada en jobs/. El archivo plano.json organiza los datos; prompt_pack.md presenta cada escena y la lista de comprobación. El archivo history.json se crea automáticamente en la raíz.
python3 motor_video.py --tema "Por que as cidades antigas surgiam perto dos rios" --duracao 45 --formato 16:9 --seed 20261011 --voz informative_warm --out jobs/meu-plano
Usa una carpeta nueva en --out: los archivos existentes con los mismos nombres se sobrescriben. Para repetir las elecciones, conserva la semilla, los argumentos, la configuración y el historial de entrada; la semilla por sí sola no basta. La fecha y el identificador pueden cambiar.
Completa los espacios del texto hablado, comprueba los hechos y revisa las decisiones de dirección. Después produce la narración y mide su duración para ajustar las escenas. Las imágenes, la música, los subtítulos, el montaje y la exportación del MP4 son etapas externas al motor.
python3 -m json.tool jobs/meu-plano/plano.json
Son planes de producción, sin guion final ni vídeo renderizado. Los materiales originales están en portugués.
Leer el ADN audiovisual de la referencia · Leer la propuesta original
Los documentos originales, en portugués, describen el flujo deseado y las mediciones comunicadas de la referencia. No demuestran que este script haya renderizado vídeos. El archivo multimedia de referencia no forma parte del paquete recibido.