https://github.com/martin-rizzo/ComfyUI-ZImagePowerNodes
A set of ComfyUI nodes designed and fine-tuned specifically for the Z-Image model.
https://github.com/martin-rizzo/ComfyUI-ZImagePowerNodes
comfy-nodes comfyui comfyui-nodes image-generation text2image txt2img z-image z-image-turbo
Last synced: 5 months ago
JSON representation
A set of ComfyUI nodes designed and fine-tuned specifically for the Z-Image model.
- Host: GitHub
- URL: https://github.com/martin-rizzo/ComfyUI-ZImagePowerNodes
- Owner: martin-rizzo
- License: mit
- Created: 2026-01-16T17:09:35.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2026-02-02T00:18:31.000Z (5 months ago)
- Last Synced: 2026-02-02T10:18:20.318Z (5 months ago)
- Topics: comfy-nodes, comfyui, comfyui-nodes, image-generation, text2image, txt2img, z-image, z-image-turbo
- Language: Python
- Homepage:
- Size: 774 KB
- Stars: 102
- Watchers: 1
- Forks: 7
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-comfyui - **ComfyUI-ZImagePowerNodes** - tuned specifically for the Z-Image model. Pushing the best image generation model to its limits! (Workflows pushed today)
README
# Z-Image Power Nodes
Pushing the best image generation model to its limits!
[](#)
[](#)
[](#)
[](#)
**ComfyUI-ZImagePowerNodes** is a collection of custom nodes designed and refined specifically for the [Z-Image model](https://github.com/Tongyi-MAI/Z-Image). They are based on some ideas and discoveries I made while developing the [Amazing Z-Image Workflow](https://github.com/martin-rizzo/AmazingZImageWorkflow).
## Table of Contents
1. [Nodes](#nodes)
2. [Examples](#examples)
3. [Installation](#installation)
4. [Recommended Checkpoints](#recommended-checkpoints)
5. [❤️ Support my work](#%EF%B8%8F-support-my-work)
6. [License](#license)
## Nodes
### ⚡ ZSampler Turbo
* A specialized sampler designed to divide the denoising process into three stages: composition, details, and refinement. It maintains image stability between 4 and 9 steps and achieves sufficient quality and detail starting from step 7, eliminating the need for further refining or post-processing. \
**["ZSampler Turbo" node documentation](docs/zsampler_turbo.md)**.
### ⚡ Style & Prompt Encoder
* Applies a selected visual styles to the prompt and encodes them using a text-encoder model (clip). Enables generating images that follow the desired aesthetic while guiding the diffusion process. \
**["Style Prompt Encoder" node documentation](docs/style_prompt_encoder.md)**
### ⚡ 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. \
**["Style String Injector" node documentation](docs/style_string_injector.md)**
### ⚡ Save Image
* Saves generated images with the option to embed CivitAI-compatible metadata, making it easy to share generation parameters through that platform. \
**["Save Image" node documentation](docs/save_image.md)**.
### ⚡ Empty Z-Image Latent Image
* Creates an empty latent image of the appropriate size for Z-Image, selecting aspect ratio, scale, and orientation. \
**["Empty Z-Image Latent Image" node documentation](docs/empty_zimage_latent_image.md)**.
### 💀 ~~Photo-Style Prompt Encoder~~
* Deprecated, use "Style & Prompt Encoder" node.
### 💀 ~~Illustration-Style Prompt Encoder~~
* Deprecated, use "Style & Prompt Encoder" node.
## Examples
A few example workflows demonstrating basic usage of these nodes can be found in the **[/workflows](/workflows)** directory.
And hundreds of images generated with Z-Image model and the Power Nodes are available on the **[Z-Image Power Nodes page on CivitAI](https://civitai.com/models/2322533)**. The images posted by me include their prompts and complete generation workflows and you can use them freely as a basis for your own images. Additionally, there are also many users sharing their amazing creations there.
## Installation
_Ensure you have the latest version of [ComfyUi](https://github.com/comfyanonymous/ComfyUI)._
### Installation via ComfyUI Manager (Recommended)
The easiest way to install the nodes is through [ComfyUI-Manager](https://github.com/Comfy-Org/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:
```bash
cd
```
3. Move into the **custom_nodes** folder and clone the repository:
```bash
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.
3. Press **CTRL + SHIFT + RightClick** in an empty space and select "Open PowerShell window here".
4. 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
### 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](https://github.com/city96/ComfyUI-GGUF) nodes.
- __[z_image_turbo-Q5_K_S.gguf](https://huggingface.co/jayn7/Z-Image-Turbo-GGUF/blob/main/z_image_turbo-Q5_K_S.gguf)__ [5.19 GB]\
Local Directory: __`ComfyUI/models/diffusion_models/`__
- __[Qwen3-4B.i1-Q5_K_S.gguf](https://huggingface.co/mradermacher/Qwen3-4B-i1-GGUF/blob/main/Qwen3-4B.i1-Q5_K_S.gguf)__ [2.82 GB]\
Local Directory: __`ComfyUI/models/text_encoders/`__
- __[ae.safetensors](https://huggingface.co/Comfy-Org/z_image_turbo/blob/main/split_files/vae/ae.safetensors)__ [335 MB]\
Local Directory: __`ComfyUI/models/vae/`__
### 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.
- __[z_image_turbo_bf16.safetensors](https://huggingface.co/Comfy-Org/z_image_turbo/blob/main/split_files/diffusion_models/z_image_turbo_bf16.safetensors)__ (12.3 GB)\
Local Directory: __`ComfyUI/models/diffusion_models/`__
- __[qwen_3_4b.safetensors](https://huggingface.co/Comfy-Org/z_image_turbo/blob/main/split_files/text_encoders/qwen_3_4b.safetensors)__ (8.04 GB)\
Local Directory: __`ComfyUI/models/text_encoders/`__
- __[ae.safetensors](https://huggingface.co/Comfy-Org/z_image_turbo/blob/main/split_files/vae/ae.safetensors)__ (335 MB)\
Local Directory: __`ComfyUI/models/vae/`__
## ❤️ Support my work
If you find these nodes useful or it has helped you in your projects, please consider becoming a sponsor. Your support allows me to keep my tools free and accessible for everyone.
- **Ko-fi:** https://ko-fi.com/martinrizzo
*Every contribution, no matter how small, is greatly appreciated!*
## License
Copyright (c) 2026 Martin Rizzo
This project is licensed under the MIT license.
See the ["LICENSE"](LICENSE) file for details.