z-image-base-mflux-q4

Z-Image Base · MFlux Q4

This is a Q4 MFlux version of Z-Image.

MFlux runs the latest state-of-the-art generative image models locally on your Mac in native MLX. MFlux is open source and free.

[!NOTE] Community conversion by MFlux-Community -- not an official release from the original model's authors. The original model's license applies unchanged, see License.

MFlux versions of Z-Image

Converted on 2026-08-20.

Standard MFlux quantization uses MLX affine quantization (4-bit) across the text encoder, transformer and VAE. The quantization level is stored in the weights, so no --quantize flag is needed.

Usage

Install MFlux

uv tool install --upgrade mflux

Generate an image using Z-Image Q4:

mflux-generate-z-image \
  --model mflux-community/z-image-base-mflux-q4 \
  --base-model z-image \
  --prompt "A puffin standing on a cliff" \
  --width 1024 \
  --height 1024 \
  --seed 42 \
  --output image.png

The weights are downloaded from this repo on first use. To keep a local copy instead:

hf download mflux-community/z-image-base-mflux-q4 --local-dir ./z-image-base-mflux-q4

then pass --model ./z-image-base-mflux-q4.

License

This repo inherits the license of the original model: apache-2.0. See the original model card for the full terms and any usage restrictions. The weights here were modified from the original release only by conversion to MLX and quantization.

Credits

• Original model: Tongyi-MAI/Z-Image
• MLX implementation: MFlux by Filip Strand and contributors
• Conversion: MFlux-Community