mirror of
https://github.com/hanzoai/agent.git
synced 2026-09-11 21:08:51 +00:00
zooqueenandHanzo Dev
1332f6e2bc
- BillingService client calls Commerce API for balance checks and debits - Balance gate in prepareExecution blocks $0 balance with HTTP 402 - Post-execution billing in completeExecution/failExecution debits actual cost - Balance proxy endpoint at GET /api/v1/billing/balance - DB migration adds billing fields to executions table - K8s deployment wired with BILLING_COMMERCE_URL and admin token secret Co-authored-by: Hanzo Dev <[email protected]>
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/api/v1/health
4) Execute an agent via the control plane
curl -X POST http://localhost:8080/api/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/api/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/api/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
ServiceDNS name (AGENT_PUBLIC_URL/AGENT_CALLBACK_URL), notlocalhost.