Quick Start

Get up and running with Capsule Agents in just a few minutes using Docker.

Prerequisites

Docker installed on your system.

Quick Start with Docker

1. Create Environment File

Create a .env file with your AI provider API key. You need at least one provider key:

# Choose at least one provider
OPENAI_API_KEY=sk-your-openai-key
ANTHROPIC_API_KEY=sk-ant-your-anthropic-key
GOOGLE_GENERATIVE_AI_API_KEY=your-google-key

# Recommended: Basic auth for the editor + API
ADMIN_PASSWORD=your-secure-password

2. Run the Container

docker run \
  --env-file .env \
  -e AGENT_URL=http://localhost:8080 \
  -p 8080:9000 \
  -it brycewcole/capsule-agents:latest

3. Access Your Agent

Once the container starts, you can access:

Editor UI (chat + config): http://localhost:8080/editor
A2A endpoint (JSON-RPC): http://localhost:8080/
A2A Agent Card: http://localhost:8080/.well-known/agent-card.json

That’s it! Your agent is now running and ready to use.

Customizing Your Agent

Using the Configuration UI

Open http://localhost:8080/editor and log in as admin
Modify your agent’s:
- Name and description
- AI model and parameters
- Built-in tools (exec, file operations, memory)
- System prompts
Click “Save” to apply changes

Next Steps

Learn about advanced configuration options
Explore the examples directory for:
- Basic single-agent setups
- MCP server integration (Context7 + GitHub)
- Multi-agent deployments
- Development environment with observability