# The Network

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

> The AI cloud you can run yourself. hanzo.network is hanzod nodes that spawn the same unified cloud binary we run in production — OSS AI cloud in one binary, BYO GPU or K8s, mine on any device, free for public and open-source workloads.

Hanzo is **one Go binary**. The `cloud` binary — `CGO_ENABLED=0`, statically
linked — embeds the whole platform: [every capability](https://docs.hanzo.ai/docs/openapi) across the
nine domains, mounted as subsystems, served behind one contract at
`/v1/<capability>`. The same binary that answers `api.hanzo.ai` in production is
the binary you run on your laptop with one command.

`hanzo.network&#x60; is what happens when you point that binary at a chain instead of
a single host. It is a network of **`hanzod`nodes** that spawn and power that
same unified`cloud\` binary. **The network is the cloud** — not a hosted service
you rent, but a substrate anyone can join and run.

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

> This is the story specified in \*\*[HIP-0127 — V8 · Open Edition](https://hips.hanzo.ai)\*\*:
> one binary, one contract, a network that is the cloud. Nothing here is a hosted
> tier you are locked into — every capability is the same open-source binary,
> whether it runs on our nodes or yours.

## One binary, everywhere

The naive way to ship a cloud is dozens of services, each its own image, each its
own deploy. Hanzo rejects that. The application cloud is __one static Go binary_\*
with no cgo, no cross-toolchain build, no runtime dependencies — which is exactly
what makes \*"`curl | sh`, run the whole cloud anywhere"_ true.

- **On your machine**: One binary, no dependencies. Runs the entire cloud locally for development or a single-tenant deployment.
- **On your GPU or K8s**: Bring your own accelerator or cluster. The binary uses what you give it — no vendor hardware lock-in.
- **On the network**: hanzod nodes spawn the same binary and coordinate over the chain. Join as a provider or a consumer.

Because the surface is one uniform contract — `/v1/<capability>` over \*_HTTP +
[ZAP](https://docs.hanzo.ai/docs/zap)_\* — a consumer never needs to know or care _which_ node, _which_
process, or _which_ language answered. The route is the identity.

## GitHub for compute

Public and open-source workloads run **free on public nodes**. Think of it as
GitHub for compute: your open work is hosted at no cost on the shared network,
the same way open source is hosted for free today. Private and metered workloads
are market-priced.

- **Public + OSS → free**: Open-source and public workloads run at no cost on public hanzod nodes. Openness is the pricing tier.
- **Private → market-priced**: Private workloads are metered and priced by the market of providers — you pay for what you use, to whoever runs it.

## Mine on any device

Any device can be a provider. A `hanzod` node contributes its compute to the
network and is paid at market price for the work it does. Confidential workloads
run inside **NVIDIA TEE / Confidential Compute** enclaves, so a provider serves
work it cannot see and a consumer runs work a host cannot inspect.

- **Any device**: Laptop, workstation, server, or datacenter GPU — if it runs the binary, it can mine.
- **Confidential by default**: NVIDIA TEE/CC enclaves keep provider and consumer mutually blind. Trust the math, not the operator.
- **Market-priced**: Providers are paid the going rate for the compute they contribute. The network clears the price.

## The language seam is a wire, never FFI

Hanzo is Go **and** Rust: the cloud is Go, while the [engine](https://docs.hanzo.ai/docs/openapi/engine),
the \[`dev`]\(/docs/dev) agent, and the ML kernels are Rust. They compose over
\*\*[ZAP](https://docs.hanzo.ai/docs/zap)\*\* — a network or local socket — never over FFI. Each stays a
clean single-language binary; they exchange ZAP frames, they never link each
other's code.

This is deliberate. FFI (cgo/uniffi) is _easy_ — one process — but it _complects_
two toolchains and destroys the single static binary. The wire seam is _simpler_:
independent, composable, language-free at the boundary. \*_Don't fuse — bridge._\*
See [Architecture & Philosophy](https://docs.hanzo.ai/docs/architecture) for the full reasoning.

## Run it yourself

### Install the binary

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

One command installs the [`hanzo` CLI](https://docs.hanzo.ai/docs/cli) — a \~15 MB Rust binary that
speaks to any live cloud, whether it is production, your laptop, or a self-host.

### Sign in

```bash
hanzo auth login
```

Authenticate with [Hanzo IAM](https://docs.hanzo.ai/docs/openapi/iam) — the same identity works against every
cloud, everywhere.

### Use every capability

```bash
hanzo "explain the network"          # Intelligence
hanzo projects deploy my-app         # Platform
hanzo kms secrets create             # Identity & trust
```

The CLI is a **client, never the server** — it never imports the cloud. It talks
ZAP (or its SDK) to a live cloud. Point it at prod, your laptop binary, or a
customer self-host; the commands are identical.

## Learn more

- [Architecture & Philosophy](https://docs.hanzo.ai/docs/architecture): One binary, one contract, the ZAP wire — the engineering principles behind the network.
- [The hanzo CLI](https://docs.hanzo.ai/docs/cli): Install, log in, and drive every capability from one Rust binary.
- [ZAP Protocol](https://docs.hanzo.ai/docs/zap): Zero-Copy App Proto — the wire the Go and Rust halves speak.
- [HIP-0127](https://hips.hanzo.ai): V8 · Open Edition — the canonical specification for this model.
