Getting Started

Installation

Cómo instalar ogacai y sus extras opcionales de descarga y portada.

Requisitos

Python 3.9 o superior.

Paquete base

pip install ogacai

Con esto ya funcionan los comandos que no dependen de descargar contenido ni generar imágenes: procesar, generar, validar, config.

Extras opcionales

Dos partes del pipeline dependen de paquetes adicionales, instalables como extras de pip:

# Para que "fetch" y "run" puedan descargar la transcripción por su cuenta
pip install "ogacai[fetch]"

# Para que "portada" pueda generar la imagen de portada del artículo
pip install "ogacai[portada]"

# Las dos juntas
pip install "ogacai[fetch,portada]"

Si no instalás [fetch], igual podés usar ogacai pasándole un archivo de transcripción que ya tengas descargado por otro medio. Si no instalás [portada], el pipeline genera el artículo igual, simplemente sin imagen de portada.

Verificar la instalación

ogacai --help

Si ves la lista de subcomandos (run, fetch, procesar, preview, generar, validar, portada, config), la instalación quedó lista.

¿Qué instala cada extra, técnicamente?

[fetch] agrega el cliente de descarga de subtítulos. [portada] agrega las librerías de procesamiento de imágenes usadas para componer el PNG de 1200×630. Ninguno de los dos es necesario para el núcleo del pipeline (procesar → generar → validar).