Python · local · versión 1.0.0

Un tema. Un plan.
Muchas narrativas.

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

Planificación de vídeos narrativos
En resumen

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.

Qué es

La dirección antes de la producción

El motor entrega un documento de planificación. Tú revisas la narrativa y eliges cómo producir cada escena.

Estructura del plan narrativo

6 estructuras narrativas

Origen y legado, mito y revelación, problema y solución, cronología inversa, lugares y objeto testigo.

7 lenguajes visuales

Uno principal y dos de apoyo, con indicaciones para la cámara, las transiciones, el texto y el sonido.

Memoria local

El historial evita algunas elecciones recientes. Cuando se agotan las opciones, el motor puede repetirlas.

Cómo funciona

Del tema al paquete de prompts

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.

Tema + duración→Configuración + historial→Plan JSON→Prompts Markdown
Requisitos previos

Python y los archivos del proyecto

No requiere instalar paquetes. Git permite descargar el repositorio; también puedes descargar el ZIP desde GitHub.

python3 --version
Guía de uso

Tu primer plan en cuatro pasos

Los siguientes comandos usan ejemplos en portugués. La interfaz del motor y los textos generados permanecen en pt-BR.

1

Descarga el proyecto

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
2

Elige el tema y la duración

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"
3

Abre los dos resultados

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.

4

Revisa y produce

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
Ejemplos incluidos

Dos temas, dos direcciones

Son planes de producción, sin guion final ni vídeo renderizado. Los materiales originales están en portugués.

Cómo llegó el café a Brasil

Cronología inversa y collage multimedia.

Plan JSON · Paquete de prompts

Ciudades antiguas y ríos

Objeto testigo y B-roll cinematográfico.

Plan JSON · Paquete de prompts

Leer el ADN audiovisual de la referencia · Leer la propuesta original

Estado del proyecto

Qué existe ya y qué viene después

Disponible
Planificación localCLI, configuración, historial, planes y prompts. Modifica engine_config.json para personalizar los catálogos, conservando la estructura de las listas.
Manual
Producción audiovisualInvestigación, guion, síntesis de voz, generación de imágenes, música, edición y validación del vídeo final. Los nombres de voz del plan son referencias de configuración, no integraciones activas.

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.