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
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
Hosted (Recommended)
- Go to chat.hanzo.ai
- Sign in with your Hanzo account
- Your $5 free credit is applied automatically
- Select a model and start chatting
Self-Hosted
git clone https://github.com/hanzoai/chat
cd chat
cp .env.example .env
# Edit .env with your HANZO_API_KEY
docker compose up -d
# Open http://localhost:3081API
curl https://api.hanzo.ai/v1/chat/completions \
-H "Authorization: Bearer $HANZO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "zen5",
"messages": [{"role": "user", "content": "Hello!"}]
}'SDK Usage
Python
from hanzoai import Hanzo
client = Hanzo(api_key="hk-your-api-key")
response = client.chat.completions.create(
model="zen5",
messages=[{"role": "user", "content": "Hello, Zen."}]
)
print(response.choices[0].message.content)TypeScript
import Hanzo from '@hanzo/ai'
const client = new Hanzo({ apiKey: process.env.HANZO_API_KEY })
const completion = await client.chat.completions.create({
model: 'zen5',
messages: [{ role: 'user', content: 'Hello, Zen.' }],
})
console.log(completion.choices[0].message.content)Existing HTTP clients
/v1/chat/completions takes and returns the chat-completions JSON shape, so a
client already written against that shape works here once its base URL points at
https://api.hanzo.ai/v1 and it sends a Hanzo key. Model ids are not portable
across vendors, though — zen5 and enso exist only here.
Architecture
┌─────────────────────────────────────────────────────────────┐
│ HANZO CHAT │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
│ │ React Client │ │ Node.js API │ │ MongoDB │ │
│ │ │ │ │ │ │ │
│ │ - 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 │ Redis │ MinIO │ RAG API │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘Endpoints
| Environment | URL |
|---|---|
| Production | https://chat.hanzo.ai |
| API | https://api.hanzo.ai/v1 |
| Local | http://localhost:3081 |
Pricing
- $5 free credit on every new account (expires in 30 days)
- Prepaid billing — add credits via console.hanzo.ai
- Starting at $0.34/MTok input (
zen5-flash) - No surprise bills — service stops when credits are depleted
Features
Presets, file uploads, RAG, search, vision, conversation management
Configuration
chat.yaml reference, endpoints, MCP tools, model config
Models
Every model in the menu, with its context window and rate
Agents
Custom AI agents with system prompts and tool access
Self-Hosting
Docker, Kubernetes, and cloud deployment guides
Authentication
Hanzo IAM, OAuth2, social login, SSO
In this section
Hanzo Dev
AI-powered coding assistant for your terminal. Install, configure, and operate Hanzo Dev.
Integrations
Connect blob storage, Slack, Mixpanel, and Insights to your project.
Integrations & Extensions
Install and connect Hanzo across your browser, editor, desktop, docs, design tools, and business apps — one…
Features
Configuration
Models
Agents
File Uploads & RAG
Plugins
Moderation
Self-Hosting
Authentication
Environment Variables
How is this guide?
Last updated on