# Kubernetes

Kubernetes is a runtime & deploy option for building AI agents. Your existing cluster. Nothing new for the platform team to approve.

## Facts

- Layer: Runtime & deploy (How you run it)
- Vendor: Kubernetes (github.com/kubernetes/kubernetes)
- Licence: open source
- Pricing: open source
- Self-hostable: yes
- Docs: https://kubernetes.io/
- Last verified: 2026-08-21

## When to reach for it

- You are choosing a runtime & deploy component — how you run it.
- You need to run it on your own infrastructure, or your procurement process requires source access.
- You want to start without a commercial conversation.

## Alternatives in the runtime & deploy layer

| Option | What it does | Licence | Self-host |
| --- | --- | --- | --- |
| Docker Compose | One file, one box, everything local. The honest starting point. | open source | yes |
| Vercel | Streaming-friendly serverless for TypeScript agents with a web front end. | proprietary | no |
| Cloudflare Workers | Edge runtime with Durable Objects for long-lived, stateful agent sessions. | proprietary | no |
| Modal | Python-native serverless with GPUs and sandboxes, scale to zero. | proprietary | no |
| Fly.io | Long-running containers close to users, without owning a Kubernetes cluster. | proprietary | no |
| Temporal | Durable execution — the run survives a crash, a deploy and a week of waiting. | open source | yes |
| Centaur | Paradigm's self-hosted control plane: one shared team agent, an isolated k8s sandbox per Slack thread, and no raw API keys in the agent's environment. | open source | yes |

Head to head:

- https://newagent.build/compare/k8s-vs-docker-compose
- https://newagent.build/compare/k8s-vs-vercel
- https://newagent.build/compare/k8s-vs-cloudflare-workers
- https://newagent.build/compare/k8s-vs-modal
- https://newagent.build/compare/k8s-vs-fly
- https://newagent.build/compare/k8s-vs-temporal
- https://newagent.build/compare/k8s-vs-centaur

## Curated stacks using it

- Regulated / on-prem: Nothing leaves the estate. Every component runs on infrastructure you control.

## Add it to a stack

```bash
curl -fsSL "https://newagent.build/api/stack?runtime=k8s&format=sh" | sh
```

## Machine interfaces

- `GET https://newagent.build/api/registry` — every component as JSON
- `GET https://newagent.build/api/vendors` — vendors, with the repo and releases feed to watch
- `GET https://newagent.build/api/advise?q=<plain english>` — recommended stack for a description
- `GET https://newagent.build/api/stack?<layer>=<id>&format=sh|json|md|yml|agents|env` — a stack as files
- `GET https://newagent.build/llms.txt` — the whole registry in one fetch

Any page here also returns markdown if you send `Accept: text/markdown`.