Deployment

Three deployment models: local-only (default), Docker Compose, and AWS CDK.

Local-only (default)

No backend needed. Traces are stored in .spooled/traces/ and baselines are committed to git.

pip install spooled-ai
spooled init project
# That's it — run your agent and traces are stored locally

This is the recommended starting point. CI comparison works entirely from local files and git-committed baselines.

Docker Compose

For teams that want a shared trace store and the hosted dashboard:

# Set the backend URL
export SPOOLED_BACKEND_URL=http://localhost:8585
export SPOOLED_API_KEY=your-key

Traces are sent to the backend for centralized storage. The dashboard connects to the same backend.

AWS CDK

For production deployments with S3 storage and configurable retention.

API keys

API keys gate access to Pro features (CI automation, merge blocking, content-blind signals). Set via:

export SPOOLED_API_KEY=your-pro-license-key

Migration between models

Migration is non-destructive. Local traces remain in .spooled/traces/. Adding a backend URL starts sending structural metadata to the backend without affecting local storage.