mirror of https://github.com/hanzoai/agents.git synced 2026-10-30 18:48:36 +00:00

Files

T

zeekayandHanzo Dev ff7d100496 Everything that calls the control plane calls /v1

The server mounts /v1, /v1/ui and /v2/ui. The UI and its dev proxy, the helm
and kubernetes health probes, functional tests, project templates, examples
and scripts still called /api/v1, so the probes failed and the UI's requests
missed.

Co-authored-by: Hanzo Dev <[email protected]>

2026-09-11 04:10:35 -07:00

2.6 KiB

Raw Permalink Blame History

Kubernetes (Kustomize)

Plain Kubernetes manifests for evaluating Hanzo Agents without Helm.

If you want a values-driven install, use deployments/helm/hanzo-agents.

Choose an overlay

deployments/kubernetes/overlays/python-demo: control plane + a small Python agent (good default)
deployments/kubernetes/overlays/local-demo: control plane + Go demo agent (requires a custom image)
deployments/kubernetes/overlays/postgres-demo: PostgreSQL + Go demo agent (production-like storage)

If you use local-demo or postgres-demo, build and load the Go demo agent image first (example for Minikube):

docker build -t hanzo-agents-demo-go-agent:local -f deployments/docker/Dockerfile.demo-go-agent .
minikube image load hanzo-agents-demo-go-agent:local

Quick start

1) Namespace

kubectl create namespace hanzo-agents --dry-run=client -o yaml | kubectl apply -f -
kubectl config set-context --current --namespace=hanzo-agents

2) Apply (recommended)

kubectl apply -k deployments/kubernetes/overlays/python-demo

Wait for the control plane and demo agent to start (first run installs Python deps):

kubectl -n hanzo-agents wait --for=condition=Ready pod -l app.kubernetes.io/component=control-plane --timeout=300s
kubectl -n hanzo-agents wait --for=condition=Ready pod -l app.kubernetes.io/component=demo-python-agent --timeout=600s

3) Port-forward UI/API

kubectl port-forward svc/hanzo-agents-control-plane 8080:8080

Open:

http://localhost:8080/ui/

Sanity check:

curl -s http://localhost:8080/v1/health

4) Execute an agent via the control plane

curl -X POST http://localhost:8080/v1/execute/demo-python-agent.hello \
  -H "Content-Type: application/json" \
  -d '{"input":{"name":"World"}}'

5) Check VCs (optional)

resp=$(curl -s -X POST http://localhost:8080/v1/execute/demo-python-agent.hello \
  -H "Content-Type: application/json" \
  -d '{"input":{"name":"VC"}}')
run_id=$(echo "$resp" | python3 -c 'import sys,json; print(json.load(sys.stdin)["run_id"])')
curl -s http://localhost:8080/v1/did/workflow/$run_id/vc-chain | head -c 1200

Other overlays

Go demo agent:

kubectl apply -k deployments/kubernetes/overlays/local-demo

PostgreSQL + Go demo agent:

kubectl apply -k deployments/kubernetes/overlays/postgres-demo

Notes

The Python demo agent installs the SDK at startup; your cluster needs outbound network access.
For agent nodes, always register a Service DNS name (AGENT_PUBLIC_URL / AGENT_CALLBACK_URL), not localhost.

2.6 KiB Raw Permalink Blame History