Run the full AgentKit ecosystem with a single command
Docker Compose setup for AgentLens, AgentGate, and Lore.
Zero local setup — open the whole stack in a cloud dev environment (a thin
devcontainer with Docker-in-Docker; it seeds
.env for you, then just docker compose up -d):
Or locally:
git clone https://github.com/agentkitai/agentkit-stack.git
cd agentkit-stack
cp .env.example .env # then edit .env and set real secrets
docker compose up -dAll four services pull pinned images from GHCR (ghcr.io/agentkitai). Secrets are read from
.env (gitignored); docker compose up will refuse to start until the
required keys in .env are set.
Run only the slice you need with Compose profiles:
| Profile | Services | For |
|---|---|---|
minimal |
AgentLens, Lore (+ Lore DB) | Observability + memory |
governance |
minimal + AgentGate |
Compliance: approval gateway / guardrails |
full |
alias of governance |
Everything (the default) |
docker compose --profile minimal up -d # leanest
docker compose --profile governance up -d # + approval gateway
docker compose up -d # full (COMPOSE_PROFILES=full in .env)The default docker compose up activates full via COMPOSE_PROFILES in
.env — set it to minimal or governance there to change the default.
| Service | Port | Image | Description |
|---|---|---|---|
| AgentLens | 3000 | ghcr.io/agentkitai/agentlens:latest |
Observability dashboard |
| AgentGate | 3002 | ghcr.io/agentkitai/agentgate:latest |
Approval gateway |
| Lore | 8765 | ghcr.io/agentkitai/lore:latest |
Semantic memory (pgvector) |
| Lore DB | — | pgvector/pgvector:pg16 |
PostgreSQL + pgvector |
docker pull ghcr.io/agentkitai/agentlens:latest # dashboard + server
docker pull ghcr.io/agentkitai/agentgate:latest # approval gateway
docker pull ghcr.io/agentkitai/lore:latest # semantic memorycurl http://localhost:3000/api/health/overview # AgentLens
curl http://localhost:3002/health # AgentGate
curl http://localhost:8765/health # LoreBy default every service pulls a pinned image from GHCR. To build any of
them from a local checkout instead, uncomment that service's build: lines in
docker-compose.yml (each expects the sibling repo checked out alongside this
one), then:
docker compose up -d --builddocker compose down # stop containers
docker compose down -v # stop + remove volumes (data loss!)Contributions are welcome! Fork the repo, make your changes, and open a pull request. For major changes, open an issue first to discuss what you'd like to change.
| Project | Description | |
|---|---|---|
| AgentLens | Observability & audit trail for AI agents | |
| Lore | Cross-agent memory and lesson sharing | |
| AgentGate | Human-in-the-loop approval gateway | |
| FormBridge | Agent-human mixed-mode forms | |
| AgentEval | Testing & evaluation framework | |
| agentkit-cli | Unified CLI orchestrator | |
| agentkit-stack | Full-stack Docker Compose setup | ⬅️ you are here |