Martin Rizzo 8751d87c32 docs: Add documentation for "Z-Sampler Turbo ^G2" node
This commit introduces detailed documentation for the "Z-Sampler Turbo ^G2"
node within the `/docs` directory.
2026-04-12 14:14:54 -03:00
2026-02-28 22:57:04 -03:00

Z-Image Power Nodes
Pushing the best image generation model to its limits!

Last
Platform License Version Last

Z-Image Power Nodes is a collection of nodes designed specifically for the Z-Image / Z-Image Turbo model. They are based on some ideas and discoveries I made while developing the Amazing Z-Image Workflow.

❤️ 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. Nodes
  2. Examples
  3. Installation
  4. Recommended Checkpoints
  5. 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.

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.

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 1.0 boost contrast and sharpen edges, resulting in a more defined and vibrant look. On the flip side, values below 1.0 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.

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.

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.

Power Nodes Documentation

  • ⚡Z-Sampler Turbo ^G2
    A specialized sampler designed for high-quality image generation, allowing you more control over the final result.
  • ⚡Style Prompt Encoder
    Applies a selected visual styles to your prompt and encodes both of them using a text-encoder model (clip).
  • ⚡Style String Injector
    Seamlessly integrates a chosen style into your prompt text. It accepts a string as input and modifies it based on the selected style.
  • ⚡My Top-10 Styles
    Allows you to create a list of favorite styles for quick selection of your most used ones.
  • ⚡VAE Encode (for Soft Inpainting)
    Encodes images into a latent representation, embedding the mask that indicates where inpainting will be applied.
  • ⚡Save Image
    Saves generated images with the option to embed CivitAI-compatible metadata, making it easy to share generation parameters through that platform.
  • ⚡Empty Z-Image Latent Image
    Creates an empty latent image of the appropriate size for Z-Image, selecting aspect ratio, scale, and orientation.

Examples

/workflows
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.

/styles/samples_wf
This folder includes all the workflows used to generate the thumbnail images in the styles gallery.

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.

How to extract CivitAI workflow into ComfyUI
(*) On CivitAI, each image includes a sidebar panel with metadata. To easily extract the workflow,
click the "COMFY: N Nodes" button in the Other Metadata section and paste it (CTRL+V) directly into ComfyUI.

Installation

Ensure you have the latest version of ComfyUi.

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

🛠️ Manual installation instructions. (expand for details) .
  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
    

Windows Portable Installation

🛠️ Windows portable installation instructions. (expand for details) .
  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
    

GGUF Format

GGUF checkpoints tend to run slightly slower in ComfyUI. However, if you are building a complex workflow that involves other models or using heavy LLMs with ollama, GGUF files can help prevent system freezes and OOM errors during generation, especially when VRAM is limited. For simple image generation workflows, a safetensors file (though heavier) might be preferable. When working with GGUF in Z-Image, from my experience, using the Q5_K_S quantization typically offers the best balance between file size and prompt response.

Note: ComfyUI does not natively support GGUF format, so you need to install the ComfyUI-GGUF nodes.

Safetensors Format

Safetensors files are generally larger, but ComfyUI includes several built-in optimizations to speed up generation even with limited VRAM. It's always a good idea to test the original safetensors checkpoints on your system to see how they perform. However, using safetensors in fp8 format is strongly discouraged as it can significantly reduce quality. If you have an RTX 50 series GPU based on Blackwell architecture, NVFP4 quantized safetensors could be a better choice.

License

Copyright (c) 2026 Martin Rizzo
This project is licensed under the MIT license.
See the "LICENSE" file for details.

S
Description
No description provided
Readme MIT
12 MiB
Languages
Python 75.5%
JavaScript 22.1%
Shell 1.6%
CSS 0.8%