Hanzo Charts

Hanzo Charts is the official Helm chart repository for all Hanzo services and infrastructure. Contains 16 charts covering core services (IAM, KMS, Gateway), AI services (Cloud, Agents, LLM), platfo...

Overview

Hanzo Charts is the official Helm chart repository for all Hanzo services and infrastructure. Contains 16 charts covering core services (IAM, KMS, Gateway), AI services (Cloud, Agents, LLM), platform services (Console, GitOps, Platform), business services (Commerce, Analytics), and infrastructure (Storage, Bootnode, MPC, Datastore, Edge, Net).

Why Hanzo Charts?

16 charts: Complete coverage of every Hanzo service
Unified configuration: Global values for domain, registry, storage class, TLS
Upstream tracking: Charts for KrakenD, vLLM, Agnost, Dokploy with version pinning
Chart Testing: CI with ct (chart-testing) for linting and validation
Helm repo: Published to https://charts.hanzo.ai

Tech Stack

Helm 3.12+
Kubernetes 1.25+
Chart Testing: ct.yaml configuration
CI: GitHub Actions for lint/test/publish
Language: Go Template (Helm templates)

When to use

Deploying individual Hanzo services via Helm
Installing a full Hanzo stack with a single umbrella chart
Customizing service configuration via values.yaml overrides
Templating K8s manifests for Hanzo infrastructure

Hard requirements

Helm 3.12+
Kubernetes 1.25+ cluster
Access to ghcr.io/hanzoai/* container images

Quick reference

Item	Value
Repo URL	`https://charts.hanzo.ai`
Chart count	16
Source	`github.com/hanzoai/charts`
Branch	`main`
License	Apache 2.0
Chart testing	`ct.yaml` at repo root

Available Charts

Core Services

Chart	Path	Description
`iam`	`charts/iam/`	Identity and Access Management (Hanzo IAM-based)
`kms`	`charts/kms/`	Key Management Service (Hanzo KMS-based)
`gateway`	`charts/gateway/`	API Gateway (KrakenD-based)

AI Services

Chart	Path	Description
`cloud`	`charts/cloud/`	Multi-tenant AI/MCP platform
`agents`	`charts/agents/`	AI Agent orchestration
`llm`	`charts/llm/`	LLM serving (vLLM-based)

Platform Services

Chart	Path	Description
`console`	`charts/console/`	Admin Console UI
`gitops`	`charts/gitops/`	K8s CI/CD (Agnost-based)
`platform`	`charts/platform/`	Local dev platform (Dokploy-based)

Business Services

Chart	Path	Description
`commerce`	`charts/commerce/`	Multi-tenant Commerce
`analytics`	`charts/analytics/`	Analytics service

Infrastructure

Chart	Path	Description
`storage`	`charts/storage/`	S3-compatible object storage
`bootnode`	`charts/bootnode/`	Blockchain infrastructure
`mpc`	`charts/mpc/`	Threshold signatures (TSS)
`net`	`charts/net/`	Network infrastructure
`edge`	`charts/edge/`	Edge compute

Repository Structure

charts/
  agents/        # Chart.yaml, templates/, values.yaml
  analytics/
  bootnode/
  cloud/
  commerce/
  console/
  edge/
  gateway/
  gitops/
  iam/
  kms/
  llm/
  mpc/
  net/
  platform/
  storage/
.github/
  workflows/     # CI for lint, test, publish
ct.yaml          # Chart Testing configuration
README.md
LICENSE          # Apache 2.0

Each chart directory contains:

Chart.yaml -- chart metadata, version, dependencies
values.yaml -- default configuration values
templates/ -- Helm templates for K8s resources

Installation

# Add Hanzo Helm repo
helm repo add hanzo https://charts.hanzo.ai
helm repo update

# Install individual chart
helm install hanzo-iam hanzo/iam -n hanzo --create-namespace
helm install hanzo-gateway hanzo/gateway -n hanzo
helm install hanzo-cloud hanzo/cloud -n hanzo

# Install full stack (umbrella)
helm install hanzo hanzo/stack -n hanzo --create-namespace \
  --set global.domain=yourdomain.com \
  --set iam.enabled=true \
  --set gateway.enabled=true \
  --set cloud.enabled=true \
  --set console.enabled=true

Global Values

global:
  domain: hanzo.ai
  imageRegistry: ghcr.io/hanzoai
  storageClass: do-block-storage
  tls:
    enabled: true
    issuer: letsencrypt-prod

Development

# Lint all charts
helm lint charts/*

# Template a chart (debug)
helm template test charts/iam --debug

# Install with dry-run
helm install test charts/iam --dry-run --debug

# Run chart-testing
ct lint --config ct.yaml
ct install --config ct.yaml

Architecture

                +-----------------+
                | hanzo-gateway   | (KrakenD)
                |  LoadBalancer   |
                +--------+--------+
                         |
     +-------------------+-------------------+
     |                   |                   |
+----v----+        +-----v-----+       +-----v-----+
|hanzo-iam|        |hanzo-cloud|       |hanzo-api  |
| (Auth)  |        | (AI/MCP)  |       | (Services)|
+----+----+        +-----+-----+       +-----+-----+
     |                   |                   |
     +-------------------+-------------------+
                         |
                +--------v--------+
                |hanzo-datastore  | (Shared)
                |PostgreSQL/Redis |
                +-----------------+

Observability

VictoriaMetrics for metrics (not Prometheus server -- charts expose /metrics endpoints)
Grafana for dashboards
Hanzo Datastore for logs and analytics

Upstream Tracking

Hanzo Chart	Upstream	Version
`gateway`	KrakenD CE	Latest 2.x
`gitops`	Agnost GitOps	hanzoai/gitops fork
`platform`	Dokploy	Latest main
`llm`	vLLM	Latest stable

Troubleshooting

Issue	Cause	Solution
Chart not found	Repo not added	`helm repo add hanzo https://charts.hanzo.ai`
Template error	Missing values	Check `values.yaml` defaults
Image pull fail	Registry auth	Configure imagePullSecrets
CRD conflicts	Operator also managing	Use either operator OR charts, not both

hanzo/hanzo-operator.md - K8s operator (CRD alternative to Helm)
hanzo/hanzo-universe.md - Universe manifests (raw Kustomize)
hanzo/hanzo-stack.md - Docker Compose local stack

On this page