mflux-community/z-image-base-mflux-q3

Z-Image Base · MFlux Q3

This is a Q3 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.

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

QUANT	GB	Repo
BF16	20.5	mflux-community/z-image-base-mflux-bf16
Q8	11.0	mflux-community/z-image-base-mflux-q8
Q6	8.4	mflux-community/z-image-base-mflux-q6
Q5	7.2	mflux-community/z-image-base-mflux-q5
Q4	5.9	mflux-community/z-image-base-mflux-q4
Q3	4.6	this repo

Converted on 2026-08-20.

Standard MFlux quantization uses MLX affine quantization (3-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 Q3:

mflux-generate-z-image \
  --model mflux-community/z-image-base-mflux-q3 \
  --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-q3 --local-dir ./z-image-base-mflux-q3

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

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