EDDI

Prerequisites

Windows users: Replace ./mvnw with .\mvnw.cmd in all commands below.

Helm (renders the Secret itself, so the key is a required value). Local,

🐳 Docker Compose (Manual)

If you prefer manual control over Docker Compose:

```bash

docker-compose.yml (an overlay cannot un-declare the base's mongodb service)

docker compose -f docker-compose.postgres-only.yml up

header of docker-compose.auth.yml, or let install.sh --with-auth set one)

docker compose -f docker-compose.yml -f docker-compose.auth.yml up

With a local LLM — Ollama on the same Docker network, reachable as

http://ollama:11434 (no host.docker.internal needed)

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

Build & Docker

```bash

Build app + Docker image

./mvnw clean package '-Dquarkus.container-image.build=true'

Build without container (for install.sh --local)

./mvnw package -DskipTests

🏁 Quick Start

The fastest way to get EDDI running is the one-command installer. It sets up EDDI + your choice of database via Docker Compose and points you at the dashboard, where the Platform Operator (or the form-based agent wizard) creates your first AI agent for you.

Linux / macOS / WSL2:

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

Windows (PowerShell):

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

Requires Docker. The wizard auto-generates a unique vault encryption key for secret management.

Everything is served from one port: http://localhost:7070 opens a chooser between the Manager (/manage, the admin dashboard) and the Workforce workspace (/workforce, group conversations), and the standalone chat UI is at /chat. See Getting Started.

<details> <summary><strong>🔧 Installer options</strong></summary>

bash install.sh --defaults                 # All defaults, no prompts
bash install.sh --db=postgres --with-auth  # PostgreSQL + Keycloak
bash install.sh --full                     # Everything enabled (PostgreSQL + auth + monitoring)
bash install.sh --local                    # Build Docker image from local source
bash install.sh --eddi-version=6.5.0       # Pin a release (image and compose files from its tag)
bash install.sh --dry-run                  # Show the image tag and the git ref the files come from

With the default latest image, the compose files are downloaded from the newest release's tag (looked up through the GitHub API), not from main.

The --local flag is for contributors testing pre-release builds:

./mvnw package -DskipTests    # Build the Java app
bash install.sh --local        # Build Docker image + start containers

</details>

(MongoDB runs authenticated) or postgres-secrets — commands in the Kubernetes Guide

kubectl apply -k k8s/overlays/mongodb/ # MongoDB backend kubectl apply -k k8s/overlays/postgres/ # PostgreSQL backend

Quickstart (one-file manifest; same Secret step, see the Kubernetes Guide)

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

port-forward shape without OIDC: the two opt-ins are required, see the guide.

helm install eddi ./helm/eddi \ --set eddi.vaultMasterKey="$(openssl rand -base64 24)" \ --set mongodb.rootPassword="$(openssl rand -base64 24)" \ --set eddi.security.allowUnauthenticatedMcp=true \ --set eddi.security.allowUnauthenticatedSecretStore=true \ --namespace eddi --create-namespace ```

Includes overlays for auth (Keycloak), monitoring (Prometheus/Grafana), NATS messaging, Ingress, and production hardening (PDB, NetworkPolicy — deliberately no HPA). See the Kubernetes Guide for details, including the Keycloak upgrade note for existing installs.

---

⚙️ Configuration-Driven Architecture

• 📄 JSON Configs, Not Code — Agent behavior defined in versioned, diffable JSON documents
• 🔧 Lifecycle Pipeline — Pluggable task pipeline: Input → Parse → Rules → API/LLM → Output
• 📦 Composable Agents — Agents assembled from reusable, version-controlled workflows and extensions
• 🧪 Behavior Rules — IF-THEN logic engine for routing, orchestration, and business logic
• 📤 Import / Export — Agents portable as ZIP files with automatic secret scrubbing on export
• 🔄 Agent Sync — Live instance-to-instance sync with structural matching, content diffing, and selective resource picking — no ZIP intermediary needed
• 📝 Prompt Snippets — Reusable, versioned system prompt building blocks available as {snippets.safety_rules}
• 🌐 Global Variables — Deployment-wide values such as a default model, referenced as {vars.default-model} in any config (details)
• 📎 Content Type Routing — MIME-based behavior rule conditions for multimodal attachment routing

Maven Command Reference

<details> <summary><strong>Code coverage</strong></summary>

JaCoCo is configured to run automatically during ./mvnw test. After tests complete, find the coverage report at:

target/site/jacoco/index.html

</details>

<details> <summary><strong>Useful system properties</strong></summary>

</details>