Registro de Transformaciones OGI

Transformaciones comunitarias para OGI, una herramienta OSINT y de análisis de enlaces de código abierto.

Cómo funciona

Cada directorio bajo transforms/ es una transformación instalable de forma independiente. La CLI de OGI y la interfaz de Transform Hub leen index.json (generado automáticamente en cada fusión) para descubrir lo que está disponible.

Instalar una transformación

Usa la CLI desde el proyecto backend de OGI:

cd backend
uv sync
uv run ogi transform search shodan
uv run ogi transform install shodan-host-lookup

O usa la interfaz de Transform Hub dentro de OGI.

Anulaciones de límites en tiempo de ejecución

Las transformaciones comunitarias en este registro heredan las anulaciones de límites de transformación del lado del servidor de OGI. Los operadores pueden limitar o eliminar de forma centralizada configuraciones máximas comunes como max_results, max_urls, max_links, max_content_chars o timeout_seconds mediante la variable de entorno del backend:

OGI_TRANSFORM_SETTING_MAX_OVERRIDES=max_results=50,max_urls=25,max_links=40

Para eliminar un límite en una implementación local:

OGI_TRANSFORM_SETTING_MAX_OVERRIDES=max_results=none,max_content_chars=none

Esto se configura en la aplicación principal de OGI, no en este repositorio de registro.

Transformaciones integradas (incluidas con OGI)

Contribuir con una transformación

1. Haz un fork de este repositorio
2. Añade tu transformación bajo transforms/<category>/<slug>/
3. Incluye plugin.yaml, README.md y transforms/*.py
4. Declara los secretos requeridos en api_keys_required, no en transform_settings
5. Abre un PR - CI valida automáticamente

Al agregar configuraciones limitadas, prefiere nombres comunes como max_results, max_urls, max_links, max_content_chars o timeout_seconds a menos que la configuración sea genuinamente específica de la transformación. Esto mantiene las anulaciones del lado del operador predecibles en todo el ecosistema.

Consulta CONTRIBUTING.md para la guía completa.

Licencia

AGPLv3