ComfyUI-ZImagePowerNodes
A set of ComfyUI nodes designed and fine-tuned specifically for the Z-Image model. Pushing the best image generation model to its limits!
Nodes (31)
Decode outside the box — a VAE decoder that skips the clamp and tiles when VRAM runs low
A one-click attention backend switch that quietly no-ops on old ComfyUI
Bring your own style — define style templates right in the node, then encode them
An empty latent that already knows Z-Image's 1–2MP sweet spot
A deprecated style encoder — still works, but the successor does everything it does
A three-layer color grade in one node — Z-Image's answer to 'it's almost right'
Turn a batch of Z-Image renders into a labeled contact sheet in one node
Stamp a text label onto any image — the current version of the pack's labeler
The old Image Labeler — fine to leave in saved workflows, but Labeler 2 supersedes it
The Qwen3-4B text encoder loader that speaks safetensors and GGUF
The diffusion-model loader that sees both your safetensors and GGUF Z-Image files
Pick your ten favorite styles once — this editor builds the list the selector uses
Your ten favorite styles as ten toggles — one click and the style is applied
Pick a color palette without writing a color novel
The deprecated photo-style encoder — your saved workflows still open, that's about it
Save Image that stamps in CivitAI-readable metadata — post to CivitAI without re-typing your prompt
123 Z-Image styles with one click — no LoRA, no prompt surgery
The style encoder that turned Z-Image from 'plain' into a lookbook — and the one you should be using
The G2.1 style encoder — the stable node's brain plus color palettes and five outputs
Where Z-Image prompts actually get built
The original Style & Prompt Encoder — deprecated, but it's the one that started the library
Style as text, not conditioning — the injector that works with any encoder you already have
The old way to inject a style into your prompt — you probably want the new one
The soft VAE encode, explained
The G2 sampler with the training wheels off — for chaining samplers
The G2 sampler's lab bench — every knob the author used to build it
The Z-Sampler Turbo node you should actually use (and the 3-stage trick behind it)
Extended controls, same three-stage magic
The old ^g1 sampler's advanced twin — where noise calibration came from
Spectral tilt, latent scaling, and other future stuff
The original Z-Sampler Turbo that started it all (now deprecated)
Z-Image Power Nodes v2.1<br><sub><sup><i>Pushing the best image generation model to its limits!</i></sup></sub>
<img src="banner_readme_v20.jpg" width="90%"></img>
Z-Image Power Nodes is a collection of nodes designed specifically for the Z-Image / Z-Image Turbo model, they are based on some discoveries I made while developing the Amazing Z-Image Workflow.
Version 2.1 Updates
Starting with v2.1, the nodes are optimized for the latest features in ComfyUI, ensuring compatibility with recent updates such as Nodes 2.0, Int8-ConvRot, and ComfyKitchen-Attention. However, backward compatibility is maintained with older versions (minimum: Python 3.10, PyTorch 2.5, and ComfyUI v0.11.0).
Additionally, experimental nodes are included for testing new concepts or simplifying user interfaces. These nodes are subject to change or removal in future updates, use them at your own discretion.
Support This Project
❤️ If you find these nodes useful or they’ve helped you in your projects, please consider supporting my work.
Your support allows me to continue researching and creating new developments within the open source community.
There are several ways to do so:
- Give the repository a star: if we reach 500 stars, big things could happen!
- Ko-fi: https://ko-fi.com/martinrizzo
Every contribution, no matter how small, is greatly appreciated! Thank you.
Table of Contents
Features
Visual Styles
The "Style & Prompt Encoder" node comes with a library of over 100 predefined styles. Just pick one, and the node automatically handles the prompting to shift your image's artistic direction. You can browse them all via a searchable gallery with thumbnails for quick previews. It's the perfect way to nail a consistent look without wrestling with complex prompts, all while keeping your original subject and composition intact.
<img src="docs/figures/__figure__styles.jpg" width="90%"></img>
Consistency with Low Steps
The "Z-Sampler Turbo" node maintains image consistency from 3 steps onwards. Since there are minimal variations in composition, you can quickly test prompt changes with just a few steps and then crank them up later for a high-quality version. Along those lines, the sampler produces a more than acceptable result with only 5 steps, and once you hit 7 or more, the quality is high enough that you won't even need any further post-processing.
<img src="docs/figures/__figure__steps.jpg" width="90%"></img>
Intensity Control
Intensity is a parameter within the "Z-Sampler Turbo" node that tweaks the amplitude of the initial noise to give your images more contrast and saturation. Values above 0.0 (positives) boost contrast and sharpen edges, resulting in a more defined and vibrant look. On the flip side, values below 0.0 (negatives) yield a softer, more "washed-out" look with less micro-detail.
Just keep in mind that the final result depends a lot on your prompt and the specific style you're using. It's not a hard rule, but lower values usually complement photographic styles better, while higher values tend to work well for illustrations.
<img src="docs/figures/__figure__intensity.jpg" width="90%"></img>
Intensity Bias is a companion parameter that lets you calibrate the bias of the initial noise. You'll usually want to keep this at 0.0. You could think of it as adjusting the "brightness". Since its effect depends heavily on the prompt and image style, it doesn't always act as a simple brightness control. In some cases, it can even affect how in-focus the image looks. Just tweak it within the positive or negative range until it looks right to you.
<img src="docs/figures/__figure__intensity_bias.jpg" width="90%"></img>
Turbo Creativity
Turbo Creativity is an option in the "Z-Sampler Turbo" node that uses latent scrambling to increase variety without messing up the visual style or prompt. This feature attempts to improve the limited image variability seen across different seeds in Z-Image Turbo.
Currently, it only affects composition (like posing, framing, and object placement) while keeping colors and style consistent. Because this process can lead to hallucinations, I've added "refined" options that throw in some extra sampling steps to keep the image coherent. Note that using these refined options will increase the total generation time.
<img src="docs/figures/__figure__turbo_creativity.jpg" width="90%"></img>
Other Extras
I've also included some smaller utility nodes to make things easier. There's a VAE encoder for inpainting with Z-Image-specific parameters, a node with one-click activation for your 10 most-used styles, a node to save images with CivitAI-compatible metadata, and a few other bits and pieces.
Power Nodes Documentation
- ⚡Z-Sampler Turbo v2 (Simple)
<sub>Simplified and recommended version of Z-Sampler Turbo, offering an easy-to-use interface with all its features.</sub> - ⚡Z-Sampler Turbo v2 (Extended)
<sub>Original version of Z-Sampler Turbo, allowing you more control over the final result.</sub> - ⚡Style Prompt Encoder
<sub>Applies a selected visual styles to your prompt and encodes both of them using a text-encoder model (clip). - ⚡Style String Injector
<sub>Seamlessly integrates a chosen style into your prompt text. It accepts a string as input and modifies it based on the selected style.</sub> - ⚡My Top-10 Styles
<sub>Allows you to create a list of favorite styles for quick selection of your most used ones.</sub> - ⚡VAE Encode (for Soft Inpainting)
<sub>Encodes images into a latent representation, embedding the mask that indicates where inpainting will be applied.</sub> - ⚡Save Image
<sub>Saves generated images with the option to embed CivitAI-compatible metadata, making it easy to share generation parameters through that platform.</sub> - ⚡Empty Z-Image Latent Image
<sub>Creates an empty latent image of the appropriate size for Z-Image, selecting aspect ratio, scale, and orientation.</sub>
Examples
/workflows/release
This folder contains reference workflows demonstrating the use of the Power Nodes across various tasks.
These are simple yet powerful examples that serve as an excellent resource for understanding how to utilize
each node.
Z-Image Power Nodes on CivitAI
This page contains hundreds of images created using the Z-Image model and the Power Nodes.
Images posted by me always include the prompt and complete workflow (*), which you can use as a
starting point for your own generation. Many users share their amazing creations in this community.
<img alt="How to extract CivitAI workflow into ComfyUI" src="image-civitai2.jpg" width="60%"></img>
<sub>(*) On CivitAI, each image includes a sidebar panel with metadata. To easily extract the workflow,
click the "COMFY 14 Nodes" button in the Other Metadata section and paste it (CTRL+V) directly into ComfyUI.</sub>
Installation
Ensure you have the latest version of ComfyUi.
Installation via ComfyUI Manager (Recommended)
The easiest way to install the nodes is through ComfyUI-Manager:
- Open ComfyUI and click on the "Manager" button to launch the "ComfyUI Manager Menu".
- Within the ComfyUI Manager, locate and click on the "Custom Nodes Manager" button.
- In the search bar, type "Z-Image Power Nodes".
- Select the option from the search results and click the "Install" button.
- Restart ComfyUI to ensure the changes take effect.
Manual Installation
<details> <summary>🛠️ Manual installation instructions. (expand for details)</summary> .- Open your preferred terminal application.
- Navigate to your ComfyUI directory:
cd <your_comfyui_directory> - Move into the custom_nodes folder and clone the repository:
cd custom_nodes git clone https://github.com/martin-rizzo/ComfyUI-ZImagePowerNodes.git
Windows Portable Installation
<details> <summary>🛠️ Windows portable installation instructions. (expand for details)</summary> .- Go to where you unpacked ComfyUI_windows_portable,
you'll find yourrun_nvidia_gpu.batfile here, confirming the correct location. - Press CTRL + SHIFT + RightClick in an empty space and select "Open PowerShell window here".
- Clone the repository into your custom nodes folder using:
git clone https://github.com/martin-rizzo/ComfyUI-ZImagePowerNodes .\ComfyUI\custom_nodes\ComfyUI-ZImagePowerNodes
Recommended Checkpoints
I currently recommend checkpoints quantized with "CONVROT" algorithms for ComfyUI; they provide the best balance of speed, quality, and compatibility for older hardware. Although GGUF has better size-to-quality ratios, its ComfyUI support is non-native and 'problematic', as Comfy himself seems to be waging a crusade against the format. 🙃
Workflows in the '/workflows/release/' directory currently use the old formats (pre-CONVROT), but I may update them for v3.0 in the future. Below in the list, I've included links to alternative checkpoints that work well if CONVROT isn't performing optimally on your hardware or if you're using tools like stablediffusion.cpp.
Int8-CONVROT
- z_image_turbo_int8_convrot_bf16emixed.safetensors <sub>[6.17 GB]</sub>
Local Directory:ComfyUI/models/diffusion_models/ - qwen3-4b_int8_convrot_fp16emixed.safetensors <sub>[4.42 GB]</sub>
Local Directory:ComfyUI/models/text_encoders/ - Z-Image_half_natural_vae.safetensors <sub>[335 MB]</sub>
Local Directory:ComfyUI/models/vae/
GGUF (Q8/Q5)
- z_image_turbo-Q5_K_S.gguf <sub>[5.19 GB]</sub>
Local Directory:ComfyUI/models/diffusion_models/ - Qwen3-4B-Q8_0.gguf <sub>[4.28 GB]</sub>
Local Directory:ComfyUI/models/text_encoders/ - ae.safetensors <sub>[335 MB]</sub>
Local Directory:ComfyUI/models/vae/
Safetensors (BF16)
- z_image_turbo_bf16.safetensors <sub>(12.3 GB)</sub>
Local Directory:ComfyUI/models/diffusion_models/ - qwen_3_4b.safetensors <sub>(8.04 GB)</sub>
Local Directory:ComfyUI/models/text_encoders/ - ae.safetensors <sub>(335 MB)</sub>
Local Directory:ComfyUI/models/vae/
Safetensors (FP8) [NOT RECOMMENDED, use only as a last resort]
- z-image-turbo_fp8_scaled_e4m3fn_KJ.safetensors <sub>(6.16 GB)</sub>
Local Directory:ComfyUI/models/diffusion_models/ - qwen3_4b_fp8_scaled.safetensors <sub>(4.41 GB)</sub>
Local Directory:ComfyUI/models/text_encoders/ - ae.safetensors <sub>(335 MB)</sub>
Local Directory:ComfyUI/models/vae/
Note: If you’re considering using FP8 checkpoints (other than the ones recommended here), test them carefully. Most FP8 models I’ve tried suffer from naive truncation, which severely reduces precision by omitting techniques like scaling and mixing in higher-precision data types.
License
Copyright (c) 2026 Martin Rizzo
This project is licensed under the MIT license.
See the "LICENSE" file for details.