hanzo-studio

Hanzo Studio is a visual node-based AI workflow engine for building, testing, and deploying AI pipelines.

Hanzo Studio - Visual AI Workflow Engine

Category: Hanzo Ecosystem Related Skills: hanzo/hanzo-engine.md, hanzo/hanzo-node.md, hanzo/hanzo-flow.md

Overview

Hanzo Studio is a visual node-based AI workflow engine for building, testing, and deploying AI pipelines. Fork of ComfyUI with Hanzo branding, custom nodes, and cloud deployment. Live at studio.hanzo.ai.

Why Hanzo Studio?

• Visual workflows: Drag-and-drop AI pipeline builder
• Custom nodes: Extend with Python — any model, any tool
• API mode: Run workflows programmatically via REST API
• Self-hostable: Docker, K8s, or bare metal
• White-label: Full branding customization

OSS Base

Fork of ComfyUI (comfyanonymous/ComfyUI). Repo: hanzoai/studio.

When to use

• Building visual AI workflows (image gen, text processing, pipelines)
• Creating custom AI node integrations
• Running ComfyUI workflows with Hanzo branding
• Deploying visual AI tools for non-technical users
• White-labeling a visual AI platform

Hard requirements

1. Python 3.10+ with pip
2. Docker for containerized deployment
3. Port 8188 available

Quick reference

| Item | Value | |------|-------| | UI | https://studio.hanzo.ai | | Port | 8188 | | Image | ghcr.io/hanzoai/studio:latest | | Repo | github.com/hanzoai/studio | | Branch | main | | Upstream | comfyanonymous/ComfyUI |

One-file quickstart

Docker

docker run -d --name hanzo-studio \
 -p 8188:8188 \
 --cpus=1 --memory=2g \
 ghcr.io/hanzoai/studio:latest \
 --cpu --listen 0.0.0.0

API mode (run workflow)

curl -X POST http://localhost:8188/prompt \
 -H "Content-Type: application/json" \
 -d '{
 "prompt": {
 "1": {
 "class_type": "KSampler",
 "inputs": {
 "seed": 42,
 "steps": 20,
 "cfg": 7.0,
 "sampler_name": "euler",
 "scheduler": "normal"
 }
 }
 }
 }'

Core Concepts

Branding Approach

CRITICAL: Never do blanket sed 's/ComfyUI/Hanzo Studio/g' on minified JS — it breaks class definitions, property assignments, and dynamic imports.

Use branding/patch_frontend.py (Python, context-aware):

• Only touches display strings, URLs, and quoted contexts
• Logo SVGs replaced directly (comfy-logo → hanzo-logo.svg)
• Favicon generated as ICO with H mark bitmap

Custom Node Development

# custom_nodes/hanzo_inference.py
class HanzoInference:
 @classmethod
 def INPUT_TYPES(cls):
 return {
 "required": {
 "prompt": ("STRING", {"multiline": True}),
 "model": (["zen-70b", "zen-32b", "zen-14b"],),
 "temperature": ("FLOAT", {"default": 0.7, "min": 0.0, "max": 2.0}),
 }
 }

 RETURN_TYPES = ("STRING",)
 FUNCTION = "inference"
 CATEGORY = "Hanzo AI"

 def inference(self, prompt, model, temperature):
 import requests
 resp = requests.post("https://api.hanzo.ai/v1/chat/completions",
 headers={"Authorization": f"Bearer {os.environ['HANZO_API_KEY']}"},
 json={"model": model, "messages": [{"role": "user", "content": prompt}],
 "temperature": temperature})
 return (resp.json()["choices"][0]["message"]["content"],)

NODE_CLASS_MAPPINGS = {"HanzoInference": HanzoInference}
NODE_DISPLAY_NAME_MAPPINGS = {"HanzoInference": "Hanzo AI Inference"}

Kubernetes Deployment

apiVersion: apps/v1
kind: Deployment
metadata:
 name: hanzo-studio
spec:
 replicas: 1
 selector:
 matchLabels:
 app: hanzo-studio
 template:
 spec:
 containers:
 - name: studio
 image: ghcr.io/hanzoai/studio:latest
 args: ["--cpu", "--listen", "0.0.0.0"]
 ports:
 - containerPort: 8188
 resources:
 requests:
 cpu: 250m
 memory: 512Mi
 limits:
 cpu: "1"
 memory: 2Gi

White-Label

1. Fork hanzoai/studio
2. Edit branding/patch_frontend.py with your logo/colors
3. Run python branding/patch_frontend.py during Docker build
4. Deploy with your domain

Troubleshooting

| Issue | Cause | Solution | |-------|-------|----------| | Broken class names in UI | Used sed on minified JS | Use patch_frontend.py only | | OOM on large workflows | Insufficient memory | Increase K8s memory limit | | Custom nodes not loading | Wrong directory | Place in custom_nodes/ |

Related Skills

• hanzo/hanzo-engine.md - Rust inference engine for backends
• hanzo/hanzo-flow.md - Alternative workflow builder
• hanzo/hanzo-chat.md - LLM API for custom nodes

---

Last Updated: 2026-03-13 Category: Hanzo Ecosystem Related: comfyui, visual-ai, workflows, studio Prerequisites: Python, Docker, AI pipeline concepts