Files
opensandbox-group--opensandbox/docs/examples/agent-sandbox.md
T
wehub-resource-sync e0e362d700
Deploy Docs Pages / build (push) Waiting to run
Deploy Docs Pages / deploy (push) Blocked by required conditions
Real E2E Tests / Real E2E CI (push) Blocked by required conditions
SDK Tests / SDK CI (push) Blocked by required conditions
SDK Tests / changes (push) Successful in 2m29s
Real E2E Tests / changes (push) Successful in 2m29s
Real E2E Tests / Python E2E (docker bridge) (push) Waiting to run
Real E2E Tests / C# E2E (docker bridge) (push) Waiting to run
Real E2E Tests / Go E2E (docker bridge) (push) Waiting to run
Real E2E Tests / Java E2E (docker bridge) (push) Waiting to run
Real E2E Tests / JavaScript E2E (docker bridge) (push) Waiting to run
SDK Tests / Python SDK Tests (sandbox) (push) Waiting to run
SDK Tests / CLI Quality (push) Waiting to run
SDK Tests / CLI Tests (push) Waiting to run
SDK Tests / Python SDK Quality (code-interpreter) (push) Waiting to run
SDK Tests / Python SDK Quality (sandbox) (push) Waiting to run
SDK Tests / Python SDK Tests (code-interpreter) (push) Waiting to run
SDK Tests / JavaScript SDK Quality And Tests (code-interpreter) (push) Waiting to run
SDK Tests / JavaScript SDK Quality And Tests (sandbox) (push) Waiting to run
SDK Tests / Kotlin SDK Quality And Tests (sandbox) (push) Waiting to run
SDK Tests / Kotlin SDK Quality And Tests (code-interpreter) (push) Waiting to run
SDK Tests / C# SDK Quality And Tests (code-interpreter) (push) Waiting to run
SDK Tests / C# SDK Quality And Tests (sandbox) (push) Waiting to run
SDK Tests / Go SDK Quality And Tests (push) Waiting to run
chore: import upstream snapshot with attribution
2026-07-13 13:39:33 +08:00

1.5 KiB

title, description
title description
Agent Sandbox Create a kubernetes-sigs/agent-sandbox instance and run a command using the OpenSandbox Python SDK.

Agent-Sandbox Example

This example creates a sandbox backed by kubernetes-sigs/agent-sandbox and executes echo hello world via the OpenSandbox Python SDK.

Prerequisites

  • A Kubernetes cluster with the agent-sandbox controller and CRDs installed.
  • OpenSandbox server configured with Kubernetes runtime and workload_provider = "agent-sandbox".
  • Sandbox image should include bash (default example uses ubuntu:22.04).

Start OpenSandbox server

  1. Install the server package and fetch the example config for agent-sandbox:
uv pip install opensandbox-server
opensandbox-server init-config ~/.sandbox.toml --example docker
  1. Update ~/.sandbox.toml with the following sections:
[runtime]
type = "kubernetes"
execd_image = "opensandbox/execd:v1.0.21"

[kubernetes]
namespace = "default"
# kubeconfig_path = "/absolute/path/to/kubeconfig"  # optional if running in-cluster
workload_provider = "agent-sandbox"

[agent_sandbox]
shutdown_policy = "Delete"
  1. Start the server:
opensandbox-server

Run the example

uv pip install opensandbox
uv run python examples/agent-sandbox/main.py

Expected output

command output: hello world

References