OGI Transform Registry

OGI를 위한 커뮤니티 변환(transform) 모음입니다. OGI는 오픈소스 OSINT 및 링크 분석 도구입니다.

작동 방식

transforms/ 아래의 각 디렉터리는 독립적으로 설치 가능한 변환입니다. OGI CLI와 Transform Hub UI는 index.json (각 병합 시 자동 생성됨)을 읽어 사용 가능한 변환을 탐색합니다.

변환 설치

OGI 백엔드 프로젝트의 CLI를 사용하세요:

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

또는 OGI 내부의 Transform Hub UI를 사용하세요.

런타임 최대치 재정의

이 레지스트리의 커뮤니티 변환은 OGI의 호스트 측 변환 최대치 재정의를 상속합니다. 운영자는 백엔드 환경 변수를 통해 max_results, max_urls, max_links, max_content_chars 또는 timeout_seconds와 같은 일반적인 최대 설정을 중앙에서 제한하거나 제거할 수 있습니다:

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

로컬 배포에서 최대치를 제거하려면:

OGI_TRANSFORM_SETTING_MAX_OVERRIDES=max_results=none,max_content_chars=none

이는 이 레지스트리 저장소가 아닌 주요 OGI 앱에서 구성됩니다.

내장 변환 (OGI와 함께 제공)

변환 기여하기

1. 이 저장소를 포크하세요
2. transforms/<category>/<slug>/ 아래에 변환을 추가하세요
3. plugin.yaml, README.md, transforms/*.py를 포함하세요
4. 필수 비밀(secrets)은 transform_settings가 아닌 api_keys_required에 선언하세요
5. PR을 열면 CI가 자동으로 검증합니다

최대치 설정을 추가할 때는 설정이 실제로 변환별로 특화된 경우가 아니라면 max_results, max_urls, max_links, max_content_chars 또는 timeout_seconds와 같은 일반적인 이름을 선호하세요. 이렇게 하면 생태계 전반에서 운영자 측 재정의가 예측 가능하게 유지됩니다.

전체 가이드는 CONTRIBUTING.md를 참조하세요.

라이선스

AGPLv3