Files
hanzoai_agent/deployments/docker/README.md
zeekay 2899aeaa9f feat: merge agents control plane + SDKs into unified agent repo
Consolidate all Hanzo agent infrastructure into one repo:
- control-plane/: Go control plane server (was agents-new)
- sdk/: Go, Python, TypeScript SDKs
- deployments/: Docker, Kubernetes, Helm configs
- Dockerfile.sdk: Python SDK image (ghcr.io/hanzoai/agent:latest)
- CI builds both SDK + control-plane images

No more agentfield — everything is hanzoai/agent.
2026-02-13 12:24:31 -08:00

1.8 KiB

Docker (local)

This folder contains a small Docker Compose setup for evaluating Hanzo Agents locally:

  • Control plane (UI + REST API)
  • PostgreSQL (pgvector)
  • Optional demo agents (Go + Python)

Quick start

cd deployments/docker
docker compose --profile python-demo up --build

Open the UI:

  • http://localhost:8080/ui/

Execute an agent via the control plane

Python demo agent (deterministic; no LLM keys required):

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

Go demo agent:

curl -X POST http://localhost:8080/api/v1/execute/demo-go-agent.demo_echo \
  -H "Content-Type: application/json" \
  -d '{"input":{"message":"Hello!"}}'

Check Verifiable Credentials (VCs)

The Python SDK posts execution VC data back to the control plane. Grab the run_id and fetch the VC chain:

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

Defaults (PostgreSQL)

  • User / password / database: hanzo-agents / hanzo-agents / hanzo-agents

Docker networking note (callback URL)

The control plane must be able to call your agent at the URL it registers.

  • Same Compose network: use the service name (e.g. http://demo-python-agent:8001).
  • Agent on host, control plane in Docker: use host.docker.internal (Python: AGENT_CALLBACK_URL, Go: AGENT_PUBLIC_URL).

Cleanup

cd deployments/docker
docker compose --profile python-demo down -v