Agent Sandbox

Agent Sandbox Installation

Prerequisites

• kubectl CLI tool.

• For KinD cluster you need:

  • docker or podman installed.
  • kind CLI tool.

• For GKE cluster you need:

  • gcloud CLI

1. Run command to create a cluster in KinD:

   kind create cluster --name agent-sandbox-test
   

   Or run these commands to create a cluster in GKE and get credentials to your cluster:

   gcloud container clusters create-auto agent-sandbox-test --region=us-central1
   gcloud container clusters get-credentials agent-sandbox-test --location us-central1
   

2. Install the agent-sandbox controller and its CRDs with the following command:

   # Get the latest version of the release:
   VERSION=$(curl https://api.github.com/repos/kubernetes-sigs/agent-sandbox/releases/latest | jq -r '.tag_name')
   
   # To install only the core components:
   kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/download/${VERSION}/manifest.yaml
   
   # To install the extensions components:
   kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/download/${VERSION}/extensions.yaml
   
   # Make sure the controller pods are running:
   kubectl -n agent-sandbox-system get pods
   

3. Before using the client, you must deploy the sandbox-router. Follow these there steps:

   curl -sSL https://raw.githubusercontent.com/kubernetes-sigs/agent-sandbox/refs/tags/${VERSION}/clients/python/agentic-sandbox-client/sandbox-router/sandbox_router.yaml | sed 's|${ROUTER_IMAGE}|us-central1-docker.pkg.dev/k8s-staging-images/agent-sandbox/sandbox-router:latest-main|g' > sandbox_router.yaml
   kubectl apply -f sandbox_router.yaml
   
   # Make sure the router pods are running:
   kubectl get pods
   

4. Create a Sandbox Template. For example the python-runtime-sandbox. More information about this runtime can be found here.

   curl -sSLO http://raw.githubusercontent.com/kubernetes-sigs/agent-sandbox/refs/tags/${VERSION}/clients/python/agentic-sandbox-client/python-sandbox-template.yaml
   kubectl apply -f python-sandbox-template.yaml