---

Attention : Ce projet est en évolution active. Il possède des capacités de base solides et une couverture de tests, et nous continuons d'améliorer la documentation, le durcissement et la profondeur des fonctionnalités à chaque version. Les contributions, signalements de bugs et retours sont les bienvenus.

Fonctionnalités

• Investigation graphique visuelle — glisser-déposer des entités, explorer les connexions de manière interactive
• Plus de 20 transforms intégrés — DNS, WHOIS, certificats SSL, géolocalisation, enrichissement web/email/hash/social, et plus encore
• Hub de transforms — parcourir et installer les transforms de la communauté depuis le registre
• Investigateur IA — enquêtes agentiques pilotées par requête qui planifient les exécutions de transforms, diffusent la progression en direct et résument les résultats avec traçabilité
• Import / Export — import aux formats JSON, CSV, GraphML et MTGX
• Analyse de graphes — centralité, détection de communautés, chemins les plus courts
• Collaboration en temps réel — projets, partage et synchronisation en direct via Supabase Realtime
• Tâches de transform asynchrones — file d'attente Redis/RQ avec mises à jour de progression WebSocket
• Système de plugins — découverte de plugins basée sur des répertoires avec des manifestes YAML
• Outil en ligne de commande — rechercher, installer et gérer les transforms depuis le terminal
• Fonctionne partout — mode SQLite local (zéro configuration) ou PostgreSQL + Supabase pour les configurations en équipe/cloud
• Prêt pour Docker — déploiement en une commande avec docker compose up

Captures d'écran

Démarrage rapide

Prérequis

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

Backend```bash

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

L'API sera disponible à l'adresse `http://localhost:8000`.

Pour l'exécution locale des transformations, Redis et le worker de transformation doivent également être en cours d'exécution. Redis seul ne suffit pas.

Démarrer Redis :```bash
docker run -d --name ogi-redis -p 6379:6379 redis:7-alpine

Démarrez le worker de transformation dans un second terminal :```bash cd backend uv run python -m ogi.worker.run_worker

Si vous voyez `Job queue not available` ou `Redis not available`, vérifiez que :

- `OGI_REDIS_URL` pointe vers `redis://localhost:6379/0` pour les exécutions locales basées sur l'hôte
- le backend a été redémarré après le démarrage de Redis
- le processus worker séparé est en cours d'exécution
- vous n'utilisez pas le nom d'hôte `redis` propre à Docker en dehors de Docker Compose

Si vous exécutez le backend avec PostgreSQL (`OGI_USE_SQLITE=false`), le démarrage appliquera automatiquement les migrations Alembic avant de servir les requêtes. Les déploiements Docker font de même dans le point d'entrée du conteneur backend.

Les exécutions de l'IA Investigator sont traitées par un autre worker séparé :```bash
cd backend
uv run python -m ogi.agent.run_worker

Frontend```bash

cd frontend pnpm install pnpm dev

Open http://localhost:5173. C'est tout.

### AI Investigator

AI Investigator est un workflow optionnel adossé à un fournisseur qui peut planifier des séquences de transformation, demander des approbations et résumer l'avancement des investigations dans l'espace de travail.

- Ouvrez l'onglet `AI Investigator` dans un projet
- Configurez un fournisseur et un modèle dans la boîte de dialogue des paramètres de l'investigateur
- Stockez les clés API du fournisseur dans `API Keys`
- Exécutez le processus séparé `agent-worker` en parallèle du backend

L'implémentation actuelle prend en charge la configuration par utilisateur du fournisseur et un worker dédié qui exécute les étapes d'investigation indépendamment du serveur API principal.

### CLI

Deux méthodes prises en charge pour exécuter la CLI :

**Recommandé** (aucune activation requise) :```bash
cd backend
uv sync
uv run ogi --help

Virtualenv activé (commande ogi simple) :```bash cd backend uv venv

PowerShell:

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

## Docker

### Développement```bash
cp .env.example .env
docker compose up

Production

Utilisez les images GHCR préconstruites.

Important : docker-compose.prod.yml nécessite une base de données PostgreSQL externe. Il n'inclut pas de service db.

Si vous souhaitez la pile Docker locale tout-en-un avec Postgres et Redis intégrés, utilisez :```bash docker compose up -d

Utilisez le fichier compose de production uniquement lorsque vous avez déjà une instance PostgreSQL accessible et que vous avez défini `OGI_DATABASE_URL` en conséquence :```bash
docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d

Définissez OGI_IMAGE_TAG dans .env pour épingler une balise d'image de version spécifique (par ex. v0.2.6). Par défaut, latest.

Hetzner Cloud