Tú escribes el tema en 6 líneas. docflow hace el guion, las imágenes, los videos, la narración, el montaje y la publicación.

docflow es una herramienta de línea de comandos que crea documentales cortos narrados, del tipo que se usa en los canales "dark" de YouTube, donde no aparece nadie. Respondes 6 preguntas en un archivo (tema, estilo, duración, duración de cada escena, formato y referencias) y él hace el resto: escribe el guion, genera las imágenes y los videos de cada escena, narra, monta con música y transiciones y publica en YouTube. Recrea, de forma automática, un proceso que normalmente se hace a mano en ChatGPT, en Google Flow y en CapCut. Para usarlo, necesitas Linux con Python, ffmpeg y Codex.
El punto de partida fue un tutorial de canal dark: GPT para el guion, Google Flow para imágenes y videos, AI Studio para la voz, Flow Music para la banda sonora, CapCut para el montaje y subida manual. docflow hace las mismas etapas solo.
Las mismas 6 preguntas del tutorial, respondidas en un archivo tema.yaml. Codex (con tu suscripción) devuelve guion, narración, prompts de imagen y de video numerados, prompt de música y título, descripción y etiquetas.
La imagen y el video salen de Google Flow (automatizado en el navegador) o de la API de Agnes (imagen e imagen→video, US$ 0). La narración, el montaje y la publicación son iguales para los dos.
Ajusta cada clip al tiempo del habla, pone transición entre escenas, fundido desde negro, sonido ambiente al 16% y música que baja sola cuando habla la voz. Después publica con yt-pubx.
Todas se pueden repetir: rehacen solo lo que falta. El material queda numerado por escena en ~/projetos/output/docflow/<slug>/.
Cuenta de Google. Un robot (Playwright) abre Flow, pega los bloques de prompts en el agente, aprueba, pide la colección y descarga el zip. Escrito, aún no validado: falta el primer inicio de sesión.
Imágenes con agnes-image-2.1-flash y video con agnes-video-v2.0 (imagen→video), por API, a costo cero. Probado: hizo el video de ejemplo.
Sin API: flux2-klein para imagen e imagen con movimiento para video. Aún no está implementado.
docflow orquesta herramientas que ya existen. Compruébalas antes del primer uso.
Python 3 con PyYAML para el orquestador y ffmpeg para el montaje.
# comprobar python3 -c "import yaml" ffmpeg -version
Escribe el guion con tu suscripción. El modelo se puede cambiar con la variable DOCFLOW_CODEX_MODELO.
# comprobar codex --version
inemavox en línea (puerto 8010) para la narración, cliente Agnes de videos-agnes y yt-pubx con el canal autorizado. Para el motor Flow: Node + Playwright.
# comprobar ~/projetos/yt-pubx/yt-pubx canais
Ejemplo real: el video "Egipto Antiguo en un minuto", hecho con el motor Agnes.
Copia temas/egito.yaml y cambia el tema. 60 s de duración total con escenas de 10 s dan 6 escenas.
slug: egito-antigo tema: "El Antiguo Egipto en un minuto: del Nilo a las 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 # imagen usada en la miniatura canal: lives10
Guion, imágenes, videos, narración y montaje. En el ejemplo tardó cerca de 9 minutos.
./docflow tudo temas/egito.yaml # → ~/projetos/output/docflow/egito-antigo/final.mp4
Si el generador de video cambia la época o la arquitectura de una escena, reemplaza el clip por la propia imagen con zoom lento y vuelve a montar.
./docflow estatica temas/egito.yaml --cenas 6 ./docflow montar temas/egito.yaml
Título, descripción (con el pie del proyecto, de las API usadas y de INEMA.CLUB), etiquetas y miniatura. En esta etapa no se sube nada.
./docflow publicar temas/egito.yaml # dry-run
Después de ver el video y aprobar la miniatura, envíalo. Para corregir la descripción de un video que ya está publicado, usa descricao --video.
./docflow publicar temas/egito.yaml --enviar ./docflow descricao temas/egito.yaml --video https://www.youtube.com/watch?v=...
El robot abre un Chromium en la pantalla virtual :99. Tú entras a la cuenta de Google por VNC (localhost:5900) y aceptas los términos de Flow. La primera ejecución calibra los botones, con una captura de cada paso en tmp/flow-*.png.
./docflow flow-login ./docflow gerar temas/egito.yaml --motor flow
6 escenas, 55 s, voz nei, motor Agnes. Publicado en youtube.com/watch?v=TsVY4UUc5gI.


thumb_cena: 3).Versión 0.2.0.