Reference
Troubleshooting
Problemas comunes y cómo resolverlos, organizados por etapa del pipeline.
La descarga de subtítulos falla
Confirmá que instalaste el extra [fetch] (pip install "ogacai[fetch]") – sin él, fetch y run no pueden descargar nada. Si ya lo tenés instalado, probá ogacai fetch sola para aislar el problema antes de sospechar del resto del pipeline (ver Debugging).
El artículo generado le faltan datos o los inventa
Revisá primero la transcripción de origen con ogacai preview: si el dato faltante nunca estuvo en los subtítulos, no va a aparecer en el artículo – es el comportamiento esperado, no un bug (ver AI generation). Si sospechás que el modelo inventó algo que no está en la transcripción, es un caso a reportar: la política del proyecto es explícitamente no rellenar huecos.
"ogacai config set" rechaza una clave que debería existir
La lista de claves válidas es cerrada a propósito (ver Configuration reference). Revisá que no haya un error de tipeo – por ejemplo, workers_ai.account_id con guion bajo, no workers-ai.account_id con guion medio.
La generación falla y no sé por qué proveedor está pasando
Corré ogacai config show para confirmar qué proveedor y modelo está usando realmente esa corrida (recordá que una bandera --proveedor explícita gana sobre lo guardado en config). Si tenés más de un proveedor configurado, run te va a ofrecer fallback interactivo – pero solo en una terminal interactiva, no en un script no atendido (ver Fallback).
"ogacai validar" marca un error de estructura
El mensaje de error indica qué campo o regla específica no se cumplió (ver Front matter). Recordá que la validación es puramente estructural: un artículo puede pasar validar y aun así tener contenido que preferirías ajustar editorialmente – eso queda fuera del alcance del comando.
"ogacai portada" no genera nada
Confirmá que instalaste el extra [portada] (pip install "ogacai[portada]"). Sin él, el pipeline genera el artículo igual, simplemente sin imagen de portada, y run no lo trata como error a menos que hayas forzado la etapa explícitamente.
Si nada de esto resuelve el problema
Aislá la etapa exacta donde falla corriendo cada comando por separado en vez de run – ver Debugging y How the pipeline works.