A collection of end-to-end examples showcasing what you can build with kagent — each demo targets a distinct use case and is self-contained with its own manifests and deployment script.
kagent is a Kubernetes-native agent runtime. It manages AI agents as first-class Kubernetes resources (CRDs), handles routing via the A2A protocol, and integrates with MCP tool servers and multiple LLM providers.
kagent supports two complementary agent models:
| Feature | Declarative Agent | BYO Agent |
|---|---|---|
| Runtime | Managed by kagent | Your own container |
| ADK config | kagent-supported params only | 100% free |
| Tool connection | Declared via spec.tools |
Wired in code |
| Getting started | Easy (YAML only) | Moderate (container required) |
| Best for | Standard tool combinations | Custom ADK behaviour |
How BYO Agent works:
- Package a container that implements the A2A protocol on port 8080
- Use
kagent-adk(pip install kagent-adk) to wrap an ADK agent as an A2A server — no HTTP boilerplate needed - kagent deploys it as a Kubernetes Deployment and proxies
/api/a2a/{namespace}/{agent-name}/…
| # | Demo | What it shows |
|---|---|---|
| 01 | demo-01-byo-full-control | Full ADK control — BuiltInPlanner, ThinkingConfig, custom callbacks |
| 02 | demo-02-tool-reuse | BYO agent connecting directly to a shared MCPServer via cluster DNS |
| 03 | demo-03-local-llm | Declarative agent running on a local LLM (Ollama) — no cloud API key |
| 04 | demo-04-hitl | Declarative agent with requireApproval — read ops run freely, write ops pause for human sign-off |
Each demo folder contains a README.md with a detailed walkthrough.
kind— local Kubernetes clusterkubectl,helm,docker
# 1. Create a kind cluster and install kagent (run once)
export GOOGLE_API_KEY=<your-google-api-key>
./scripts/kind-setup.sh
# 2. Deploy any demo independently
./demo-01-byo-full-control/deploy-kind.sh
./demo-02-tool-reuse/deploy-kind.sh
./demo-03-local-llm/deploy-kind.sh
./demo-04-hitl/deploy-kind.shThe kagent UI is available at http://localhost:8080 after setup.