PTENES
Videos explicativos · INEMA

Transforma contenido en explicación

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

Nei Maldaner, avatar de la plantilla de HeyGen usada en los videos explicativos
Qué es

Una producción que puedes retomar

El guion, la generación, el montaje y la entrega tienen estados y archivos propios.

▶ Contenido completo

Cada tema apunta a su fuente y sus escenas. OSWork cubre los 48 temas, ejemplos y ejercicios.

▶ Nei explica

La plantilla aprobada de HeyGen conserva el avatar y la voz. Las ilustraciones siguen los tiempos medidos del habla.

▶ Entrega verificable

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.

Cómo funciona

De la fuente al reproductor

Los scripts se encargan de las etapas repetitivas. La revisión editorial y visual se realiza antes de escalar.

Fuente y guion→ Avatar e ilustraciones→ Verificación y entrega
Requisitos previos

Entorno de producción

Esta versión usa el entorno INEMA. Para otra máquina, ajusta las rutas de la configuración y los adaptadores.

Herramientas y accesos

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 status
Guía de uso · paso a paso

Produce con una configuración

El ejemplo de OSWork ya está preparado. Si hay una ejecución iniciada, consulta el estado en lugar de generar otro manifiesto.

1

Prepara y haz seguimiento

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
2

Preparar

Solo antes de iniciar la generación.

python3 explica.py --config examples/oswork.json prepare
3

Revisar

Vista previa sin audio para revisar los diagramas.

python3 explica.py preview
python3 engine/check_layouts.py
4

Ejecutar

Cinco servicios persistentes continúan activos después de cerrar la terminal.

python3 explica.py start
5

Seguir

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
Formato v2 · animación explicativa

El visual explica lo que Nei está diciendo

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.

Escena v2: sistema OSWork con piezas conectadas al núcleo

21 elementos animados

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.

Escena v2: modelos separados por función en pistas

Señales habladas, nunca segundos

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.

v1 preservado

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
Formatos · 16:9 y 9:16

Cuatro formatos, una grabación del avatar

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.

Formato 16:9 viral: imagen a pantalla completa, número grande y avatar en un recuadro abajo a la derecha

16:9 viral

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.

Formato 16:9 clase: fondo oscuro, tarjetas a la izquierda y avatar pequeño arriba a la derecha

16:9 clase

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.

Formato 9:16 simple: escena de la clase arriba y avatar en la franja de abajo

9:16 simple

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"
Formato 9:16 reel viral: portada a pantalla completa en el cuadro 0, luego imagen arriba y avatar en la mitad de abajo

9:16 reel

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"   # opcional
Ejemplos

El origen del método

Todo 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.

LOOP-R

5 rutas en PT, EN y ES, ~17 min cada una, animación explicativa (v2).

Ver

OSWork v6.2

8 módulos en PT, EN y ES, ~16 min cada uno, en v1 y v2.

Ver

OSWork completo

El curso entero en un video de 66 min, con capítulos.

Ver

OSWork Quick

Versión rápida en PT, EN y ES, ~30 min cada una.

Ver

Astra Básico

Videos completos en tres idiomas, ~17 min cada uno.

Ver Astra

IA Cultivada

Video de 10 min en portugués, en v1 y v2.

Ver

Codex × Claude

Comparativo de 6 min en portugués, en v1 y v2.

Ver

Shorts de eventos

9 shorts verticales 9:16 de 30 a 40 s: AGI Ready, JEV, RSI, WebMCP y otros.

Ver
Hoja de ruta

Producción en curso

Situación al 05/10/2026. Cada video se publica en cuanto pasa las verificaciones.

Hecho
LOOP-R completo15 videos publicados: 5 rutas en portugués, inglés y español, cerca de 4h13 en total.
Ahora
OSWork v6.221 de 24 videos listos; faltan los módulos 3 y 6 en portugués y el 6 en inglés.
Hecho
OSWork completo, Quick, Astra, IA Cultivada, Codex × Claude y shortsGenerados, sincronizados, verificados y publicados, con MP4 y subtítulos SRT.