What is K8E?
K8E is the Open Source Agentic AI Sandbox Matrix โ a Kubernetes-native platform for running secure, isolated AI agent workloads at scale, packaged as a single binary under 100MB.
As autonomous AI agents increasingly generate and execute untrusted code, robust sandboxing infrastructure is no longer optional. K8E ships everything needed to spin up a production-grade cluster in under 60 seconds, with first-class primitives for agent isolation, resource governance, and persistent execution environments โ purpose-built for the AI era.
๐ One cluster. Many agents. Zero trust between them.
Quick Facts
- k8e.sh โ Open Source Agentic AI Sandbox Matrix
- A CNCF-conformant Kubernetes distribution in a single binary under 100MB
- Purpose-built for secure, isolated AI agent execution at scale
- Up and running in 60 seconds
- Inspired by K3s
Install
curl -sfL https://k8e.sh/install.sh | sh -
That's it. Your agentic sandbox matrix is ready. ๐ค
Sandbox Capabilities
| Capability | Description |
|---|---|
| ๐ Hardware Isolation | Pluggable runtimes: gVisor (default), Kata Containers, Firecracker microVM |
| ๐ Network Policies | Cilium eBPF toFQDNs egress control โ per-session, no proxy process needed |
| ๐ E2B SDK Compatible | The official e2b SDKs (Python/JS, unmodified) work natively โ create, exec, files, watch, pause/resume (guide) |
| ๐ช Gateway API Ingress | The Cilium Gateway API fronts every sandbox port โ HTTP :80/:443 + gRPC :50051 (mTLS passthrough) |
| โ๏ธ Resource Quotas | CPU/memory caps per agent session to prevent runaway costs |
| ๐พ Persistent Workspaces | Every session carries a PVC workspace (1Gi local-path by default); warm pods boot with their claim pre-provisioned โ fast start and durable files |
| ๐ง Warm Pool | Pre-booted sandbox pods for sub-500ms session claim latency |
| ๐ธ Content-Addressed Snapshots | SHA-256 CAS layerstore with zstd compression, chunked multi-layer manifests, incremental --base restore, server-side registry, autosquash |
| ๐ Exec Transcripts | File-backed, windowed, offset-resumable command transcripts โ k8e-sandbox-cli log |
| ๐ Observability | Prometheus metrics, disk-only NDJSON event stream, process topology โ events / ps CLI |
| ๐ Sub-agent Reuse | Sub-agents share the parent pod + workspace; isolated reset |
| ๐งพ CLI Catalog + MCP | Machine-readable command surface for SDK generation โ catalog; native MCP server via k8e-sandbox-cli mcp-serve, also exposed through the K8E API Gateway |
| ๐ค agent-sandbox compatible | Works with kubernetes-sigs/agent-sandbox |
| ๐ SKILL + CLI | AI agents (Claude Code, Codex, Pi) connect via k8e-sandbox-cli CLI commands or the /k8e-sandbox skill |
Project Links
- ๐ Bug Reports
- ๐ก Feature Requests
- ๐ Open PRs
- ๐ก๏ธ Security Advisories
- ๐ Apache License 2.0 โ see LICENSE