Registro Trasformazioni OGI

Trasformazioni della community per OGI, uno strumento open source di OSINT e analisi dei link.

Come funziona

Ogni directory sotto transforms/ è una trasformazione installabile indipendentemente. La CLI di OGI e l'interfaccia Transform Hub leggono index.json (generato automaticamente a ogni merge) per scoprire cosa è disponibile.

Installare una trasformazione

Usa la CLI dal progetto backend di OGI:

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

Oppure usa l'interfaccia Transform Hub all'interno di OGI.

Override dei limiti di esecuzione

Le trasformazioni della community in questo registro ereditano gli override dei limiti lato host di OGI. Gli operatori possono centralmente limitare o rimuovere impostazioni massime comuni come max_results, max_urls, max_links, max_content_chars o timeout_seconds con la variabile d'ambiente del backend:

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

Per rimuovere un limite in una distribuzione locale:

OGI_TRANSFORM_SETTING_MAX_OVERRIDES=max_results=none,max_content_chars=none

Questa configurazione è impostata nell'app principale di OGI, non in questo repository del registro.

Trasformazioni integrate (incluse in OGI)

Contribuire una trasformazione

1. Fai un fork di questo repository
2. Aggiungi la tua trasformazione sotto transforms/<categoria>/<slug>/
3. Includi plugin.yaml, README.md e transforms/*.py
4. Dichiara i segreti richiesti in api_keys_required, non in transform_settings
5. Apri una PR - CI valida automaticamente

Quando aggiungi impostazioni con limiti, preferisci nomi comuni come max_results, max_urls, max_links, max_content_chars o timeout_seconds, a meno che l'impostazione non sia strettamente specifica della trasformazione. Questo mantiene prevedibili gli override degli operatori in tutto l'ecosistema.

Vedi CONTRIBUTING.md per la guida completa.

Licenza

AGPLv3