O processo usado no Astra e no OSWork Quick, organizado para produzir novas explicações com avatar, ilustrações e legendas.

Roteiro, geração, montagem e entrega têm estados e arquivos próprios.
Cada tópico aponta para sua fonte e suas cenas. O OSWork tem cobertura dos 48 tópicos, exemplos e exercícios.
O template aprovado do HeyGen preserva avatar e voz. Ilustrações acompanham os tempos medidos da fala.
Áudio, duração, legendas e reprodução são conferidos antes do MP4, player e aviso no bot v3.
Scripts cuidam das etapas repetitivas. Revisão editorial e visual acontece antes de escalar.
Esta versão usa o ambiente INEMA. Para outra máquina, ajuste os caminhos da configuração e dos adaptadores.
Python, Node, FFmpeg, GitHub CLI, systemd, perfil autenticado no HeyGen e credenciais de consulta/transcrição carregadas em runtime.
# comando
python3 --version
node --version
ffmpeg -version
gh auth statusO exemplo OSWork já está preparado. Em uma execução iniciada, consulte status em vez de gerar outro manifesto.
Copie a configuração para um novo projeto e revise fonte, destino e idioma. Cada etapa preserva seus resultados.
python3 explica.py --config examples/oswork.json status # mostra geração, downloads, render e publicação
Somente antes de iniciar a geração.
python3 explica.py --config examples/oswork.json prepare
Prévia sem áudio para conferir os diagramas.
python3 explica.py preview python3 engine/check_layouts.py
Cinco serviços persistentes continuam após fechar o terminal.
python3 explica.py start
Estados e logs mostram o que ocorreu de fato.
python3 explica.py status journalctl --user -u explica-oswork-completo-submit -n 20 --no-pager
No v2, cada cena tem um roteiro visual com deixas faladas: quando a fala diz "entrada, modelo, saída", o fluxo aparece; quando diz "não existe melhor modelo", o pódio desmorona e o radar de critérios encaixa o modelo adequado. O avatar e o áudio são reaproveitados, sem nova geração no HeyGen.

hub, pipeline, fluxo, radar, pódio, trilhas, comparação, chat, terminal, árvore de pastas, ficha, laboratório, quiz, linha do tempo e mais, em engine/v2/runtime.

O roteiro usa trechos literais da fala; o build resolve cada deixa pela transcrição real e acusa lacunas acima de 10 s. A legenda usa a grafia do roteiro.
O motor v1 (explica.py, engine/*.py) segue igual e continua disponível para produções e melhorias. A versão anterior do OSWork fica no release video-v1.0.0.
# roteiro 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 # reaproveita avatar, transcrição e tempos do v1 python3 engine/v2/build_block.py 1 --strict # deixas → tempos; 0 avisos engine/v2/run_lane.sh 1 2 3 # check + render verificado por bloco python3 engine/assemble_languages.py && python3 engine/publish_finished.py
A mesma fala do Nei vira vídeo horizontal ou vertical, em perfil de aula ou viral. Escolha pelo assunto: aula para curso e projeto; viral para notícia, número, clima e reel. O formato vem só da config v2.

Quando usar: notícia, número, clima, vídeo para o YouTube que precisa prender.
Como fica: o quadro 0 é a capa, com imagem impactante e título grande já na arte. Depois, imagem do Codex em tela cheia trocando a cada 1,5–3 s, número gigante (bignum) e gráficos em tela cheia (ranking, barra, mapa). O avatar fica numa caixa com moldura âmbar no canto inferior direito e cresce para tela cheia nos shots rosto. Legenda grande de 1–3 palavras, com a palavra falada em âmbar.
"profile_visual": "viral"
Regras e QA (qa_viral.py): engine/v2/PADRAO-VIRAL.md.

Quando usar: curso, projeto, explicação passo a passo.
Como fica: fundo escuro, área útil à esquerda (x 90–1420) com cartões e diagramas montados pelos 21 primitivos (fluxo, radar, terminal, comparação…). O avatar fica pequeno no canto superior direito, com CENA n/N e o cartão PARA LEVAR embaixo. A legenda acompanha a fala.
# padrão do v2: sem profile_visual
"engine": "v2"Roteiro visual: engine/v2/AUTHORING.md.

Quando usar: versão vertical de uma aula ou short informativo (30–40 s).
Como fica: as cenas continuam desenhadas em 1920×1080 e são escaladas para o topo. O avatar 16:9 recortado ocupa a faixa de baixo. A coluna direita (CENA n/N, PARA LEVAR) não aparece: use "takeaway": false. Legenda de 46 px em 2 linhas na zona segura.
"aspect": "9:16"

Quando usar: Reels, Shorts e TikTok.
Como fica: o quadro 0 é a capa (shot hook em "@start", visível em t = 0). Legenda de até 3 palavras em 70 px, sem cabeçalho no topo, render a 30 fps e −14 LUFS. Com o perfil viral, a imagem ocupa a metade de cima e o avatar a metade de baixo; rosto toma a tela. Publicar exige APROVADO_REEL com o sha do MP4.
"aspect": "9:16",
"reel_profile": "divulgacao" | "tutorial" | "mini-aula",
"profile_visual": "viral" # opcionalTudo o que o Explicavideos já produziu: 8 produções e mais de 90 vídeos montados, com avatar e voz do Nei, capítulos e legendas.
9 shorts verticais 9:16 de 30 a 40 s: AGI Ready, JEV, RSI, WebMCP e outros.
AssistirSituação em 05/10/2026. Cada vídeo é publicado assim que passa nas verificações.