Agent-Sandbox Example

July 13, 2026 ยท View on GitHub

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