Registre de transformations OGI

Transformations communautaires pour OGI, un outil open source d'OSINT et d'analyse de liens.

Comment ça fonctionne

Chaque répertoire sous transforms/ est une transformation installable indépendamment. L'interface CLI d'OGI et l'interface utilisateur Transform Hub lisent index.json (généré automatiquement à chaque fusion) pour découvrir ce qui est disponible.

Installer une transformation

Utilisez la CLI du projet backend OGI :

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

Ou utilisez l'interface utilisateur Transform Hub dans OGI.

Remplacements des limites d'exécution

Les transformations communautaires de ce registre héritent des remplacements de limites côté hôte d'OGI. Les opérateurs peuvent centralement limiter ou supprimer les paramètres maximum courants tels que max_results, max_urls, max_links, max_content_chars ou timeout_seconds avec la variable d'environnement backend :

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

Pour supprimer une limite dans un déploiement local :

OGI_TRANSFORM_SETTING_MAX_OVERRIDES=max_results=none,max_content_chars=none

Ceci est configuré dans l'application principale OGI, pas dans ce dépôt de registre.

Transformations intégrées (fournies avec OGI)

Contribuer une transformation

1. Forkez ce dépôt
2. Ajoutez votre transformation sous transforms/<category>/<slug>/
3. Incluez plugin.yaml, README.md et transforms/*.py
4. Déclarez les secrets requis dans api_keys_required, pas dans transform_settings
5. Ouvrez une PR - la CI valide automatiquement

Lors de l'ajout de paramètres limités, préférez des noms courants comme max_results, max_urls, max_links, max_content_chars ou timeout_seconds sauf si le paramètre est vraiment spécifique à une transformation. Cela maintient les remplacements côté opérateur prévisibles dans tout l'écosystème.

Voir CONTRIBUTING.md pour le guide complet.

Licence

AGPLv3