Cloud Sandbox Extension Examples

These examples are for manual verification of the cloud sandbox backends that live under agents.extensions.sandbox.

They intentionally keep the flow simple:

1. Build a tiny manifest in memory.
2. Create a SandboxAgent that inspects that workspace through one shell tool.
3. Run the agent against E2B, Modal, Daytona, Cloudflare, Runloop, Blaxel, or Vercel.

All of these examples require OPENAI_API_KEY, because they call the model through the normal Runner path. Each cloud backend also needs its own provider credentials.

E2B

Setup

Install the repo extra:

uv sync --extra e2b

Create an E2B account, create an API key, and export it as E2B_API_KEY. The official setup docs are:

• https://e2b.dev/docs/api-key
• https://e2b.dev/docs/quickstart

Export the required environment variables:

export OPENAI_API_KEY=...
export E2B_API_KEY=...

Run

uv run python examples/sandbox/extensions/e2b_runner.py --stream

Useful flags:

• --sandbox-type e2b_code_interpreter