Hanzo Chat
Hanzo Chat
AI chat platform with Zen models, 100+ third-party models, MCP tools, agents, file uploads, and RAG. Self-host or use hosted at chat.hanzo.ai.
Hanzo Chat
Hanzo Chat is a production-ready AI chat platform built on LibreChat. It ships first-party Zen models alongside 100+ third-party models from OpenAI, Anthropic, Google, Meta, Mistral, Together, and Groq. Built-in MCP tool support, configurable agents, file uploads with RAG, vision, conversation history, presets, and plugins make it a complete chat solution.
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": "zen4",
"messages": [{"role": "user", "content": "Hello!"}]
}'SDK Usage
Python
from openai import OpenAI
client = OpenAI(
api_key="hk-your-api-key",
base_url="https://api.hanzo.ai/v1"
)
response = client.chat.completions.create(
model="zen4",
messages=[{"role": "user", "content": "Hello, Zen."}]
)
print(response.choices[0].message.content)TypeScript
import OpenAI from 'openai'
const client = new OpenAI({
apiKey: process.env.HANZO_API_KEY,
baseURL: 'https://api.hanzo.ai/v1',
})
const completion = await client.chat.completions.create({
model: 'zen4',
messages: [{ role: 'user', content: 'Hello, Zen.' }],
})
console.log(completion.choices[0].message.content)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 (LLM Gateway) │ │
│ │ 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.30/MTok (zen3-nano)
- 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
Zen models + 100+ third-party with full pricing
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
Features
Hanzo Chat features — presets, file uploads, RAG, search, vision, conversation import/export, bookmarks, and more.
Configuration
Configure Hanzo Chat — models, endpoints, MCP tools, environment variables, and chat.yaml reference.
Models
All models available in Hanzo Chat — 14 Zen models and 100+ third-party from OpenAI, Anthropic, Google, Meta, Mistral, Together, and Groq.
Agents
Create custom AI agents in Hanzo Chat with system prompts, model selection, and MCP tool access.
File Uploads & RAG
Upload files to Hanzo Chat for context-aware responses using Retrieval-Augmented Generation (RAG).
Plugins
Hanzo Chat plugin system — built-in plugins, ChatGPT plugins, and custom plugin development.
Moderation
Automated moderation system for Hanzo Chat — rate limiting, violation tracking, and user bans.
Self-Hosting
Deploy Hanzo Chat with Docker, Kubernetes, or on cloud providers. Full self-hosting guide with production configuration.
Authentication
Configure authentication for Hanzo Chat — Hanzo IAM, OAuth2/OIDC, social login, and local auth.
Environment Variables
Complete reference for all Hanzo Chat environment variables — server, database, auth, models, moderation, and more.
How is this guide?
Last updated on