Commands
run
Corre el pipeline completo de punta a punta, desde la fuente de video hasta el artículo final.
Sintaxis
ogacai run <fuente> [opciones]
<fuente> puede ser una URL de video o la ruta a un archivo de subtítulos ya descargado.
Propósito
Encadena todas las etapas del pipeline en un solo comando: descarga la transcripción (si le pasaste una URL), la procesa, genera el artículo con el proveedor de IA configurado, lo valida y escribe el .md final – más su portada, si el extra correspondiente está instalado y no se desactivó explícitamente.
Ejemplos
# Caso más simple
ogacai run "<fuente-de-video>" --output-dir ./mi-blog
# Si ya tenés el archivo de subtítulos descargado
ogacai run ./salida/transcripcion.json3 --output-dir ./mi-blog
# Elegir el proveedor de IA para esta corrida puntual
ogacai run "<fuente-de-video>" --proveedor gemini --output-dir ./mi-blog
# Elegir también el modelo puntual de ese proveedor
ogacai run "<fuente-de-video>" --proveedor workers-ai --model "@cf/google/gemma-4-26b-a4b-it"
# Artículo más largo de lo normal
ogacai run "<fuente-de-video>" --escala 2
# Ver qué se generaría, sin escribir nada en disco
ogacai run "<fuente-de-video>" --dry-run
# Saltar la generación de portada
ogacai run "<fuente-de-video>" --sin-portada
# Saltar el enriquecimiento con contexto adicional
ogacai run "<fuente-de-video>" --sin-contexto-youtube
# Ver el texto exacto que se le manda a la IA
ogacai run "<fuente-de-video>" --ver-input
# Subtítulos en otro idioma
ogacai run "<fuente-de-video>" --lang en
# Quitar muletillas antes de generar
ogacai run "<fuente-de-video>" --sin-muletillas
Todas las opciones se pueden combinar en la misma corrida.
Opciones
| Opción | Qué hace |
|---|---|
--output-dir |
Carpeta de salida del artículo (y portada) |
--proveedor |
Proveedor de IA a usar en esta corrida (deepseek, workers-ai, gemini) |
--model |
Modelo puntual del proveedor elegido |
--escala N |
Multiplica el presupuesto de tokens de salida por N (ver Longer articles) |
--dry-run |
Corre el pipeline sin escribir archivos finales |
--sin-portada |
No genera la imagen de portada, aunque esté configurada |
--sin-contexto-youtube |
No agrega contexto adicional del video de origen |
--ver-input |
Muestra el texto exacto enviado al proveedor de IA antes de enviarlo |
--lang |
Idioma de los subtítulos a descargar (por defecto es) |
--sin-muletillas |
Quita muletillas comunes en español antes de generar |
Archivos de entrada
Una URL de video, o un archivo de subtítulos ya descargado.
Archivos de salida
Un artículo .md con front matter validado, y opcionalmente su imagen de portada, en la carpeta indicada por --output-dir (o la configurada por defecto – ver Configuration reference).
Relación con otras etapas
Es un atajo que encadena fetch (si corresponde) → procesar → generar → validar → portada. Cada una también se puede correr por separado – ver How the pipeline works.