Démarrer avec EDDI

Prérequis

• Docker (recommandé) ou Java 25+
• Une clé API de fournisseur LLM (OpenAI, Anthropic, Google Gemini ou une instance Ollama locale)

1. Installer et démarrer EDDI

Le moyen le plus rapide de lancer EDDI est l'installeur en une commande. Il met en place EDDI + votre base de données au choix via Docker Compose, déploie un agent de démarrage et vous guide à travers la configuration :

curl -fsSL https://raw.githubusercontent.com/labsai/EDDI/main/install.sh | bash

iwr -useb https://raw.githubusercontent.com/labsai/EDDI/main/install.ps1 | iex

docker compose up

EDDI sera disponible à l'adresse http://localhost:7070.

2. Connectez-vous via MCP

Si vous utilisez Claude Desktop ou tout client compatible MCP, ajoutez EDDI comme serveur MCP :

{
  "mcpServers": {
    "eddi": {
      "url": "http://localhost:7070/mcp"
    }
  }
}

Vous pouvez désormais interagir avec les 42 outils MCP d'EDDI directement depuis votre assistant IA.

3. Stockez votre clé API

Avant de créer un agent, stockez en toute sécurité la clé API de votre fournisseur LLM dans le Secrets Vault d'EDDI (chiffré AES-256-GCM) :

curl -X PUT http://localhost:7070/secretstore/secrets/default/my-anthropic-key \
  -H "Content-Type: application/json" \
  -d '{"value": "sk-ant-your-actual-key", "description": "Anthropic API key"}'

💡 Astuce : La syntaxe ${eddivault:my-anthropic-key} fait référence au Secrets Vault intégré d'EDDI. La clé maître du vault est auto-générée par l'installateur. Pour des tests rapides, vous pouvez aussi passer les clés API directement : apiKey: "sk-ant-...".

4. Créez votre premier agent

Utilisez setup_agent pour créer un agent fonctionnel en un seul appel — via MCP ou REST API :

setup_agent(
  agentName: "My first agent",
  systemPrompt: "You are a helpful assistant that answers questions clearly.",
  provider: "anthropic",
  model: "claude-sonnet-4-6",
  apiKey: "${eddivault:my-anthropic-key}"
)

curl -X POST http://localhost:7070/administration/agents/setup \
  -H "Content-Type: application/json" \
  -d '{
    "agentName": "My first agent",
    "systemPrompt": "You are a helpful assistant that answers questions clearly.",
    "provider": "anthropic",
    "model": "claude-sonnet-4-6",
    "apiKey": "${eddivault:my-anthropic-key}"
  }'

Cela crée les règles, la configuration LLM, le workflow, l'agent et le déploie — le tout en une seule étape.

5. Discutez avec votre agent

chat_with_agent(agentId: "<your-agent-id>", message: "Hello! What can you do?")

# Start a conversation and send a message
curl -X POST http://localhost:7070/agents/<your-agent-id>/start \
  -H "Content-Type: application/json" \
  -d '{"input": "Hello! What can you do?"}'

Options d'Installation

Le script d'installation prend en charge des flags pour des configurations automatisées et personnalisées :

• --defaults — Tous les paramètres par défaut, sans questions
• --db=postgres — Utiliser PostgreSQL au lieu de MongoDB
• --with-auth — Activer l'authentification Keycloak
• --full — Tout activé (base de données + auth + monitoring)
• --local — Construire l'image Docker depuis la source locale (pour les contributeurs)

Mettre à jour EDDI

L'installateur crée un wrapper CLI eddi. Pour récupérer la dernière image et redémarrer :

eddi update

Si le CLI n'est pas disponible, exécutez depuis votre répertoire d'installation (~/.eddi) :

cd ~/.eddi
docker compose --env-file .env -f docker-compose.yml pull
docker compose --env-file .env -f docker-compose.yml up -d

Déploiement Kubernetes

Déployez sur Kubernetes avec une seule commande :

kubectl apply -f https://raw.githubusercontent.com/labsai/EDDI/main/k8s/quickstart.yaml

Des overlays Kustomize et des charts Helm sont également disponibles pour MongoDB, PostgreSQL, auth, monitoring et renforcement de production (HPA, PDB, NetworkPolicy). Voir le Guide Kubernetes.

Quarkus SDK

Vous construisez une app Quarkus ? Utilisez l'extension quarkus-eddi pour Dev Services, API fluide, streaming SSE et pont MCP :

<dependency>
    <groupId>io.quarkiverse.eddi</groupId>
    <artifactId>quarkus-eddi</artifactId>
    <version>6.0.0</version>
</dependency>