---

Hinweis: Dieses Projekt entwickelt sich aktiv weiter. Es verfügt über solide Kernfunktionen und Testabdeckung, und wir verbessern mit jedem Release kontinuierlich die Dokumentation, Härtung und Funktionstiefe. Beiträge, Fehlermeldungen und Rückmeldungen sind sehr willkommen.

Funktionen

• Visuelle Graphenuntersuchung — Entitäten per Drag-and-Drop verschieben, Verbindungen interaktiv erkunden
• 20+ integrierte Transforms — DNS, WHOIS, SSL-Zertifikate, Geolokalisierung, Web-/E-Mail-/Hash-/Social-Anreicherung und mehr
• Transform-Hub — Community-Transforms aus der Registry durchsuchen und installieren
• KI-Ermittler — promptgesteuerte agentische Untersuchungen, die Transform-Abläufe planen, Fortschritte live streamen und Ergebnisse mit Nachvollziehbarkeit zusammenfassen
• Import / Export — Import im JSON-, CSV-, GraphML- und MTGX-Format
• Graphenanalyse — Zentralität, Gemeinschaftserkennung, kürzeste Pfade
• Echtzeit-Zusammenarbeit — Projekte, Teilen und Live-Synchronisation über Supabase Realtime
• Asynchrone Transform-Jobs — Redis/RQ-Warteschlange mit WebSocket-Fortschrittsaktualisierungen
• Plugin-System — verzeichnisbasierte Plugin-Erkennung mit YAML-Manifesten
• CLI-Werkzeug — Transforms über das Terminal suchen, installieren und verwalten
• Läuft überall — lokaler SQLite-Modus (null Konfiguration) oder PostgreSQL + Supabase für Team-/Cloud-Setups
• Docker-bereit — Ein-Kommando-Bereitstellung mit docker compose up

Bildschirmfotos

Schnellstart

Voraussetzungen

Werkzeug	Version
Python	3.14+
uv	latest
Node.js	20+
pnpm	latest

Backend```bash

cd backend uv sync uv run uvicorn ogi.main:app --reload

Die API wird unter `http://localhost:8000` verfügbar sein.

Für die lokale Transform-Ausführung müssen Redis und der transform worker ebenfalls laufen. Redis allein reicht nicht.```bash
docker run -d --name ogi-redis -p 6379:6379 redis:7-alpine

Starten Sie den Transform-Worker in einem zweiten Terminal:```bash cd backend uv run python -m ogi.worker.run_worker

Falls Sie `Job queue not available` oder `Redis not available` sehen, überprüfen Sie Folgendes:

- `OGI_REDIS_URL` zeigt auf `redis://localhost:6379/0` für lokale host-basierte Ausführungen
- das Backend wurde neu gestartet, nachdem Redis hochgefahren war
- der separate Worker-Prozess läuft
- Sie verwenden nicht den Docker-exklusiven Hostnamen `redis` außerhalb von Docker Compose

Wenn Sie das Backend gegen PostgreSQL betreiben (`OGI_USE_SQLITE=false`), wendet der Start automatisch Alembic-Migrationen an, bevor Anfragen bedient werden. Docker-Bereitstellungen machen dasselbe im Backend-Container-Entrypoint.

AI Investigator-Läufe werden von einem weiteren separaten Worker verarbeitet:```bash
cd backend
uv run python -m ogi.agent.run_worker

Frontend```bash

cd frontend pnpm install pnpm dev

Öffne http://localhost:5173. Das war's.

### KI-Ermittler

Der KI-Ermittler ist ein optionaler, anbieterunterstützter Workflow, der Transformationssequenzen planen, Genehmigungen anfordern und den Untersuchungsfortschritt im Arbeitsbereich zusammenfassen kann.

- Öffnen Sie den Reiter `AI Investigator` in einem Projekt
- Konfigurieren Sie einen Anbieter und ein Modell im Ermittlereinstellungsdialog
- Speichern Sie Anbieter-API-Schlüssel unter `API Keys`
- Führen Sie den separaten `agent-worker`-Prozess zusammen mit dem Backend aus

Die aktuelle Implementierung unterstützt pro Benutzer konfigurierbare Anbieter und einen dedizierten Worker, der Untersuchungsschritte unabhängig vom Haupt-API-Server ausführt.

### CLI

Zwei unterstützte Möglichkeiten zur Ausführung der CLI:

**Empfohlen** (keine Aktivierung erforderlich):```bash
cd backend
uv sync
uv run ogi --help

Aktiviertes virtualenv (einfacher ogi-Befehl):```bash cd backend uv venv

PowerShell:

..venv\Scripts\Activate.ps1 uv pip install -e . ogi --help

## Docker

### Entwicklung```bash
cp .env.example .env
docker compose up

Produktion

Verwenden Sie die vorgefertigten GHCR-Images.

Wichtig: docker-compose.prod.yml erfordert eine externe PostgreSQL-Datenbank. Es enthält keinen db-Dienst.

Wenn Sie den All-in-One lokalen Docker-Stapel mit integriertem Postgres und Redis verwenden möchten, verwenden Sie:```bash docker compose up -d

Verwenden Sie die Produktions-Compose-Datei nur, wenn Sie bereits eine erreichbare PostgreSQL-Instanz haben und `OGI_DATABASE_URL` entsprechend gesetzt haben:```bash
docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d

Setzen Sie OGI_IMAGE_TAG in .env, um einen bestimmten Release-Image-Tag festzulegen (z.B. v0.2.6). Standardmäßig wird latest verwendet.

Hetzner Cloud