El proceso usado en Astra y OSWork Quick, organizado para producir nuevas explicaciones con avatar, ilustraciones y subtítulos.

El guion, la generación, el montaje y la entrega tienen estados y archivos propios.
Cada tema apunta a su fuente y sus escenas. OSWork cubre los 48 temas, ejemplos y ejercicios.
La plantilla aprobada de HeyGen conserva el avatar y la voz. Las ilustraciones siguen los tiempos medidos del habla.
El audio, la duración, los subtítulos y la reproducción se verifican antes del MP4, el reproductor y el aviso en el bot v3.
Los scripts se encargan de las etapas repetitivas. La revisión editorial y visual se realiza antes de escalar.
Esta versión usa el entorno INEMA. Para otra máquina, ajusta las rutas de la configuración y los adaptadores.
Python, Node, FFmpeg, GitHub CLI, systemd, perfil autenticado en HeyGen y credenciales de consulta/transcripción cargadas en runtime.
# comando
python3 --version
node --version
ffmpeg -version
gh auth statusEl ejemplo de OSWork ya está preparado. Si hay una ejecución iniciada, consulta el estado en lugar de generar otro manifiesto.
Copia la configuración en un proyecto nuevo y revisa la fuente, el destino y el idioma. Cada etapa conserva sus resultados.
python3 explica.py --config examples/oswork.json status # muestra generación, descargas, render y publicación
Solo antes de iniciar la generación.
python3 explica.py --config examples/oswork.json prepare
Vista previa sin audio para revisar los diagramas.
python3 explica.py preview python3 engine/check_layouts.py
Cinco servicios persistentes continúan activos después de cerrar la terminal.
python3 explica.py start
Los estados y los registros muestran lo que ocurrió realmente.
python3 explica.py status journalctl --user -u explica-oswork-completo-submit -n 20 --no-pager
En v2, cada escena tiene un guion visual con señales habladas: cuando el habla dice "entrada, modelo, salida", aparece el flujo; cuando dice "no existe el mejor modelo", el podio se desmorona y el radar de criterios encaja el modelo adecuado. Se reutilizan el avatar y el audio, sin generar contenido nuevo en HeyGen.

hub, pipeline, flujo, radar, podio, rutas, comparación, chat, terminal, árbol de carpetas, ficha, laboratorio, quiz, línea de tiempo y más, en engine/v2/runtime.

El guion usa fragmentos literales del habla; la compilación resuelve cada señal a partir de la transcripción real y señala las brechas superiores a 10 s. Los subtítulos usan la ortografía del guion.
El motor v1 (explica.py, engine/*.py) sigue igual y continúa disponible para producciones y mejoras. La versión anterior de OSWork está en el release video-v1.0.0.
# guion visual: <output>/visual-v2/pt-bNN.json (ver engine/v2/AUTHORING.md) export EXPLICAVIDEOS_CONFIG=examples/oswork-v2.json python3 engine/v2/setup_output.py # reutiliza avatar, transcripción y tiempos de v1 python3 engine/v2/build_block.py 1 --strict # señales → tiempos; 0 advertencias engine/v2/run_lane.sh 1 2 3 # verificación de check + render por bloque python3 engine/assemble_languages.py && python3 engine/publish_finished.py
El mismo discurso de Nei se convierte en video horizontal o vertical, con perfil de clase o viral. Elige por el tema: clase para cursos y proyectos; viral para noticias, números, clima y reels. El formato sale solo de la config v2.

Cuándo usarlo: noticias, números, clima, videos de YouTube que necesitan enganchar.
Cómo se ve: el cuadro 0 es la portada, con una imagen impactante y un título grande ya en el arte. Luego, imágenes de Codex a pantalla completa que cambian cada 1,5–3 s, número gigante (bignum) y gráficos a pantalla completa (ranking, barra, mapa). El avatar va en un recuadro con marco ámbar abajo a la derecha y crece a pantalla completa en los shots rosto. Subtítulo grande de 1–3 palabras, con la palabra hablada en ámbar.
"profile_visual": "viral"
Reglas y QA (qa_viral.py): engine/v2/PADRAO-VIRAL.md.

Cuándo usarlo: cursos, proyectos, explicaciones paso a paso.
Cómo se ve: fondo oscuro, área útil a la izquierda (x 90–1420) con tarjetas y diagramas armados con los 21 primitivos (flujo, radar, terminal, comparación…). El avatar va pequeño arriba a la derecha, con CENA n/N y la tarjeta PARA LLEVAR debajo. El subtítulo sigue el habla.
# predeterminado del v2: sin profile_visual
"engine": "v2"Guion visual: engine/v2/AUTHORING.md.

Cuándo usarlo: versión vertical de una clase o short informativo (30–40 s).
Cómo se ve: las escenas se siguen dibujando en 1920×1080 y se escalan hacia arriba. El avatar 16:9 recortado ocupa la franja de abajo. La columna derecha (CENA n/N, PARA LLEVAR) no aparece: usa "takeaway": false. Subtítulo de 46 px en 2 líneas dentro de la zona segura.
"aspect": "9:16"

Cuándo usarlo: Reels, Shorts y TikTok.
Cómo se ve: el cuadro 0 es la portada (shot hook en "@start", visible en t = 0). Subtítulo de hasta 3 palabras en 70 px, sin encabezado arriba, render a 30 fps y −14 LUFS. Con el perfil viral, la imagen ocupa la mitad de arriba y el avatar la de abajo; rosto toma la pantalla. Publicar exige APROVADO_REEL con el sha del MP4.
"aspect": "9:16",
"reel_profile": "divulgacao" | "tutorial" | "mini-aula",
"profile_visual": "viral" # opcionalTodo lo que Explicavideos ya produjo: 8 producciones y más de 90 videos montados, con el avatar y la voz de Nei, capítulos y subtítulos.
Situación al 05/10/2026. Cada video se publica en cuanto pasa las verificaciones.