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) → procesargenerarvalidarportada. Cada una también se puede correr por separado – ver How the pipeline works.