wehub-resource-sync
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
76 lines
3.3 KiB
Markdown
76 lines
3.3 KiB
Markdown
---
|
|
title: Examples
|
|
description: 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/`](https://github.com/opensandbox-group/OpenSandbox/tree/main/examples) directory on GitHub.
|
|
:::
|
|
|
|
## Coding Agents
|
|
|
|
Run coding CLIs and AI agent frameworks inside isolated sandboxes.
|
|
|
|
| Example | Description |
|
|
|---------|-------------|
|
|
| [Claude Code](/examples/claude-code) | Run Claude Code CLI in a sandbox |
|
|
| [Gemini CLI](/examples/gemini-cli) | Run Gemini CLI in a sandbox |
|
|
| [Codex CLI](/examples/codex-cli) | Run OpenAI Codex CLI in a sandbox |
|
|
| [Qwen Code](/examples/qwen-code) | Run Qwen Code CLI in a sandbox |
|
|
| [Kimi CLI](/examples/kimi-cli) | Run Kimi CLI (Moonshot AI) in a sandbox |
|
|
| [LangGraph](/examples/langgraph) | LangGraph state-machine workflow with sandbox |
|
|
| [Google ADK](/examples/google-adk) | Google ADK agent using OpenSandbox tools |
|
|
| [OpenClaw](/examples/openclaw) | OpenClaw Gateway inside a sandbox |
|
|
| [NullClaw](/examples/nullclaw) | NullClaw Gateway sandbox integration |
|
|
|
|
## Browser & Desktop
|
|
|
|
Execute browser workloads and host desktop environments in sandboxes.
|
|
|
|
| Example | Description |
|
|
|---------|-------------|
|
|
| [Chrome](/examples/chrome) | Chromium sandbox with VNC and DevTools |
|
|
| [Playwright](/examples/playwright) | Playwright + Chromium headless testing |
|
|
| [Desktop](/examples/desktop) | Full desktop environment with VNC |
|
|
| [VS Code](/examples/vscode) | VS Code Web (code-server) in a sandbox |
|
|
|
|
## Core Usage
|
|
|
|
Fundamental sandbox operations and SDK workflows.
|
|
|
|
| Example | Description |
|
|
|---------|-------------|
|
|
| [Code Interpreter](/examples/code-interpreter) | End-to-end Code Interpreter SDK workflow |
|
|
| [AIO Sandbox](/examples/aio-sandbox) | All-in-One sandbox setup |
|
|
| [Agent Sandbox](/examples/agent-sandbox) | Kubernetes agent-sandbox integration |
|
|
| [AKS + Kata](/examples/aks-kata) | AKS deployment with Kata VM isolation, ingress, egress, and Credential Vault |
|
|
| [Windows](/examples/windows) | Windows sandbox via KVM/QEMU |
|
|
| [RL Training](/examples/rl-training) | DQN CartPole reinforcement learning |
|
|
| [Harbor Evaluation](/examples/harbor-evaluation) | Run a Harbor agent evaluation, one sandbox per trial |
|
|
|
|
## Storage
|
|
|
|
Persistent and shared storage patterns for sandboxes.
|
|
|
|
| Example | Description |
|
|
|---------|-------------|
|
|
| [Host Volume Mount](/examples/host-volume-mount) | Mount host directories into sandboxes |
|
|
| [Docker PVC Volume](/examples/docker-pvc-volume-mount) | Docker named volume mounts |
|
|
| [Docker OSSFS Volume](/examples/docker-ossfs-volume-mount) | Docker OSSFS (OSS FUSE) mounts |
|
|
| [Kubernetes PVC](/examples/kubernetes-pvc-volume-mount) | Kubernetes PersistentVolumeClaim mounts |
|
|
|
|
## How to Run
|
|
|
|
1. Start the OpenSandbox server (see [Quick Start](/getting-started/))
|
|
2. Set environment variables: `export SANDBOX_DOMAIN=...`, `export SANDBOX_API_KEY=...`
|
|
3. Add provider-specific variables as needed (e.g., `ANTHROPIC_AUTH_TOKEN`, `OPENAI_API_KEY`)
|
|
4. 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.
|
|
:::
|