OGI Transform Registry

Community-Transforms für OGI, ein Open-Source-OSINT- und Linkanalyse-Tool.

Wie es funktioniert

Jedes Verzeichnis unter transforms/ ist ein unabhängig installierbares Transform. Die OGI CLI und die Transform Hub UI lesen index.json (bei jedem Merge automatisch generiert), um zu erkennen, was verfügbar ist.

Ein Transform installieren

Verwenden Sie die CLI aus dem OGI-Backend-Projekt:

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

Oder verwenden Sie die Transform Hub UI in OGI.

Laufzeitbegrenzungs-Überschreibungen

Community-Transforms in diesem Registry erben OGI's hostseitige Transform-Begrenzungsüberschreibungen. Betreiber können zentral gängige Max-Einstellungen wie max_results, max_urls, max_links, max_content_chars oder timeout_seconds mit der Backend-Umgebungsvariablen begrenzen oder entfernen:

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

Um eine Begrenzung in einer lokalen Bereitstellung zu entfernen:

OGI_TRANSFORM_SETTING_MAX_OVERRIDES=max_results=none,max_content_chars=none

Dies wird in der Haupt-OGI-App konfiguriert, nicht in diesem Registry-Repository.

Integrierte Transforms (werden mit OGI ausgeliefert)

Ein Transform beitragen

1. Forken Sie dieses Repository
2. Fügen Sie Ihr Transform unter transforms/<category>/<slug>/ hinzu
3. Fügen Sie plugin.yaml, README.md und transforms/*.py hinzu
4. Deklarieren Sie erforderliche Secrets in api_keys_required, nicht in transform_settings
5. Öffnen Sie einen PR – CI validiert automatisch

Wenn Sie begrenzte Einstellungen hinzufügen, bevorzugen Sie allgemeine Namen wie max_results, max_urls, max_links, max_content_chars oder timeout_seconds, es sei denn, die Einstellung ist wirklich transformspezifisch. Das hält die betreiberseitigen Überschreibungen im gesamten Ökosystem vorhersagbar.

Siehe CONTRIBUTING.md für die vollständige Anleitung.

Lizenz

AGPLv3