z-image-turbo-GGUF

Z-Image Turbo — GGUF build

6B text-to-image, distilled for a 9-step CFG-free profile. Repacked as a split GGUF layout.

What this repo is: a requantized, split-layout build of the upstream model — weights only, not a retrain. The recommended settings below are the values these weights are actually run with day to day, not copied from the upstream card.

---

Samples

<table> <tr><td><img src="https://huggingface.co/ChrisColeTech/z-image-turbo/resolve/main/samples/apple.png" width="380" alt="prompt: a red apple on a rustic wooden table beside a window, soft daylight, visible wood grain, studio photograph, sharp focus — 1024×1024, 9 steps, guidance 0.0, seed 7"></td><td><img src="https://huggingface.co/ChrisColeTech/z-image-turbo/resolve/main/samples/portrait.png" width="380" alt="prompt: portrait of an older fisherman with a weathered face, natural window light, shallow depth of field, photorealistic — 1024×1024, 9 steps, guidance 0.0, seed 99"></td></tr> <tr><td>_{**prompt:** `a red apple on a rustic wooden table beside a window, soft daylight, visible wood grain, studio photograph, sharp focus` — 1024×1024, 9 steps, guidance 0.0, seed 7}</td><td>_{**prompt:** `portrait of an older fisherman with a weathered face, natural window light, shallow depth of field, photorealistic` — 1024×1024, 9 steps, guidance 0.0, seed 99}</td></tr> <tr><td><img src="https://huggingface.co/ChrisColeTech/z-image-turbo/resolve/main/samples/street.png" width="380" alt="prompt: a rain-slicked Tokyo street at night, neon signs reflecting in puddles, cinematic, 35mm photograph — 1024×1024, 9 steps, guidance 0.0, seed 1234"></td><td></td></tr> <tr><td>_{**prompt:** `a rain-slicked Tokyo street at night, neon signs reflecting in puddles, cinematic, 35mm photograph` — 1024×1024, 9 steps, guidance 0.0, seed 1234}</td><td></td></tr> </table>

---

img2img

This model does img2img as well as txt2img. The left image is the input; the right is what this model made of it.

<table> <tr><td><img src="https://huggingface.co/ChrisColeTech/z-image-turbo-GGUf/resolve/main/samples/img2img-source.png" width="380" alt="source prompt: a red apple on a rustic wooden table beside a window, soft daylight, visible wood grain, studio photograph, sharp focus — 1024×1024, seed 7 — generated separately as the img2img input"></td><td><img src="https://huggingface.co/ChrisColeTech/z-image-turbo-GGUf/resolve/main/samples/img2img-result.png" width="380" alt="img2img prompt: the same scene rendered as a vivid oil painting, thick visible brushstrokes, rich saturated colour, painterly texture — 1024×1024, 9 steps, strength 0.9, seed 7 — about 6 s on an A100 80GB"></td></tr> <tr><td>_{**source prompt:** `a red apple on a rustic wooden table beside a window, soft daylight, visible wood grain, studio photograph, sharp focus` — 1024×1024, seed 7 — generated separately as the img2img input}</td><td>_{**img2img prompt:** `the same scene rendered as a vivid oil painting, thick visible brushstrokes, rich saturated colour, painterly texture` — 1024×1024, **9 steps**, **strength 0.9**, seed 7 — about 6 s on an A100 80GB}</td></tr> </table>

strength has a hard threshold on this model. A sweep at 0.3 / 0.5 / 0.7 / 0.9 — same source, prompt and seed — produced no meaningful restyle below 0.9; those values add gloss and surface detail and leave the photograph a photograph. The painterly transform appears only at 0.9. Treat it as near-binary rather than a dial: 0.9 to restyle, low values only for a light finishing pass.

Recommended settings

Values this build is run with in practice. They are read out of a live config when this card is generated, so they cannot drift from what is actually used.

Supported modes: txt2img, img2img

Notes and gotchas

• Guidance is 0.0, not 1.0. Z-Image Turbo is a guidance-distilled turbo model; this build expects guidance=0.0 and any positive CFG fights the distillation.
• Text encoder is Qwen3-VL-4B, not the encoder in the original upstream layout. The transformer file also carries a -fresh suffix; both are reflected in the paths below.
• 9 steps at 1024² is the verified profile for this build.

---

Layout

Components ship as separate files rather than one bundle: the transformer, the text encoder(s) and the VAE each load independently, with configs and tokenizers under config/. Any loader that accepts explicit per-component paths can consume this directly — point it at the files listed below.

A generic diffusers snippet is deliberately omitted. This is a repacked split layout with substituted encoders, so an upstream example will not load it unmodified, and an untested snippet would be worse than none.

---

Files

---

Provenance

• Upstream base model: Tongyi-MAI/Z-Image-Turbo (upstream license: apache-2.0)
• This build: requantized and relaid out into a split component layout. Weights are not retrained; only the format and directory layout differ.
• License: left as unknown in this repo's metadata. Refer to the upstream model's license for redistribution and commercial-use terms — several of these bases are non-commercial.