SDKs
Official Hanzo SDKs for every language — Python, TypeScript, Go, Rust, C++, Swift, Kotlin. Two lines per language — the full Cloud SDK and the AI/Agents library.
Hanzo SDKs
Hanzo AI — one API for every model, one SDK for every language. Talk to the Open AI Cloud from the language you already work in. Every SDK is generated from the same OpenAPI 3.1 spec and shares one credential.
Two libraries per language
Each language has two first-class lines — install the one that fits the job, or both:
Cloud SDK
The full, generated client for the entire Open AI Cloud (/v1/*): AI,
agents, compute, data, network, security, platform, observe, web3, apps.
Idiomatic and typed for its ecosystem. Real code lives in hanzo-<lang>/sdk.
AI / Agents lib
The hand-crafted, AI-first library — models, agents, tools, memory, MCP, and
inference. The flagship is Python (pip install hanzo); Node ships
@hanzo/ai.
Languages
Python — flagship
pip install hanzo (AI) · pip install hanzoai (Cloud). Sync + async.
TypeScript
npm i @hanzo/ai (AI) · npm i @hanzo/sdk (Cloud). Node, Deno, Bun, browser.
Go
go get github.com/hanzoai/go-sdk. Functional options, minimal deps.
Rust
cargo add hanzo — async Tokio client. On crates.io.
C++
find_package(hanzo) — native client via CMake. Coming soon.
Swift
SwiftPM — iOS/macOS client, resolved straight from the repo.
Kotlin
Gradle — JVM/Android client. Coming soon.
IAM SDK
@hanzo/iam — TypeScript IAM client with React bindings.
Install matrix
Only generally-available packages are shown as runnable installs. The rest are in active development — each links to its per-language org where the source already lives.
| Language | Library | Install | Status |
|---|---|---|---|
| Python | AI / agents (flagship) | pip install hanzo | GA |
| Python | Cloud SDK | pip install hanzoai | GA |
| TypeScript | AI lib | npm i @hanzo/ai | GA |
| TypeScript | Cloud SDK | npm i @hanzo/sdk | GA |
| Go | Cloud SDK | go get github.com/hanzoai/go-sdk | GA |
| Rust | Cloud SDK | cargo add hanzo | GA |
| C++ | Cloud SDK | find_package(hanzo) | Coming soon |
| Swift | Cloud SDK | .package(url: "https://github.com/hanzo-swift/sdk") | GA |
| Kotlin | Cloud SDK | Gradle / Maven | Coming soon |
Wire-compatible today
Every language can already reach the Open AI Cloud through any OpenAI- or
Anthropic-compatible client — just point the base URL at
https://api.hanzo.ai/v1 and use your Hanzo key. The native SDKs above add
typed models, retries, streaming helpers, and the agents/MCP surface.
Quick start
pip install hanzoEvery client follows the same shape — construct with your key, call a /v1
resource:
from hanzoai import Hanzo
client = Hanzo(api_key="hk-your-key")
response = client.chat.completions.create(
model="zen5",
messages=[{"role": "user", "content": "Hello"}],
)
print(response.choices[0].message.content)One key, one base URL
export HANZO_API_KEY="hk-..." # from console.hanzo.ai
# Base URL for every service: https://api.hanzo.ai/v1Get your key at console.hanzo.ai.
Where the code lives
- Umbrella —
hanzoai/sdk: one install, every service, every language. - Per-language orgs — real code, idiomatic per ecosystem: hanzo-py · hanzo-js · hanzo-go · hanzo-rs · hanzo-cpp · hanzo-swift · hanzo-kt
- Full API reference — every
/v1endpoint →
How is this guide?
Last updated on