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 |
| 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 |
| Google ADK | Google ADK agent using OpenSandbox tools |
| OpenClaw | OpenClaw Gateway inside a sandbox |
| NullClaw | NullClaw Gateway sandbox integration |
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 |
| AIO Sandbox | All-in-One sandbox setup |
| Agent Sandbox | Kubernetes agent-sandbox integration |
| Windows | Windows sandbox via KVM/QEMU |
| RL Training | DQN CartPole reinforcement learning |
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 |
| 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
Each example includes a main.py entry point. Some also include a Dockerfile for containerized execution.