# Hanzo Docs

URL: https://docs.hanzo.ai/

> The AI operating system for business.

Building business software since 2014. Techstars '17. Every model, every tool and Kai on one key, free to start: in the browser, from your terminal, or on your own hardware, with the same software we run in production.

## Enso routes.

The router. It picks the model for every request: send `model: "auto"` or an `enso-*` id.

[Docs](https://docs.hanzo.ai/docs/models/enso) · [hanzo.ai/enso](https://hanzo.ai/enso)

## Kai decides.

The decision model. Typed answers with calibrated probabilities at `POST /v1/decisions`, $0.021 per million input tokens, output free.

[Docs](https://docs.hanzo.ai/docs/models/kai) · [hanzo.ai/kai](https://hanzo.ai/kai)

## Zen reasons.

The open-weight family: text, vision and audio, with the weights on Hugging Face.

[Docs](https://docs.hanzo.ai/docs/models/zen) · [hanzo.ai/zen](https://hanzo.ai/zen)

## All models: 500+

Every model the gateway serves, from 72 makers, on one key and one bill. The catalogue lists each id with its live rate. [Browse the catalogue](https://docs.hanzo.ai/docs/models)

```bash
curl hanzo.sh | sh
```

Installs the `hanzo` CLI. Then `hanzo auth login` to get a key.

Or hand this to your agent — it installs the CLI, the MCP server and the [skills](https://hanzoskills.com), then points its own model calls at Hanzo. [Agents: start here](https://docs.hanzo.ai/docs/agents)

- [Build with App](https://hanzo.app) (No code): Describe it in English and watch it build. Chat, agents and MCP tools in the browser.
- [Build with Dev](https://docs.hanzo.ai/docs/cli) (In your terminal): Our coding agent, in your repo. Or bring Claude Code and Codex — they work here too.
- [Build with API](https://docs.hanzo.ai/docs/openapi) (Lower level): 500+ models behind one REST endpoint, with SDKs for every language we ship.

## Quick Start

Install the CLI, log in, and reach every capability from your terminal.

**npm**

```bash
npm i -g hanzo
```

**Script**

```bash
curl -fsSL hanzo.sh | sh
```

**Homebrew**

```bash
brew install hanzoai/tap/hanzo
```

**From source**

```bash
git clone https://github.com/hanzoai/cli && cd cli && cargo install --path .
```

Sign in once, then reach every capability from the terminal — or from any SDK, over HTTP, or through MCP.

**CLI**

```bash
hanzo auth login

hanzo "explain quantum computing"
hanzo models list
hanzo projects deploy my-app
```

**TypeScript**

```typescript
// npm i hanzoai
import { AiApi, Configuration } from 'hanzoai'

const ai = new AiApi(new Configuration())

const { data } = await ai.getModels()
console.log(data.data?.length, 'models')
```

**Python**

```python
# pip install hanzoai
from hanzoai.cloud import AiApi, ApiClient, Configuration

ai = AiApi(ApiClient(Configuration()))

print(len(ai.get_models().data or []), "models")
```

**Go**

```go
// go get github.com/hanzoai/go-sdk/v8
import hanzoai "github.com/hanzoai/go-sdk/v8"

client := hanzoai.NewAPIClient(hanzoai.NewConfiguration())

models, _, err := client.AiAPI.GetModels(ctx).Execute()
```

**Rust**

```rust
// cargo add hanzo-client
use hanzo_client::apis::{ai_api, configuration::Configuration};

let cfg = Configuration::new();

let models = ai_api::get_models(&cfg).await?;
```

**HTTP**

```bash
curl https://api.hanzo.ai/v1/chat/completions \
  -H "Authorization: Bearer $HANZO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"zen6","messages":[{"role":"user","content":"Hello!"}]}'
```

## One binary. The whole platform.

Every capability has one name and one route. Browse by domain — click any card to go deep.

- [Identity & trust](https://docs.hanzo.ai/docs/openapi/iam): Who someone is, what they may touch, and where secrets stay safe. IAM, AuthZ, KMS, MPC, Zero-Trust.
- [Intelligence](https://docs.hanzo.ai/docs/openapi/ai): The mind of the cloud — every model, agent, and tool you can call. Models, Agents, MCP, Embeddings, Prompts, GPUs, Functions.
- [Data](https://docs.hanzo.ai/docs/openapi/provisioning): Somewhere to put your data and read it back fast. SQL, Vector, KV, Search, Object, Base, DocDB.
- [Streams](https://docs.hanzo.ai/docs/openapi/pubsub): Move messages and run work in the background, reliably. PubSub, Tasks, Pipelines, Crawl.
- [Observability](https://docs.hanzo.ai/docs/openapi/o11y): See exactly what your system is doing, live. Metrics, Logs, Traces, Sessions, Evals, Analytics.
- [Commerce](https://docs.hanzo.ai/docs/openapi/commerce): Turn usage into money — meter it, price it, bill it, reward it. Commerce, Billing, Marketplace, Referrals.
- [Platform](https://docs.hanzo.ai/docs/openapi/gateway): Ship your code and run it anywhere. Gateway, Machines, Edge, Registry.
- [Applications](https://docs.hanzo.ai/docs/openapi/git): The finished products people use every day. Chat, Studio, Dev, Integrations, Apps.
- [Chain](https://docs.hanzo.ai/docs/openapi/web3): The networks the cloud speaks to — enumerate them, call one, read a holder's balances. Web3, Explorer.

## Developer Tools

SDKs, APIs, and protocols for every stack.

- [The Network](https://docs.hanzo.ai/docs/network): Run the whole cloud yourself
- [SDKs](https://docs.hanzo.ai/docs/sdks): Python, TypeScript, Go, Rust, C++, Swift, Kotlin
- [API Reference](https://docs.hanzo.ai/docs/openapi): Every /v1 endpoint, live
- [Architecture](https://docs.hanzo.ai/docs/architecture): One binary, one contract

## Every model, one API

500+ models across every major provider — call any of them with one credential, one request shape.

- Zen: Open weights
- OpenAI: GPT
- Anthropic: Claude
- Qwen: Open
- Llama: Open
- DeepSeek: Open
- Mistral: Open
- Gemma: Open

## SDKs in every language

Generated from one contract — the same /v1 surface, typed for your stack.

Python, TypeScript, Go, Rust, C++, Dart

[SDK reference](https://docs.hanzo.ai/docs/sdks)

## Every tool, one MCP surface

Native connectors + the open MCP registry — Slack, GitHub, Notion, Stripe, and more — exposed as MCP tools any agent can call.

Slack, GitHub, Notion, Stripe, Google, Linear, +700 more

[MCP tools](https://docs.hanzo.ai/docs/mcp)

## The `hanzo` CLI

A ~15 MB Rust client for any live cloud — prod, laptop, or self-host

- `hanzo chat`: Chat with any model interactively
- `hanzo models list`: Browse every available model
- `hanzo keys create`: Create and manage API keys
- `hanzo deploy`: Deploy apps with git push
- `hanzo logs`: Stream logs from any service
- `hanzo storage`: Manage S3-compatible storage
- `hanzo secrets`: Manage secrets and env vars
- `hanzo bot`: Deploy and manage AI bots
- `hanzo flow`: Run workflow automations

## Zen (open weights)

The open-weight family, chosen for two jobs: agentic coding that runs on your own machine, and marketing work — copy in your brand's voice and the images and speech beside it. Weights on Hugging Face; the same ids hosted on api.hanzo.ai, routed by Enso.

- `zen6`: 27B, reads images
- `zen6-flash`: Ternary, fits a laptop
- `zen5`: Hosted
- `zen-embedding`: Retrieval
- `zen-guard`: Safety

[Zen models](https://docs.hanzo.ai/docs/models/zen) · [HuggingFace](https://huggingface.co/zenlm)

## Start building

Free tier with generous limits. No credit card required.

```bash
curl hanzo.sh | sh
```

[Try Hanzo](https://hanzo.ai/login) · [Browse documentation](https://docs.hanzo.ai/docs)