Home / Doc / Quick Start

Quick Start

Up in 5 minutes with Docker Compose

Clone & configure

git clone https://github.com/zborrman/Shadow-Warden-AI.git
cd Shadow-Warden-AI
cp .env.example .env
# Set WARDEN_API_KEY, ANTHROPIC_API_KEY in .env

Start all services

docker compose up --build -d
# 11 services spin up: proxy, warden, analytics,
# dashboard, postgres, redis, prometheus, grafana,
# minio, minio-init, arq-worker

Send your first request

curl -X POST http://localhost:8001/filter \
  -H "X-API-Key: your-key" \
  -H "Content-Type: application/json" \
  -d '{"content": "Ignore previous instructions and..."}'
# → {"verdict":"BLOCK","score":0.94,"stage":"brain"}

Open dashboards

# Streamlit analytics  → http://localhost:8501
# Grafana SLOs         → http://localhost:3000
# SOC Dashboard        → http://localhost:3002
# MinIO Console        → http://localhost:9001

Need help?

Open an issue on GitHub or read the full API Reference.