e0e362d700
SDK Tests / changes (push) Waiting to run
SDK Tests / Python SDK Tests (sandbox) (push) Blocked by required conditions
SDK Tests / CLI Quality (push) Blocked by required conditions
SDK Tests / CLI Tests (push) Blocked by required conditions
SDK Tests / Python SDK Quality (code-interpreter) (push) Blocked by required conditions
SDK Tests / Python SDK Quality (sandbox) (push) Blocked by required conditions
SDK Tests / Python SDK Tests (code-interpreter) (push) Blocked by required conditions
SDK Tests / JavaScript SDK Quality And Tests (code-interpreter) (push) Blocked by required conditions
SDK Tests / JavaScript SDK Quality And Tests (sandbox) (push) Blocked by required conditions
Deploy Docs Pages / build (push) Waiting to run
Deploy Docs Pages / deploy (push) Blocked by required conditions
Real E2E Tests / changes (push) Waiting to run
Real E2E Tests / Python E2E (docker bridge) (push) Blocked by required conditions
Real E2E Tests / Java E2E (docker bridge) (push) Blocked by required conditions
Real E2E Tests / JavaScript E2E (docker bridge) (push) Blocked by required conditions
Real E2E Tests / C# E2E (docker bridge) (push) Blocked by required conditions
Real E2E Tests / Go E2E (docker bridge) (push) Blocked by required conditions
Real E2E Tests / Real E2E CI (push) Blocked by required conditions
SDK Tests / Kotlin SDK Quality And Tests (sandbox) (push) Blocked by required conditions
SDK Tests / Kotlin SDK Quality And Tests (code-interpreter) (push) Blocked by required conditions
SDK Tests / C# SDK Quality And Tests (code-interpreter) (push) Blocked by required conditions
SDK Tests / C# SDK Quality And Tests (sandbox) (push) Blocked by required conditions
SDK Tests / Go SDK Quality And Tests (push) Blocked by required conditions
SDK Tests / SDK CI (push) Blocked by required conditions
3.3 KiB
3.3 KiB
title, description
| title | description |
|---|---|
| Examples | Real-world usage examples for OpenSandbox covering coding agents, browser automation, desktop environments, and training workloads. |
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 |
| AKS + Kata | AKS deployment with Kata VM isolation, ingress, egress, and Credential Vault |
| Windows | Windows sandbox via KVM/QEMU |
| RL Training | DQN CartPole reinforcement learning |
| 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 |
| 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.
:::