Files
zeekayandHanzo Dev ca8a8eb4b7 The SDKs here are the ones that shipped, under this repo's module path
hanzoai/agents carried the reconciled Go, TypeScript and Python SDKs:
memory in Base with one record schema across all three, scope ids
resolved the way the control plane resolves them, /v1 paths, one address
per vector operation, agents that start under Express 5, and suites that
run (Go green, 92 TypeScript, 527 Python). They come home here.

The Go module is github.com/hanzoai/agent/sdk/go, because the path has to
name the repository it is fetched from. The TypeScript manifest names its
versions directly and keeps npm's lockfile; this repo is not a pnpm
workspace. Versions are 0.2.10.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-11 12:12:32 -07:00
..

Hanzo Agents Go SDK

The Hanzo Agents Go SDK provides idiomatic Go bindings for interacting with the Hanzo Agents control plane.

Installation

go get github.com/hanzoai/agent/sdk/go

Quick Start

package main

import (
    "context"
    "log"

    hanzo-agentsagent "github.com/hanzoai/agent/sdk/go/agent"
)

func main() {
    agent, err := hanzo-agentsagent.New(hanzo-agentsagent.Config{
        NodeID:   "example-agent",
        Hanzo AgentsURL: "http://localhost:8080",
    })
    if err != nil {
        log.Fatal(err)
    }

    agent.RegisterSkill("health", func(ctx context.Context, _ map[string]any) (any, error) {
        return map[string]any{"status": "ok"}, nil
    })

    if err := agent.Run(context.Background()); err != nil {
        log.Fatal(err)
    }
}

Modules

  • agent: Build Hanzo Agents-compatible agents and register reasoners/skills.
  • client: Low-level HTTP client for the Hanzo Agents control plane.
  • types: Shared data structures and contracts.
  • ai: Helpers for interacting with AI providers via the control plane.

Testing

go test ./...

License

Distributed under the Apache 2.0 License. See the repository root for full details.