---

Attenzione: Questo progetto è in evoluzione attiva. Dispone di solide capacità principali e copertura dei test, e continuiamo a migliorare la documentazione, l'irrobustimento e la profondità delle funzionalità con ogni release. Contributi, segnalazioni di bug e feedback sono molto graditi.

Funzionalità

• Investigazione visiva a grafo — entità drag-and-drop, esplora connessioni in modo interattivo
• 20+ trasformazioni integrate — DNS, WHOIS, certificati SSL, geolocalizzazione, arricchimento web/email/hash/social e altro
• Hub dei Trasform — esplora e installa trasformazioni della comunità dal registry
• Investigatore AI — investigazioni agentive guidate da prompt che pianificano esecuzioni di trasformazioni, trasmettono l'avanzamento in tempo reale e riassumono i risultati con verificabilità
• Importa / Esporta — importazione in formato JSON, CSV, GraphML e MTGX
• Analisi del grafo — centralità, rilevamento di comunità, percorsi più brevi
• Collaborazione in tempo reale — progetti, condivisione e sincronizzazione live tramite Supabase Realtime
• Job di trasformazione asincroni — coda Redis/RQ con aggiornamenti di avanzamento via WebSocket
• Sistema di plugin — rilevamento plugin basato su directory con manifest YAML
• Strumento CLI — cerca, installa e gestisci trasformazioni dal terminale
• Funziona ovunque — modalità SQLite locale (zero configurazione) o PostgreSQL + Supabase per configurazioni team/cloud
• Pronto per Docker — distribuzione con un comando con docker compose up

Screenshot

Avvio rapido

Prerequisiti

Strumento	Versione
Python	3.14+
uv	ultima
Node.js	20+
pnpm	ultima

Backend```bash

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

L'API sarà disponibile all'indirizzo `http://localhost:8000`.

Per l'esecuzione locale delle trasformazioni, devono essere in esecuzione anche Redis e il worker di trasformazione. Redis da solo non basta.

Avvia Redis:```bash
docker run -d --name ogi-redis -p 6379:6379 redis:7-alpine

Avvia il worker di trasformazione in un secondo terminale:```bash cd backend uv run python -m ogi.worker.run_worker

Se vedi `Job queue not available` o `Redis not available`, verifica che:

- `OGI_REDIS_URL` punti a `redis://localhost:6379/0` per esecuzioni locali basate su host
- il backend sia stato riavviato dopo l'avvio di Redis
- il processo worker separato sia in esecuzione
- non stai usando il nome host Docker-only `redis` al di fuori di Docker Compose

Se esegui il backend con PostgreSQL (`OGI_USE_SQLITE=false`), l'avvio applicherà automaticamente le migrazioni di Alembic prima di servire le richieste. Le distribuzioni Docker fanno lo stesso nel punto di ingresso del container backend.

Le esecuzioni di AI Investigator sono elaborate da un altro worker separato:```bash
cd backend
uv run python -m ogi.agent.run_worker

Frontend```bash

cd frontend pnpm install pnpm dev

Apri http://localhost:5173. Tutto qui.

### AI Investigator

AI Investigator è un flusso di lavoro opzionale basato su provider che può pianificare sequenze di trasformazione, richiedere approvazioni e riassumere i progressi dell'investigazione all'interno del workspace.

- Apri la scheda `AI Investigator` all'interno di un progetto
- Configura un provider e un modello nella finestra di dialogo delle impostazioni dell'investigatore
- Conserva le chiavi API del provider in `API Keys`
- Esegui il processo separato `agent-worker` insieme al backend

L'implementazione attuale supporta la configurazione del provider per utente e un worker dedicato che esegue i passaggi dell'investigazione in modo indipendente dal server API principale.

### CLI

Due modalità supportate per eseguire la CLI:

**Consigliato** (nessuna attivazione richiesta):```bash
cd backend
uv sync
uv run ogi --help

Virtualenv attivato (comando ogi semplice):```bash cd backend uv venv

PowerShell:

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

## Docker

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

Produzione

Utilizza le immagini GHCR precompilate.

Importante: docker-compose.prod.yml richiede un database PostgreSQL esterno. Non include un servizio db.

Se desideri lo stack Docker locale tutto-in-uno con Postgres e Redis integrati, usa:```bash docker compose up -d

Usa il file compose di produzione solo quando hai già un'istanza PostgreSQL raggiungibile e hai impostato `OGI_DATABASE_URL` di conseguenza:```bash
docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d

Set OGI_IMAGE_TAG in .env per fissare un tag specifico di release dell'immagine (ad es. v0.2.6). L'impostazione predefinita è latest.

Hetzner Cloud