Hanzo Studio
AI-powered content-aware inpainting for videos and images. Intelligently remove and reconstruct content using Hanzo Studio, DiffuEraser, and SAM2.
Part of the Hanzo AI ecosystem.

Features
- 🎨 Content-Aware Inpainting - AI reconstructs removed areas intelligently
- 🪄 Smart Removal - Remove watermarks, objects, blemishes, or any unwanted elements
- 🧠 Context Understanding - Analyzes surroundings to generate realistic fill content
- 🤖 SAM2 Integration - Click-to-segment any object with precision (optional)
- 🎬 Temporal Consistency - Smooth, flicker-free video output across frames
- 🔊 Audio Preservation - Maintains original audio track
- ⚡ GPU-Accelerated - Fast processing with CUDA support
- 🍎 MLX Support - Native Apple Silicon acceleration (70% faster model loading, 35% faster inference)
Quick Start
# Complete setup
make all
# Or step by step
make setup # Install Hanzo Studio + nodes
make download-models # Download SAM2 models
make install-workflow # Copy workflow to Hanzo Studio
make run # Start server on localhost:8188
Visit Quick Start Guide for detailed instructions.
Documentation
- Installation Guide - Detailed setup instructions
- Usage Guide - How to use Hanzo Studio
- Troubleshooting - Common issues and solutions
- GitHub Repository - Source code
How It Works
- Mask Selection - Use SAM2 to click/segment objects or create manual masks
- Context Analysis - AI analyzes surrounding pixels and video frames
- Intelligent Reconstruction - Diffusion model generates realistic fill content
- Temporal Blending - Ensures smooth consistency across frames
- Output - Clean video with removed content seamlessly inpainted
Note: This is true inpainting, not just erasing. The AI intelligently reconstructs what should be there based on context.
Hanzo Hanzo Studio Ecosystem
Hanzo Studio uses a curated stack of Hanzo Studio custom nodes maintained as Hanzo forks. This approach ensures:
- ✅ Stability - Tested versions that work together seamlessly
- ✅ Upstream Sync - Regular updates from original maintainers
- ✅ Hanzo Enhancements - Custom improvements and integrations
- ✅ Unified Support - Single source of truth for the Hanzo ecosystem
Hanzo Custom Nodes
All nodes are available at github.com/hanzoai:
| Node | Purpose | Upstream |
|---|---|---|
| Hanzo-DiffuEraser | Content-aware inpainting | smthemex/Hanzo Studio_DiffuEraser |
| Hanzo-VideoHelper | Video I/O suite | Kosinkadink/ComfyUI-VideoHelperSuite |
| Hanzo-EasyUse | Workflow utilities | yolain/ComfyUI-Easy-Use |
| Hanzo-KJNodes | Core utilities | kijai/ComfyUI-KJNodes |
| Hanzo-LayerStyle | Layer compositing | chflame163/Hanzo Studio_LayerStyle |
| Hanzo-MLX | Apple Silicon acceleration | thoddnn/ComfyUI-MLX |
About
Hanzo Studio is part of the Hanzo AI ecosystem, providing AI infrastructure and services for developers.
- hanzo.ai - Core AI infrastructure platform
- hanzo.ai - Business solutions
- hanzo.network - Decentralized compute marketplace
Made with ❤️ by Hanzo AI