Skip to content

Stromboli

Container orchestration API for Claude Code agents

Get Started • How It Works • API Reference • GitHub

What is Stromboli?

Stromboli wraps Claude Code in isolated Podman containers and exposes a REST API to spawn, manage, and orchestrate agents. You send a prompt over HTTP, Stromboli runs Claude in a sandboxed container with your code mounted, and returns the result.

graph LR
    A[Your Code] --> B[Stromboli API]
    B --> C[Podman]
    C --> D[Claude Agent Container]
    D --> E[Your Workspace]

Why Stromboli?

Isolation. Each agent runs in its own container with resource limits, volume allowlists, and network isolation. A runaway agent can't touch your host.

Any runtime. Use Python, Node, Go, or any Docker image as the agent's environment. Need a database? Use compose environments.

API-driven. Spawn agents from CI/CD pipelines, webhooks, scripts, or any HTTP client. No CLI needed.

Want the full picture? Read why Stromboli.

Quick example

curl -X POST http://localhost:8080/run \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Analyze this Go project and suggest improvements",
    "workdir": "/workspace",
    "podman": {
      "volumes": ["/home/user/myproject:/workspace"]
    }
  }'

{
  "id": "run-abc123",
  "status": "completed",
  "output": "I've analyzed the project...",
  "session_id": "550e8400-e29b-41d4-a716-446655440000"
}

Features

  • Container Isolation

    Each agent runs in its own Podman container with resource limits.

  • Secrets Management

    Inject tokens (GitHub, GitLab, etc.) via Podman's native secret store.

  • Session Persistence

    Continue conversations across requests with session management.

  • REST API

    HTTP API for spawning agents, managing jobs, and streaming output.

  • Lifecycle Hooks

    Install dependencies and start services before Claude runs.

  • Compose Environments

    Multi-service stacks with databases, caches, and more.

Get started

curl -sL https://raw.githubusercontent.com/tomblancdev/stromboli/main/install.sh | bash
cd stromboli
docker compose up -d
curl http://localhost:8080/health

Then head to the quick start guide to run your first agent.

License

Stromboli is open source under the MIT License.