Avenox Studio — roteador do operador
Guia rápido do operador para um pipeline de vídeo local-first operado por agente. Tudo roda na sua própria máquina: sem editor em nuvem, sem upload para renderizar.
O humano dirige e aprova a qualidade; o agente opera o pipeline.
Configuração
export STUDIO_JOBS="$HOME/video/projects" # mídia pesada fica aqui
export STUDIO_ROOT="/caminho/para/este/repo" # scripts, templates, marca
Requisitos: macOS (codificação de hardware via h264_videotoolbox; Apple Silicon para mlx-whisper), ffmpeg, python3, melt/MLT, Node (para HyperFrames). A maior parte funciona no Linux com libx264 e uma compilação CUDA do whisper substituída.
Princípios operacionais
- Disciplina de mídia. Mídia pesada NUNCA em uma pasta sincronizada com nuvem — a sincronização vai travar em intermediários de vários GB e pode corromper escritas em andamento. Os jobs ficam em
$STUDIO_JOBS/<job>/(raw/ cut/ graphics/ audio/ outputs/). Seu sistema de anotações guarda apenas o cérebro: este sistema, a especificação de marca, os planosedit.json. - Loop do diretor. Produza um preview (stills dos gráficos + uma renderização rápida do rascunho) → envie para anotações → só então renderize o final. Nunca envie um final sem aprovação. Esta é a regra mais importante; um agente que renderiza finais não revisados queimará horas em um corte rejeitado.
- Marca é uma restrição rígida, não uma sugestão. Leia
marca/moldura.mdantes de criar qualquer gráfico. Defina uma vez e tranque. (A implementação de referência é deliberadamente anti-"AI slop": editorial premium, papel quente + tinta + um único acento, sem neon/gradiente/glassmorfismo/brilho-3D.) - Formato: YouTube 16:9 1080p60. Predefinição em
marca/presets/youtube-16x9.json. - Finalização é híbrida. Gere o rascunho automaticamente; o mesmo
.mltabre no Kdenlive ou Shotcut para finalização manual. Não tente automatizar o gosto. - Transcrição padrão é LOCAL
mlx-whispercomwhisper-large-v3-turbo— rápida, gratuita e forte em áudio não-inglês. Observe que a maioria dos proxies de roteamento de LLM não expõe endpoint whisper; se for remoto, use uma API de fala dedicada.
Scripts (scripts/)
| Script | Faz |
|---|---|
autocut.sh IN.mp4 [balanced|aggressive|conservative] | corte silencioso → _cut.xml (Premiere) ou variantes --export |
transcribe.py IN.mp4 PREFIXO | → transcricao/PREFIXO_timed.json + _narration.txt |
mltgen.py edit.json out.mlt --base <dir-job> | lista de edição → projeto MLT (Kdenlive/Shotcut/melt) |
vrender.sh project.mlt out.mp4 [fast|quality] | renderizar (fast = rascunho HW, quality = master CRF18) |
grabshot.sh | captura de tela da área de transferência → disco |
slides2png.sh | slides estáticos legados — prefira HyperFrames |
remove-silence.py | passagem de silêncio independente |
As 7 etapas
- Captura — copie o raw →
$STUDIO_JOBS/<job>/raw/. Confirme o briefing e quais segmentos realmente importam. - Corte bruto —
autocut.sh raw.mov balanced→cut/screen_cut.mp4;transcribe.pypara o roteiro. Receita completa → habilidadeavenox-roughcut. - Gráficos — HyperFrames. Roteie pela habilidade
hyperframes→ geralmentemotion-graphics(trechos curtos),faceless-explainer(trechos de conceito) ougeneral-video. Leiamarca/moldura.mdprimeiro; renderize MP4s animados emgraphics/. Receita completa → habilidadeavenox-graphics. - Montagem — escreva
edit.json(modelo emtemplates/edit.json) misturandocut/*.mp4+graphics/*.mp4+ música →mltgen.py edit.json project.mlt --base <dir-job>. - Legendas —
transcribe.py→.srt; apliquemarca/caption-corrections.json(copie decaption-corrections.example.json— um mapa de localizar/substituir para termos que seu ASR corrompe consistentemente). Envie como CC do YouTube, não embutido. - Música — base sob tudo, sidechain-duck sob a voz, alvo ~-14 LUFS. Atribuição de trilha em
CREDITS.md. - Exportação —
vrender.sh project.mlt draft.mp4 fast→ revisão do diretor →vrender.sh … final.mp4 quality→ podar arquivos temporários.
Padrão de qualidade dos gráficos
Os clipes HyperFrames devem obedecer a marca/moldura.md. Prefira movimento tipográfico, contido e com peso. Se uma batida não precisar de movimento, um quadro estático limpo é suficiente — não anime por animar.
Referência
- Corte bruto:
avenox-roughcut· Gráficos:avenox-graphics - Habilidades HyperFrames:
hyperframes(roteador),hyperframes-cli,hyperframes-animation,hyperframes-creative,motion-graphics,faceless-explainer,general-video - Especificação de marca:
marca/moldura.md(preencher a partir demarca/moldura.template.md)