sandbox-agent/examples/cloudflare
Shelley f547cfe7f1 fix: guard server startup to avoid port conflicts
Add health check before starting sandbox-agent to prevent 'address already
in use' errors on subsequent requests. The isServerRunning() function probes
the health endpoint to determine if setup should be skipped.

Co-authored-by: Shelley <shelley@exe.dev>
2026-02-03 00:29:44 +00:00
..
src fix: guard server startup to avoid port conflicts 2026-02-03 00:29:44 +00:00
.gitignore docs: add Cloudflare Sandbox SDK deployment guide 2026-02-02 20:31:48 +00:00
package.json docs: add Cloudflare Sandbox SDK deployment guide 2026-02-02 20:31:48 +00:00
README.md docs: add Cloudflare Sandbox SDK deployment guide 2026-02-02 20:31:48 +00:00
tsconfig.json docs: add Cloudflare Sandbox SDK deployment guide 2026-02-02 20:31:48 +00:00
wrangler.jsonc docs: add Cloudflare Sandbox SDK deployment guide 2026-02-02 20:31:48 +00:00

Cloudflare Sandbox Agent Example

Deploy sandbox-agent inside a Cloudflare Sandbox.

Prerequisites

  • Cloudflare account with Workers Paid plan
  • Docker running locally for wrangler dev
  • ANTHROPIC_API_KEY or OPENAI_API_KEY for the coding agents

Setup

  1. Install dependencies:
pnpm install
  1. Create .dev.vars with your API keys:
echo "ANTHROPIC_API_KEY=your-api-key" > .dev.vars

Development

Start the development server:

pnpm run dev

Test the endpoint:

curl http://localhost:8787

Deploy

pnpm run deploy

Note: Production preview URLs require a custom domain with wildcard DNS routing. See Cloudflare Production Deployment for details.