Canal dark · documentário sem rosto
Do tema ao YouTube, sem passo manual
Você escreve o tema em 6 linhas. O docflow faz o roteiro, as imagens, os vídeos, a narração, a montagem e a publicação.
Você escreve o tema em 6 linhas. O docflow faz o roteiro, as imagens, os vídeos, a narração, a montagem e a publicação.
O docflow é uma ferramenta de linha de comando que cria documentários curtos narrados, do tipo usado em canais "dark" do YouTube, em que não aparece ninguém. Você responde 6 perguntas num arquivo (tema, estilo, duração, duração de cada cena, formato e referências) e ele faz o resto: escreve o roteiro, gera as imagens e os vídeos de cada cena, narra, monta com música e transições e publica no YouTube. Ele recria, de forma automática, um processo que normalmente se faz à mão no ChatGPT, no Google Flow e no CapCut. Para usar, você precisa de Linux com Python, ffmpeg e o Codex.
O ponto de partida foi um tutorial de canal dark: GPT para o roteiro, Google Flow para imagens e vídeos, AI Studio para a voz, Flow Music para a trilha, CapCut para a montagem e upload manual. O docflow faz as mesmas etapas sozinho.
As mesmas 6 perguntas do tutorial, respondidas num arquivo tema.yaml. O Codex (pela assinatura) devolve roteiro, narração, prompts de imagem e de vídeo numerados, prompt de música e título, descrição e tags.
Imagem e vídeo saem do Google Flow (automatizado no navegador) ou da API Agnes (imagem e imagem→vídeo, US$ 0). Narração, montagem e publicação são iguais para os dois.
Ajusta cada clipe ao tempo da fala, coloca transição entre cenas, fade do preto, som ambiente a 16% e música que abaixa sozinha quando a voz fala. Depois publica pelo yt-pubx.
Todas podem ser repetidas: refazem só o que falta. O material fica numerado por cena em ~/projetos/output/docflow/<slug>/.
Conta Google. Um robô (Playwright) abre o Flow, cola os blocos de prompts no agente, aprova, pede a coleção e baixa o zip. Escrito, ainda não validado: falta o primeiro login.
Imagens com agnes-image-2.1-flash e vídeo com agnes-video-v2.0 (imagem→vídeo), por API, a custo zero. Testado: fez o vídeo de exemplo.
Sem API: flux2-klein para imagem e imagem com movimento para vídeo. Ainda não implementado.
O docflow orquestra ferramentas que já existem. Confira antes do primeiro uso.
Python 3 com PyYAML para o orquestrador e ffmpeg para a montagem.
# conferir python3 -c "import yaml" ffmpeg -version
Escreve o roteiro pela sua assinatura. O modelo pode ser trocado pela variável DOCFLOW_CODEX_MODELO.
# conferir codex --version
inemavox no ar (porta 8010) para a narração, cliente Agnes do videos-agnes e o yt-pubx com o canal autorizado. Para o motor Flow: Node + Playwright.
# conferir ~/projetos/yt-pubx/yt-pubx canais
Exemplo real: o vídeo "Egito Antigo em um minuto", feito com o motor Agnes.
Copie temas/egito.yaml e troque o tema. 60 s de duração total com cenas de 10 s dá 6 cenas.
slug: egito-antigo tema: "O Egito Antigo em um minuto: do Nilo às pirâmides..." estilo: "realistic cinematic documentary, natural golden light" duracao_total: 60 duracao_cena: 10 formato: "16:9" motor: agnes # flow | agnes voz: nei thumb_cena: 3 # imagem usada na thumb canal: lives10
Roteiro, imagens, vídeos, narração e montagem. No exemplo levou cerca de 9 minutos.
./docflow tudo temas/egito.yaml # → ~/projetos/output/docflow/egito-antigo/final.mp4
Se o gerador de vídeo mudar a época ou a arquitetura de uma cena, troque o clipe pela própria imagem com zoom lento e monte de novo.
./docflow estatica temas/egito.yaml --cenas 6 ./docflow montar temas/egito.yaml
Título, descrição (com o rodapé do projeto, das APIs usadas e do INEMA.CLUB), tags e thumb. Nada sobe nesta etapa.
./docflow publicar temas/egito.yaml # dry-run
Depois de assistir e aprovar a thumb, envie. Para corrigir a descrição de um vídeo que já está no ar, use descricao --video.
./docflow publicar temas/egito.yaml --enviar ./docflow descricao temas/egito.yaml --video https://www.youtube.com/watch?v=...
O robô abre um Chromium no display virtual :99. Você entra na conta Google pelo VNC (localhost:5900) e aceita os termos do Flow. A primeira rodada calibra os botões, com um print de cada passo em tmp/flow-*.png.
./docflow flow-login ./docflow gerar temas/egito.yaml --motor flow
6 cenas, 55 s, voz nei, motor Agnes. Publicado em youtube.com/watch?v=TsVY4UUc5gI.
thumb_cena: 3).Versão 0.2.0.