Hanzo Chat

The chat app on Hanzo Cloud — enso and Zen models, MCP tools, agents, file uploads and RAG. Hosted at chat.hanzo.ai, or self-host it.

Hanzo Chat is the chat app on Hanzo Cloud, built on LibreChat. It runs our own models — the enso frontier family and the Zen open-weight family — with MCP tools, configurable agents, file uploads with RAG, vision, conversation history, presets and plugins. Models from outside labs are carried too, and appear in the same model menu.

Available as a hosted service at chat.hanzo.ai or self-hosted via Docker.

Quick Start

  1. Go to chat.hanzo.ai
  2. Sign in with your Hanzo account
  3. Your $5 free credit is applied automatically
  4. Select a model and start chatting

Self-Hosted

hanzoai/chat (@hanzo/chat) is a static Vite + React client built on @hanzo/ui and @hanzo/ai that connects to api.hanzo.ai or a self-hosted stack:

git clone https://github.com/hanzoai/chat
cd chat
pnpm install --no-frozen-lockfile
pnpm dev
# Open http://localhost:3090

For an offline single-binary chat UI + local LLM server with zero Node.js or IAM setup, use hanzoai/engine (http://127.0.0.1:1234/ui) — see Self-Hosting & Air-Gapped and Chat Self-Hosting.

The call

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, Zen."}]
  }'
hanzo chat completions \
  --model zen6 \
  --messages '[{"role":"user","content":"Hello, Zen."}]'
import { Hanzo } from '@hanzo/ai'

const hanzo = new Hanzo({ secretKey: process.env.HANZO_API_KEY })

const completion = await hanzo.chat.completions.create({
  model: 'zen6',
  messages: [{ role: 'user', content: 'Hello, Zen.' }],
})
console.log(completion.choices[0].message.content)
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["HANZO_API_KEY"],
    base_url="https://api.hanzo.ai/v1",
)

response = client.chat.completions.create(
    model="zen6",
    messages=[{"role": "user", "content": "Hello, Zen."}]
)
print(response.choices[0].message.content)

/v1/chat/completions takes and returns the chat-completions JSON shape, which is why the Python tab is the openai client with its base URL moved: any client already written against that shape works here unchanged. Model ids are not portable across vendors, though — zen6 and enso-auto exist only here. The SDKs covers what each language ships and when to reach past the chat route into the rest of /v1.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                        HANZO CHAT                           │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────────┐  │
│  │ React Client │  │ Node.js API  │  │    DocumentDB    │  │
│  │              │  │              │  │                  │  │
│  │ - Chat UI    │  │ - REST API   │  │ - Messages       │  │
│  │ - Model Sel  │  │ - WebSocket  │  │ - Conversations  │  │
│  │ - File Upload│  │ - MCP Broker │  │ - Users          │  │
│  │ - Agents     │  │ - Auth       │  │ - Presets        │  │
│  └──────────────┘  └──────────────┘  └──────────────────┘  │
│                                                             │
│  ┌─────────────────────────────────────────────────────┐    │
│  │              Provider Layer (AI API)            │    │
│  │  Zen · OpenAI · Anthropic · Google · Meta · …       │    │
│  └─────────────────────────────────────────────────────┘    │
│                                                             │
│  ┌─────────────────────────────────────────────────────┐    │
│  │  Search       │  KV     │  S3     │  RAG API       │    │
│  └─────────────────────────────────────────────────────┘    │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Endpoints

EnvironmentURL
Productionhttps://chat.hanzo.ai
APIhttps://api.hanzo.ai/v1
Local (@hanzo/chat)http://localhost:3090
Local (hanzo-engine UI)http://127.0.0.1:1234/ui

Pricing

  • $5 free credit on every new account (expires in 30 days)
  • Prepaid billing — add credits via platform.hanzo.ai
  • Starting at $0.34/MTok input (zen5-flash)
  • No surprise bills — service stops when credits are depleted

In this section

Was this page useful?
Broken link or missing step? Drop it in #docs on Discord or open a PR.
Last updated Nov 21, 2026