Hanzo AI Platform Services

Hanzo provides a comprehensive suite of AI-first platform services designed for enterprise-grade applications. All services use unified OAuth2/OIDC authentication via Hanzo IAM.

Service Architecture

┌─────────────────────────────────────────────────────────────────────────┐
│                          HANZO AI PLATFORM                               │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌─────────────┐ │
│  │  Identity    │  │     IAM      │  │     KMS      │  │   Gateway   │ │
│  │ identity.*   │  │  iam.hanzo   │  │  kms.hanzo   │  │gateway.hanzo│ │
│  │              │  │              │  │              │  │             │ │
│  │  - Profiles  │  │  - OAuth2    │  │  - MPC Keys  │  │  - LLM API  │ │
│  │  - Directory │  │  - OIDC      │  │  - HSM       │  │  - Routing  │ │
│  │  - Resolve   │  │  - Web3      │  │  - Signing   │  │  - Caching  │ │
│  └──────────────┘  └──────────────┘  └──────────────┘  └─────────────┘ │
│                                                                          │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌─────────────┐ │
│  │    Auto      │  │    Flow      │  │   Engine     │  │   Vector    │ │
│  │ auto.hanzo   │  │ flow.hanzo   │  │ engine.*     │  │vector.hanzo │ │
│  │              │  │              │  │              │  │             │ │
│  │  - Workflows │  │  - LLM Pipes │  │  - Runtime   │  │  - Search   │ │
│  │  - Triggers  │  │  - Agents    │  │  - Scheduler │  │  - Embed    │ │
│  │  - 600+ Apps │  │  - RAG Build │  │  - Observe   │  │  - Index    │ │
│  └──────────────┘  └──────────────┘  └──────────────┘  └─────────────┘ │
│                                                                          │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌─────────────┐ │
│  │    Nexus     │  │     ML       │  │    Cloud     │  │  Analytics  │ │
│  │ nexus.hanzo  │  │   ml.hanzo   │  │ cloud.hanzo  │  │ analytics.* │ │
│  │              │  │              │  │              │  │             │ │
│  │  - RAG       │  │  - Pipelines │  │  - Deploy    │  │  - Cost     │ │
│  │  - Knowledge │  │  - Registry  │  │  - Infra     │  │  - Usage    │ │
│  │  - Agents    │  │  - Toolkit   │  │  - Serving   │  │  - SLOs     │ │
│  └──────────────┘  └──────────────┘  └──────────────┘  └─────────────┘ │
│                                                                          │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  ┌─────────────┐ │
│  │    Chat      │  │   Commerce   │  │   Console    │  │   Hub       │ │
│  │ chat.hanzo   │  │  api.hanzo   │  │console.hanzo │  │hub.hanzo.bot│ │
│  │              │  │              │  │              │  │             │ │
│  │  - 14 Zen   │  │  - Orders    │  │  - Observe   │  │  - Skills   │ │
│  │  - 100+ LLM │  │  - Payments  │  │  - Monitor   │  │  - Personas │ │
│  │  - MCP Tools│  │  - Products  │  │  - Traces    │  │  - 600+ Int │ │
│  │  - Agents   │  │  - Analytics │  │  - Logs      │  │  - Registry │ │
│  └──────────────┘  └──────────────┘  └──────────────┘  └─────────────┘ │
│                                                                          │
└─────────────────────────────────────────────────────────────────────────┘

Core Services

Service	Endpoint	Description
Chat	`chat.hanzo.ai`	AI chat with 14 Zen models, 100+ third-party, MCP tools, agents
Identity	`TBD`	Profiles, directories, and identity resolution
IAM	`iam.hanzo.ai`	Identity, authentication, OAuth2/OIDC, Web3, MPC auth
KMS	`kms.hanzo.ai`	Key management, MPC custody, HSM, signing
Gateway	`gateway.hanzo.ai`	LLM API gateway, routing, caching, rate limiting
Auto	`auto.hanzo.ai`	Workflow automation, 600+ integrations, triggers
Flow	`flow.hanzo.ai`	Visual AI workflow builder, LLM pipelines, RAG
Engine	`TBD`	Core runtime, scheduling, orchestration
Vector	`vector.hanzo.ai`	Vector database, embeddings, similarity search
Nexus	`nexus.hanzo.ai`	RAG, knowledge graphs, agents, memory
ML	`TBD`	Kubeflow pipelines and Rust ML toolkit
Cloud	`cloud.hanzo.ai`	AI platform, deployment, infrastructure
Analytics	`TBD`	Usage, cost, and performance analytics
Commerce	`api.hanzo.ai`	E-commerce API, orders, payments, products

Authentication

All services authenticate via Hanzo IAM using OAuth2/OIDC:

import { HanzoClient } from '@hanzo/sdk'

const client = new HanzoClient({
  apiKey: process.env.HANZO_API_KEY,
  // Or use OAuth2
  accessToken: 'your-access-token'
})

API Keys

Generate API keys via the Gateway API:

curl -X POST https://gateway.hanzo.ai/key/generate \
  -H "Authorization: Bearer $HANZO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "models": ["claude-3-opus", "gpt-4", "*"],
    "max_budget": 1000.00
  }'

OAuth2 Flow

1. Redirect → https://iam.hanzo.ai/login/oauth/authorize
2. User authenticates
3. Callback with authorization code
4. Exchange code → https://iam.hanzo.ai/api/login/oauth/access_token
5. Use access token for API calls

OpenAPI Specifications

Available OpenAPI 3.1 specifications:

Service	Spec URL
IAM	`https://iam.hanzo.ai/.well-known/openapi.yaml`
Gateway	`https://gateway.hanzo.ai/openapi.yaml`
Vector	`https://vector.hanzo.ai/openapi.yaml`
Nexus	`https://nexus.hanzo.ai/openapi.yaml`
Cloud	`https://cloud.hanzo.ai/openapi.yaml`
Commerce	`https://api.hanzo.ai/openapi.yaml`

SDKs

Official SDKs are available in multiple languages:

TypeScript/JavaScript: @hanzo/sdk, @hanzo/commerce
Python: hanzoai, hanzo-mcp
Go: github.com/hanzoai/go-sdk
Rust: hanzo-rs

Environment Variables

Standard environment variables across all SDKs:

# API Access
HANZO_API_KEY=your-api-key
HANZO_TOKEN=your-oauth-token

# Service Endpoints (optional, use defaults)
HANZO_IAM_URL=https://iam.hanzo.ai
HANZO_IDENTITY_URL=
HANZO_GATEWAY_URL=https://gateway.hanzo.ai
HANZO_ENGINE_URL=
HANZO_VECTOR_URL=https://vector.hanzo.ai
HANZO_NEXUS_URL=https://nexus.hanzo.ai
HANZO_ML_URL=
HANZO_CLOUD_URL=https://cloud.hanzo.ai
HANZO_ANALYTICS_URL=
HANZO_COMMERCE_URL=https://api.hanzo.ai
HANZO_CHAT_URL=https://chat.hanzo.ai