# Documentation

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

> The AI operating system for business. Building business software since 2014. Techstars '17. Every model, every tool, one key — in our cloud or on your own machine.

**Building with an agent?** [Agents: start here](https://docs.hanzo.ai/docs/agents): a key, 50 free
requests a day, the first call and MCP.

## Every model, one key

Browse [every model we serve](https://docs.hanzo.ai/docs/openapi/ai) — the catalogue is live, so the id you
copy and the rate beside it are the gateway's current answer — or see [what a
request costs](https://docs.hanzo.ai/docs/pricing) before you send one.

## The platform, by domain

Every capability has one name and one route — `/v1/<name>` — and lives in exactly
one domain. Nothing is duplicated, so nothing is ambiguous.

### [Intelligence](https://docs.hanzo.ai/docs/openapi/ai)

Every model, agent and tool you can call — one key, one endpoint, and the
standard chat-completions shape, so a client you already have works unchanged.

```bash
hanzo run 'summarize this repo'
```

- [Models](https://docs.hanzo.ai/docs/models)
- [Agents](https://docs.hanzo.ai/docs/openapi/agent)
- [MCP](https://docs.hanzo.ai/docs/mcp)
- [Coding agents](https://docs.hanzo.ai/docs/guides/coding)
- [Prompt](https://docs.hanzo.ai/docs/openapi/prompt)
- [Tools](https://docs.hanzo.ai/docs/openapi/tool)
- [Sandbox](https://docs.hanzo.ai/docs/openapi/sandbox)
- [Functions](https://docs.hanzo.ai/docs/openapi/function)

[Make your first call](https://docs.hanzo.ai/docs/quickstart)

### [Identity & trust](https://docs.hanzo.ai/docs/openapi/iam)

Who someone is, what they may touch, and where secrets stay. Every other
domain reads its caller's identity from here.

```bash
hanzo auth login && hanzo account keys create
```

- [IAM](https://docs.hanzo.ai/docs/openapi/iam)
- [AuthZ](https://docs.hanzo.ai/docs/openapi/authz)
- [KMS](https://docs.hanzo.ai/docs/openapi/kms)
- [Wallet](https://docs.hanzo.ai/docs/openapi/wallet)
- [Trust](https://docs.hanzo.ai/docs/openapi/trust)

[Set up an org](https://docs.hanzo.ai/docs/openapi/iam)

### [Data](https://docs.hanzo.ai/docs/openapi/base)

Somewhere to put your data and read it back fast — relational, vector,
key-value, full-text and object, each behind its own `/v1` route.

```bash
hanzo kv set greeting hello && hanzo kv get greeting
```

- [Index](https://docs.hanzo.ai/docs/openapi/index)
- [KV](https://docs.hanzo.ai/docs/openapi/kv)
- [Search](https://docs.hanzo.ai/docs/openapi/search)
- [S3](https://docs.hanzo.ai/docs/openapi/s3)
- [Base](https://docs.hanzo.ai/docs/openapi/base)
- [Graph](https://docs.hanzo.ai/docs/openapi/graph)

[Store something](https://docs.hanzo.ai/docs/openapi/base)

### [Streams](https://docs.hanzo.ai/docs/openapi/pubsub)

Move messages and run work in the background, with delivery you can reason
about rather than hope for.

```bash
hanzo pubsub publish orders '{ "id": 1 }'
```

- [PubSub](https://docs.hanzo.ai/docs/openapi/pubsub)
- [Workflows](https://docs.hanzo.ai/docs/openapi/workflow)
- [Flow](https://docs.hanzo.ai/docs/openapi/flow)
- [Crawl](https://docs.hanzo.ai/docs/openapi/crawl)

[Move a message](https://docs.hanzo.ai/docs/openapi/pubsub)

### [Observability](https://docs.hanzo.ai/docs/openapi/o11y)

Metrics, logs, traces and evals for everything above — including the model
calls, tagged by org and project so tenants stay separate.

```bash
hanzo o11y query 'sum(rate(http_requests_total[5m]))'
```

- [O11y](https://docs.hanzo.ai/docs/openapi/o11y)
- [Metrics](https://docs.hanzo.ai/docs/openapi/metrics)
- [Experiment](https://docs.hanzo.ai/docs/openapi/experiment)
- [Eval](https://docs.hanzo.ai/docs/openapi/eval)
- [Event](https://docs.hanzo.ai/docs/openapi/event)

[See what is happening](https://docs.hanzo.ai/docs/openapi/o11y)

### [Commerce](https://docs.hanzo.ai/docs/openapi/commerce)

Turn usage into money — meter it, price it, bill it. The same ledger the
gateway debits when you call a model.

```bash
hanzo billing balance
```

- [Commerce](https://docs.hanzo.ai/docs/openapi/commerce)
- [Billing](https://docs.hanzo.ai/docs/openapi/billing)
- [Marketplace](https://docs.hanzo.ai/docs/openapi/marketplace)
- [Referral](https://docs.hanzo.ai/docs/openapi/referral)

[Meter usage](https://docs.hanzo.ai/docs/openapi/commerce)

### [Platform](https://docs.hanzo.ai/docs/openapi/gateway)

Run your code next to everything else — one gateway in front, your choice of
machine behind.

```bash
hanzo deploy .
```

- [Gateway](https://docs.hanzo.ai/docs/openapi/gateway)
- [Visor](https://docs.hanzo.ai/docs/openapi/compute)
- [Ingress](https://docs.hanzo.ai/docs/openapi/ingress)
- [Registry](https://docs.hanzo.ai/docs/openapi/registry)

[Ship your code](https://docs.hanzo.ai/docs/openapi/gateway)

### [Applications](https://docs.hanzo.ai/docs/chat)

The finished products built on the domains above — useful on their own, and a
worked example of the platform if you are building your own.

```bash
hanzo dev
```

- [Chat](https://docs.hanzo.ai/docs/chat)
- [Studio](https://docs.hanzo.ai/docs/studio)
- [Dev](https://docs.hanzo.ai/docs/dev)
- [Integrations](https://docs.hanzo.ai/docs/guides/integrations)
- [Apps](https://docs.hanzo.ai/docs/apps)

[Open the apps](https://docs.hanzo.ai/docs/chat)

## Take it with you

The cloud above and the one you can run yourself are [the same
software](https://docs.hanzo.ai/docs/network) — same binary, same contract, same `/v1` routes. Bring
your own GPU or Kubernetes, or mine on any device.

```bash
curl -fsSL https://hanzo.sh | sh
```

> This is **V8 · Open Edition**, specified in [HIP-0127](https://hips.hanzo.ai):
> one contract, many bindings, thin clients, and a wire — never FFI — between
> languages. See [Engineering Philosophy](https://docs.hanzo.ai/docs/architecture/philosophy) for the _why_.

## Build with it

- [The `hanzo` CLI](https://docs.hanzo.ai/docs/openapi/platform) — one \~15 MB Rust binary that talks to any live cloud: prod, laptop, or self-host
- [SDKs](https://docs.hanzo.ai/docs/sdks) — Python, TypeScript, Go, Rust and more, all derived from one contract
- [API reference](https://docs.hanzo.ai/docs/openapi) — every endpoint, generated from its spec
- [ZAP protocol](https://docs.hanzo.ai/docs/zap) — Zero-Copy App Proto, the wire the Go and Rust halves speak
- [Zen models](https://zenlm.org) — open-weight models for agentic coding that runs locally and for marketing work
- [Architecture](https://docs.hanzo.ai/docs/architecture) — one binary, one contract, and why

## Resources

- [GitHub](https://github.com/hanzoai) — source code and open-source projects
- [platform.hanzo.ai](https://platform.hanzo.ai) — dashboard and API keys
- [hips.hanzo.ai](https://hips.hanzo.ai) — Hanzo Improvement Proposals
