Getting Started

First Article

Generar un artículo corriendo cada etapa del pipeline por separado, para inspeccionar el resultado intermedio.

ogacai run es cómodo, pero corre todo de una. Esta guía separa cada etapa para que veas qué produce cada una – útil la primera vez, o cuando algo no sale como esperabas.

1. Descargar la transcripción

ogacai fetch "<fuente-de-video>" --salida-dir ./salida

Produce un archivo de subtítulos crudo en ./salida. Ningún proveedor de IA interviene en este paso.

2. Procesar y limpiar

ogacai procesar ./salida/<archivo> --salida-dir ./textos

Genera dos archivos de texto plano: uno con la extracción fiel de los subtítulos y otro ya limpio (sin anotaciones como [música], sin repeticiones). Es el segundo el que se le manda a la IA. Tampoco llama a ningún proveedor – es gratis e instantáneo.

3. (Opcional) Revisar qué se descartó

ogacai preview ./salida/<archivo>

Muestra en pantalla qué se descartó al limpiar, sin escribir archivos. Sirve para confirmar que la limpieza no se comió algo importante antes de gastar una llamada a la IA.

4. Generar el artículo

ogacai generar ./textos/transcripcion_clean.txt --output ./mi-blog/articulo.md

Acá sí se llama al proveedor de IA configurado (por defecto, DeepSeek).

5. Validar

ogacai validar ./mi-blog/articulo.md

Confirma que el front matter y la estructura Markdown estén correctos.

Cuándo conviene este camino en vez de run

Cuando querés inspeccionar o ajustar el texto de entrada antes de gastar cuota de la IA, o cuando estás depurando un resultado que no te convenció y necesitás aislar en qué etapa está el problema.