mirror of
https://github.com/hanzoai/agent.git
synced 2026-09-11 21:08:51 +00:00
zeekay
6430482a64
deployments/docker/Dockerfile.demo-go-agent: switch runtime from gcr.io/distroless/static-debian12:nonroot to FROM scratch. CA certs, tzdata, /etc/passwd and /etc/group (nonroot uid/gid 65532) come from the builder. deployments/docker/Dockerfile.control-plane: switch runtime from gcr.io/distroless/base-debian12 (glibc + sqlite_fts5 CGO needs libc) to ghcr.io/hanzoai/debian12:base. TODO flagged for ghcr-auth in CI.
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