Examples
OpenSandbox provides ready-to-run examples covering SDK usage, agent integrations, browser automation, and training workloads.
TIP
All example source code is available in the examples/ directory on GitHub.
Coding Agents
Run coding CLIs and AI agent frameworks inside isolated sandboxes.
| Example | Description |
|---|---|
| Claude Code | Run Claude Code CLI in a sandbox |
| Gemini CLI | Run Gemini CLI in a sandbox |
| Codex CLI | Run OpenAI Codex CLI in a sandbox |
| Apply Model Patches | Apply Codex-style file patches with a custom sandbox image |
| OpenCode | Run the OpenCode coding agent in a sandbox |
| Qwen Code | Run Qwen Code CLI in a sandbox |
| Kimi CLI | Run Kimi CLI (Moonshot AI) in a sandbox |
| LangGraph | LangGraph state-machine workflow with sandbox |
| Deep Agents | Deep Agents file/shell tools running in a sandbox |
| Google ADK | Google ADK agent using OpenSandbox tools |
| OpenClaw | OpenClaw Gateway inside a sandbox |
| DeerFlow | DeerFlow agent turns with tools running in a sandbox |
Browser & Desktop
Execute browser workloads and host desktop environments in sandboxes.
| Example | Description |
|---|---|
| Chrome | Chromium sandbox with VNC and DevTools |
| Playwright | Playwright + Chromium headless testing |
| Desktop | Full desktop environment with VNC |
| VS Code | VS Code Web (code-server) in a sandbox |
Core Usage
Fundamental sandbox operations and SDK workflows.
| Example | Description |
|---|---|
| Code Interpreter | End-to-end Code Interpreter SDK workflow |
| Scheduled Client Pool | Adjust idle capacity by business hours using Go's pool Resize API |
| AIO Sandbox | All-in-One sandbox setup |
| Agent Sandbox | Kubernetes agent-sandbox integration |
| AKS + Kata | AKS deployment with Kata VM isolation, ingress, egress, and Credential Vault |
| Windows | Windows sandbox via KVM/QEMU |
| Harbor Evaluation | Run a Harbor agent evaluation, one sandbox per trial |
Storage
Persistent and shared storage patterns for sandboxes.
| Example | Description |
|---|---|
| Host Volume Mount | Mount host directories into sandboxes |
| Docker PVC Volume | Docker named volume mounts |
| Docker OSSFS Volume | Docker OSSFS (OSS FUSE) mounts |
| rclone Volume Mount | Remote storage through external Docker plugins or Kubernetes CSI volumes |
| Kubernetes PVC | Kubernetes PersistentVolumeClaim mounts |
How to Run
- Start the OpenSandbox server (see Quick Start)
- Set environment variables:
export SANDBOX_DOMAIN=...,export SANDBOX_API_KEY=... - Add provider-specific variables as needed (e.g.,
ANTHROPIC_AUTH_TOKEN,OPENAI_API_KEY) - Navigate to the example directory and run:
python main.py
TIP
Most examples include a main.py entry point. Follow each example's run instructions for other languages. Some also include a Dockerfile for containerized execution.