PromptZone - AI Prompts, Guides and Tools for Builders

Cover image for FLUX.1 GGUF in ComfyUI: Quantization and Loader Setup Guide
Wayan Bui
Wayan Bui

Posted on Edited on

FLUX.1 GGUF in ComfyUI: Quantization and Loader Setup Guide

To use FLUX.1 GGUF in ComfyUI, install city96's ComfyUI-GGUF nodes, load a converted checkpoint with Unet Loader (GGUF), and supply the FLUX workflow's encoders and VAE. Black Forest Labs develops the base image model, while city96 publishes the cited conversion and loader. Conversion, Loader, Workflow

This guide follows FLUX.1-dev in ComfyUI. The central question is whether a particular quantized checkpoint helps your workflow fit available resources while preserving the image details you need.

What are the key facts about FLUX.1 GGUF?

Field Verified detail
Developer Base model: Black Forest Labs; cited GGUF conversion and custom nodes: city96. BFL, Conversion, Nodes
Released FLUX.1 base family: August 1, 2024; conversion release date not published in the cited card. Launch, Card
Type Quantized text-to-image transformer checkpoint, loaded through custom ComfyUI nodes. Card, README
Size or parameters 12 billion parameters for the converted FLUX.1-dev model. Conversion repository
License and access Downloadable conversion retains the FLUX.1-dev Non-Commercial License. Conversion card
Where it runs A local ComfyUI installation with ComfyUI-GGUF and matching supporting components. Nodes, Workflow

How does GGUF change a FLUX.1 workflow?

ComfyUI-GGUF adds loaders for quantized diffusion transformers and supports quantized T5 encoders. Its maintainer describes reduced bits per weight as a way to make supported image models more accessible on constrained GPUs. Node README

The conversion remains FLUX.1-dev. City96 identifies it as a direct format conversion rather than a fine-tune, which makes the original model a useful reference when evaluating a quantized copy. Conversion card

That distinction gives you a practical experiment: keep the requested scene and workflow stable while evaluating alternative representations of the same base model. Judge whether the resulting images remain useful for your deliverable.

The repository lists quantizations including Q4_0 and Q8_0. Record those labels with your checkpoint; they are not image-quality ratings or complete hardware requirements. Conversion repository

What are the limits of FLUX.1 GGUF quantization?

A GGUF diffusion-model file does not replace every component of a FLUX workflow. ComfyUI's official examples also load text encoders and a VAE, so budget for the complete graph rather than a single download. ComfyUI tutorial

ComfyUI-GGUF describes its LoRA support as experimental. Establish generation without an adapter before adding one, and test the exact adapter with the selected loader. Node README

Lower storage precision does not establish a universal speed advantage. Forge's maintainer discusses decompression overhead and competing memory-transfer costs in its GGUF explanation; evaluate the actual runtime you use. Forge explanation

The conversion card supplies no quality-retention percentage or universal GPU-memory minimum. Use a personal comparison set to decide which tradeoff is acceptable. Conversion card

How do you load FLUX.1 GGUF in ComfyUI?

Install the matching loader

Start with a working, sufficiently recent ComfyUI installation. The custom-node README requires support for custom operations when loading a diffusion model separately. Installation requirements

For a standard source installation, run the following from the ComfyUI directory with its Python environment active. This follows the repository's clone-and-dependency installation route. Node installation

git clone https://github.com/city96/ComfyUI-GGUF custom_nodes/ComfyUI-GGUF
python -m pip install --upgrade gguf
Enter fullscreen mode Exit fullscreen mode

Restart ComfyUI after installation. Windows portable users should use the README's embedded-Python commands to install dependencies into the application's own environment. Portable instructions

Select one checkpoint

Choose a file from city96's FLUX.1-dev GGUF repository and record its complete filename. Put it under ComfyUI/models/unet, the directory specified by both the conversion card and the node README. Model location

Begin with one quantization choice. Downloading every available file before establishing a working loader adds uncertainty about which checkpoint produced a result and makes it harder to maintain a clear comparison.

Load an official FLUX.1-dev workflow and supply its encoders and VAE. Follow the tutorial's standalone-component arrangement when substituting the GGUF loader. Workflow, Loader

Replace the diffusion-model loader

Replace the ordinary diffusion-model loader with Unet Loader (GGUF) and select your file. Keep the remaining graph connections consistent with the original FLUX workflow. Usage instructions

Run a simple prompt before changing other parts of the graph. For example, request a folded yellow raincoat on a dark chair beside a window, with the chair fully visible. This is an original test scene, not a benchmark prompt.

Inspect whether the fabric, color, chair, and framing match the request. Record the result together with the model filename, encoder choices, VAE, dimensions, sampler settings, and application version.

If you later quantize T5, use the corresponding GGUF-capable CLIP loader described in the node README. Leave the existing CLIP model choice in place as instructed there. Text-encoder loading

Compare useful outputs

Create a small group of prompts from your real work: a close-up object, a portrait, and a composition containing lettering are useful candidates. Include the details that would cause you to reject a finished image.

For each configuration, log whether loading succeeded and how long generation took after assets were available. Keep a separate note for downloads or initial setup so they do not distort the comparison.

Review the same subjects at the same display size. Look for missing letters, altered materials, or misplaced objects. Choose acceptance criteria before deciding which image is more pleasing overall.

Avoid presenting a seed as a guarantee of identical pixels across runtimes. Use it as one recorded input while comparing observable outcomes, and document any additional workflow changes made between trials.

If a smaller file fits but produces too many rejected images, it may not be the best choice for that job. If it meets your checks, keep the working graph and outputs as a reference for future updates.

How does FLUX.1 GGUF compare with NF4 and original weights?

Option What to compare
FLUX.1-dev GGUF Conversion plus a loader that understands the selected file. Card, Nodes
FLUX.1-dev NF4 in Forge A different packaged quantization and runtime route. Publisher
Original FLUX.1-dev Publisher weights as a baseline for evaluating the same model family. Model card

The ComfyUI pillar explains graph construction. For the alternative package, see the sibling FLUX NF4 guide.

What should you know before choosing FLUX.1 GGUF?

What does FLUX.1 GGUF generate?

City96's FLUX.1-dev GGUF files generate images from text descriptions through a compatible workflow. They are quantized conversions of Black Forest Labs' FLUX.1-dev model. Conversion card

Does FLUX.1 GGUF quantization reduce the parameter count?

City96's FLUX.1-dev GGUF conversion is still listed as 12B parameters. The conversion changes weight representation while retaining the base model's identity. Conversion repository

Which files do I need besides a FLUX.1 GGUF checkpoint?

A ComfyUI FLUX.1 GGUF workflow needs a GGUF-capable model loader plus the text encoders and VAE required by the FLUX graph. Use the custom-node README together with ComfyUI's official component workflow. Loader, Workflow

Which license applies to FLUX.1-dev GGUF?

City96's FLUX.1-dev GGUF conversion retains the original FLUX.1-dev Non-Commercial License and restrictions. Review the conversion's linked license before using the weights in a project. Conversion card

Sources

Top comments (0)