Files
zeekay b2dc8d8956 feat: add agent canvas, collaboration, and IAM auth to control plane
- Add agent canvas with visual node editor, chat view, and collaboration cursors
- Add real-time collaboration infrastructure (contexts, hooks, presence)
- Add command palette, spaces, terminal panel, and side chat components
- Add IAM auth middleware and route handlers for server
- Add Hanzo branding (favicons, config, navigation updates)
- Update AuthContext/AuthGuard with enhanced auth flow
- Update Dockerfile and Makefile for control-plane builds
- Rebrand UI references and update dependencies across web client
2026-02-21 13:58:11 -08:00
..

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