Démarrer avec EDDI

Prérequis

• Docker (recommandé) ou Java 25+. Sur les hôtes x86-64, l'image EDDI nécessite un processeur x86-64-v3 (Intel Haswell, AMD Excavator ou plus récent)
• 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, génère une clé de chiffrement pour le vault et vous guide à travers la configuration :

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

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/labsai/EDDI/main/install.ps1" -OutFile "install.ps1"
Unblock-File .\install.ps1
.\install.ps1

git clone https://github.com/labsai/EDDI.git
cd EDDI
docker compose up

docker compose -f docker-compose.yml -f docker-compose.ollama.yml up -d

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

2. Connectez-vous via MCP

Connectez votre assistant IA aux 84 outils MCP d'EDDI. La configuration dépend du support de transport de votre client :

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

{
  "mcpServers": {
    "eddi": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "http://localhost:7070/mcp"]
    }
  }
}

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

📖 Consultez la documentation du serveur MCP pour la référence complète des outils et la configuration avancée.

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 ${vault: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: "${vault: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": "${vault: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.

Vous préférez une conversation ou un formulaire ? Une installation neuve démarre sans aucun agent déployé. Ouvrez le Platform Operator sur http://localhost:7070/manage/operator et décrivez l'agent souhaité, chaque modification attendant votre approbation, ou remplissez l'assistant de création d'agent sur http://localhost:7070/manage/agents/wizard.

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
• --with-monitoring, Ajouter le monitoring Prometheus et Grafana
• --full, Tout activé (base de données + auth + monitoring)
• --eddi-version=6.4.0, Fixer une version précise d'EDDI
• --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 le chart Helm (2.0.0) sont également disponibles pour MongoDB, PostgreSQL, auth, monitoring et renforcement de production (HPA, PDB, NetworkPolicy). Voir le Guide Kubernetes.