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

Files

T

zeekayandGitHub 5b5cf9e9db feat: merge AgentField control plane + SDKs as Hanzo Agents (#1 )

Transforms hanzoai/agents from a marketplace config repo into a full
agent orchestration platform by merging the AgentField infrastructure:

- Go control plane (K8s-like agent orchestration, service mesh, DAG workflows)
- Python SDK (FastAPI-based agent framework, LiteLLM, memory, DID/VC)
- TypeScript SDK (@hanzo/agents - Vercel AI SDK, MCP, workflows)
- Go SDK (idiomatic agent builder + client)
- React 19 embedded dashboard (XyFlow DAGs, Recharts, Radix UI)
- Docker/K8s/Helm deployment configs
- Examples: hello world, deep research, RAG, simulation, benchmarks
- Functional test suite across Python/Go/TypeScript

All references rebranded: AgentField → Hanzo Agents
- Module: github.com/hanzoai/agents/control-plane
- Python: hanzo_agents
- TypeScript: @hanzo/agents
- Go: github.com/hanzoai/agents/sdk/go
- Env vars: HANZO_AGENTS_*
- Config: hanzo-agents.yaml

Previous marketplace configs moved to config/ directory.

2026-02-09 18:53:09 -08:00

2.6 KiB

Raw Permalink Blame History

Hanzo Agents Control Plane

The Hanzo Agents control plane orchestrates agent workflows, manages verifiable credentials, serves the admin UI, and exposes REST/gRPC APIs consumed by the SDKs.

Requirements

Go 1.23+
Node.js 20+ (for the web UI under web/client)
PostgreSQL 15+

Quick Start

# From the repository root
cd control-plane
go mod download
cd web/client
npm install
npm run build
cd ../..

# Run database migrations (requires HANZO_AGENTS_DATABASE_URL)
goose -dir ./migrations postgres "$HANZO_AGENTS_DATABASE_URL" up

# Start the control plane
HANZO_AGENTS_DATABASE_URL=postgres://hanzo-agents:hanzo-agents@localhost:5432/hanzo-agents?sslmode=disable \
go run ./cmd/server

Visit http://localhost:8080/ui/ to access the embedded admin UI.

Local Development with Hot-Reload

For development with hot-reload, use the dev.sh script. This automatically rebuilds and restarts the server when Go files change.

cd control-plane
./dev.sh            # SQLite mode (default, no dependencies)
./dev.sh postgres   # PostgreSQL mode (set HANZO_AGENTS_DATABASE_URL first)

The server runs at http://localhost:8080 and will automatically reload when you modify .go, .yaml, or .yml files.

Notes:

Uses Air for hot-reload (auto-installed if missing)
Web UI is not included in dev mode; run npm run dev separately in web/client/ if needed

Configuration

Environment variables override config/hanzo-agents.yaml. Common options:

HANZO_AGENTS_DATABASE_URL – PostgreSQL DSN
HANZO_AGENTS_HTTP_ADDR – HTTP listen address (0.0.0.0:8080 by default)
HANZO_AGENTS_LOG_LEVEL – log verbosity (info, debug, etc.)

Sample config files live in config/.

Web UI Development

cd control-plane/web/client
npm install
npm run dev
# Build production assets embedded in Go binaries
cd ../..
npm run build

Run the Go server alongside the UI so API calls resolve locally. During production builds the UI is embedded via Go's embed package.

Database Migrations

Migrations use Goose:

HANZO_AGENTS_DATABASE_URL=postgres://hanzo-agents:hanzo-agents@localhost:5432/hanzo-agents?sslmode=disable \
goose -dir ./migrations postgres "$HANZO_AGENTS_DATABASE_URL" status

Testing

go test ./...

Linting

go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
golangci-lint run

Releases

The build-single-binary.sh script creates platform-specific binaries and README artifacts. CI-driven releases are defined in .github/workflows/release.yml.

2.6 KiB Raw Permalink Blame History Unescape Escape