← all repositories
kubernetes-sigs/agent-sandbox

Kubernetes finally gets a "just one pod, please" button

A new SIG Apps project treats singleton, stateful workloads as first-class citizens instead of StatefulSets-of-size-one held together with YAML duct tape.

3.3k stars Go AgentsLLMOps · Eval
agent-sandbox
Velocity · 7d
+11
★ / day
Trend
steady
star history

What it does

agent-sandbox is a Kubernetes controller and Sandbox CRD that manages exactly one pod with a stable identity and persistent storage. It targets workloads that don’t fit Deployments (stateless, replicated) or StatefulSets (numbered, scaled) — think Jupyter notebooks, dev environments, or AI agents running untrusted LLM-generated code.

The interesting bit

The extensions layer is where it gets clever: SandboxWarmPool keeps pre-warmed sandboxes ready for instant allocation, and SandboxClaim lets users grab one without knowing the underlying template. It’s essentially a pod vending machine with hibernation and resume semantics planned.

Key highlights

  • Stable hostname and network identity without StatefulSet overhead
  • Persistent storage that survives restarts
  • Lifecycle hooks for pausing, resuming, and scheduled deletion
  • Warm pools for sub-second sandbox provisioning
  • Designed for strong isolation via gVisor or Kata Containers
  • Python SDK for programmatic control

Caveats

  • Several desired characteristics (deep hibernation, automatic resume, memory sharing, dual identities) are explicitly listed as exploratory or runtime-dependent
  • The project is early-stage enough that its own README warns about Copilot co-authorship breaking Kubernetes CLA requirements

Verdict

Worth watching if you run AI agent runtimes, notebooks, or dev environments in Kubernetes and are tired of pretending a StatefulSet of replica=1 is a real abstraction. Skip it if your workloads are happily stateless or already scale horizontally without drama.

Frequently asked

What is kubernetes-sigs/agent-sandbox?
A new SIG Apps project treats singleton, stateful workloads as first-class citizens instead of StatefulSets-of-size-one held together with YAML duct tape.
Is agent-sandbox open source?
Yes — kubernetes-sigs/agent-sandbox is open source, released under the Apache-2.0 license.
What language is agent-sandbox written in?
kubernetes-sigs/agent-sandbox is primarily written in Go.
How popular is agent-sandbox?
kubernetes-sigs/agent-sandbox has 3.3k stars on GitHub and is currently holding steady.
Where can I find agent-sandbox?
kubernetes-sigs/agent-sandbox is on GitHub at https://github.com/kubernetes-sigs/agent-sandbox.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.