Extensions/ComfyUI-ZImagePowerNodes
ComfyUI Extension

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!

By martin-rizzo·Created 7 months ago·Updated about 13 hours ago· 349
martin-rizzo/ComfyUI-ZImagePowerNodes
Nodes31
On cloudLocal install
Category⚡Z-Image/__experimental, ⚡Z-Image/utils
Stars349
Updatedabout 13 hours ago

Nodes (31)

⚗️🔬| Advanced VAE Decoder ^X2.1

Decode outside the box — a VAE decoder that skips the clamp and tiles when VRAM runs low

⚡Z-Image/__experimental
⚡| Comfy-Kitchen Attention Enabler

A one-click attention backend switch that quietly no-ops on old ComfyUI

⚡Z-Image/utils
❌[DEPRECATED] Custom Style + Prompt Encoder ^X2.1

Bring your own style — define style templates right in the node, then encode them

⚡Z-Image/__deprecated
⚡| Empty Z-Image Latent Image

An empty latent that already knows Z-Image's 1–2MP sweet spot

⚡Z-Image
❌[DEPRECATED] Illustration-Style Prompt Encoder

A deprecated style encoder — still works, but the successor does everything it does

⚡Z-Image/__deprecated
⚡| Image Filter

A three-layer color grade in one node — Z-Image's answer to 'it's almost right'

⚡Z-Image/utils
⚡| Image Grid Builder

Turn a batch of Z-Image renders into a labeled contact sheet in one node

⚡Z-Image/utils
⚡| Image Labeler

Stamp a text label onto any image — the current version of the pack's labeler

⚡Z-Image/utils
❌[DEPRECATED] Image Labeler (old version)

The old Image Labeler — fine to leave in saved workflows, but Labeler 2 supersedes it

⚡Z-Image/__deprecated
⚗️🔬| Load Qwen3-4B Model (safetensors / gguf)

The Qwen3-4B text encoder loader that speaks safetensors and GGUF

⚡Z-Image/__experimental
⚗️🔬| Load Z-Image Model (safetensors / gguf)

The diffusion-model loader that sees both your safetensors and GGUF Z-Image files

⚡Z-Image/__experimental
⚡| My Top-10 Styles (Editor)

Pick your ten favorite styles once — this editor builds the list the selector uses

⚡Z-Image
⚡| My Top-10 Styles

Your ten favorite styles as ten toggles — one click and the style is applied

⚡Z-Image
⚗️🔬| Palette Library v2.0

Pick a color palette without writing a color novel

⚡Z-Image/__experimental
❌[DEPRECATED] Photo-Style Prompt Encoder

The deprecated photo-style encoder — your saved workflows still open, that's about it

⚡Z-Image/__deprecated
⚡| Save Image

Save Image that stamps in CivitAI-readable metadata — post to CivitAI without re-typing your prompt

⚡Z-Image
⚗️🔬| Style Library v1.0

123 Z-Image styles with one click — no LoRA, no prompt surgery

⚡Z-Image/__experimental
⚡| Style & Prompt Encoder

The style encoder that turned Z-Image from 'plain' into a lookbook — and the one you should be using

⚡Z-Image
❌[DEPRECATED] Style + Prompt Encoder ^X2.1

The G2.1 style encoder — the stable node's brain plus color palettes and five outputs

⚡Z-Image/__deprecated
⚗️🔬| Style + Prompt Encoder ^X2.2 (Advanced)

Where Z-Image prompts actually get built

⚡Z-Image/__experimental
❌[DEPRECATED] Style & Prompt Encoder (old version)

The original Style & Prompt Encoder — deprecated, but it's the one that started the library

⚡Z-Image/__deprecated
⚡| Style String Injector

Style as text, not conditioning — the injector that works with any encoder you already have

⚡Z-Image
❌[DEPRECATED] Style String Injector (old version)

The old way to inject a style into your prompt — you probably want the new one

⚡Z-Image/__deprecated
⚡| VAE Encode (for Soft Inpainting)

The soft VAE encode, explained

⚡Z-Image
⚡| Z-Sampler Turbo v2 (Advanced)

The G2 sampler with the training wheels off — for chaining samplers

⚡Z-Image
❌[DEPRECATED] Z-Sampler Turbo v2 (Laboratory)

The G2 sampler's lab bench — every knob the author used to build it

⚡Z-Image/__deprecated
⚡| Z-Sampler Turbo v2 (Simple)

The Z-Sampler Turbo node you should actually use (and the 3-stage trick behind it)

⚡Z-Image
⚡| Z-Sampler Turbo v2 (Extended)

Extended controls, same three-stage magic

⚡Z-Image
❌[DEPRECATED] Z-Sampler Turbo v1 (Advanced)

The old ^g1 sampler's advanced twin — where noise calibration came from

⚡Z-Image/__deprecated
⚗️🔬| Z-Sampler Turbo ^X2.1

Spectral tilt, latent scaling, and other future stuff

⚡Z-Image/__experimental
❌[DEPRECATED] Z-Sampler Turbo v1

The original Z-Sampler Turbo that started it all (now deprecated)

⚡Z-Image/__deprecated
Readme
<div align="center">

Z-Image Power Nodes v2.1<br><sub><sup><i>Pushing the best image generation model to its limits!</i></sup></sub>

Last
Platform License Version Last
<img src="banner_readme_v20.jpg" width="90%"></img>

</div>

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:

Every contribution, no matter how small, is greatly appreciated! Thank you.

Table of Contents

  1. Features
  2. Documentation
  3. Examples
  4. Installation
  5. Recommended Checkpoints
  6. License

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>

<!-- [__/styles/samples_wf__](/styles/samples_wf) This folder includes all the workflows used to generate the thumbnail images in the styles gallery. -->

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:

  1. Open ComfyUI and click on the "Manager" button to launch the "ComfyUI Manager Menu".
  2. Within the ComfyUI Manager, locate and click on the "Custom Nodes Manager" button.
  3. In the search bar, type "Z-Image Power Nodes".
  4. Select the option from the search results and click the "Install" button.
  5. Restart ComfyUI to ensure the changes take effect.

Manual Installation

<details> <summary>🛠️ Manual installation instructions. (expand for details)</summary> .
  1. Open your preferred terminal application.
  2. Navigate to your ComfyUI directory:
    cd <your_comfyui_directory>
    
  3. Move into the custom_nodes folder and clone the repository:
    cd custom_nodes
    git clone https://github.com/martin-rizzo/ComfyUI-ZImagePowerNodes.git
    
</details>

Windows Portable Installation

<details> <summary>🛠️ Windows portable installation instructions. (expand for details)</summary> .
  1. Go to where you unpacked ComfyUI_windows_portable,
    you'll find your run_nvidia_gpu.bat file here, confirming the correct location.
  2. Press CTRL + SHIFT + RightClick in an empty space and select "Open PowerShell window here".
  3. Clone the repository into your custom nodes folder using:
    git clone https://github.com/martin-rizzo/ComfyUI-ZImagePowerNodes .\ComfyUI\custom_nodes\ComfyUI-ZImagePowerNodes
    
</details>

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

GGUF (Q8/Q5)

Safetensors (BF16)

Safetensors (FP8) [NOT RECOMMENDED, use only as a last resort]

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.