ideogram4-turbo-GGUF

Ideogram4 Turbo — GGUF build

Turbo-merged text-to-image with a FLUX.2 VAE and a Qwen3-VL-8B text encoder. 8 steps, CFG off.

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/ideogram4-turbo/resolve/main/samples/apple.png" width="380" alt="prompt: a red apple on a rustic wooden table beside a window, soft daylight, fine skin texture and wood grain, studio photograph, sharp focus — 1024×1024, 8 steps, guidance 1.0, seed 12345"></td><td><img src="https://huggingface.co/ChrisColeTech/ideogram4-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, 8 steps, guidance 1.0, seed 99"></td></tr> <tr><td>_{**prompt:** `a red apple on a rustic wooden table beside a window, soft daylight, fine skin texture and wood grain, studio photograph, sharp focus` — 1024×1024, 8 steps, guidance 1.0, seed 12345}</td><td>_{**prompt:** `portrait of an older fisherman with a weathered face, natural window light, shallow depth of field, photorealistic` — 1024×1024, 8 steps, guidance 1.0, seed 99}</td></tr> <tr><td><img src="https://huggingface.co/ChrisColeTech/ideogram4-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, 8 steps, guidance 1.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, 8 steps, guidance 1.0, seed 1234}</td><td></td></tr> </table>

---

img2img

Two sources: a photograph, and the tests/ideogram4/ fixture. Each source sits beside the results made from it.

<table> <tr><td><img src="https://huggingface.co/ChrisColeTech/ideogram4-turbo-GGUF/resolve/main/samples/img2img-source.png" width="230" alt="photographic source"></td><td><img src="https://huggingface.co/ChrisColeTech/ideogram4-turbo-GGUF/resolve/main/samples/img2img-result.png" width="230" alt="photographic source restyled"></td><td></td><td></td></tr> <tr><td>_{**source** — `a red apple on a rustic wooden table beside a window, soft daylight, visible wood grain, studio photograph, sharp focus`}</td><td>_{**img2img prompt:** structured JSON (below) — 1024×1024, **16 steps**, **guidance 1.0**, **strength 0.97**, seed 999}</td><td></td><td></td></tr> <tr><td><img src="https://huggingface.co/ChrisColeTech/ideogram4-turbo-GGUF/resolve/main/samples/fixture-source.png" width="230" alt="fixture source, one image used by all three"></td><td><img src="https://huggingface.co/ChrisColeTech/ideogram4-turbo-GGUF/resolve/main/samples/fixture-oil.png" width="230" alt="oil render"></td><td><img src="https://huggingface.co/ChrisColeTech/ideogram4-turbo-GGUF/resolve/main/samples/fixture-watercolor.png" width="230" alt="watercolor render"></td><td><img src="https://huggingface.co/ChrisColeTech/ideogram4-turbo-GGUF/resolve/main/samples/fixture-sketch.png" width="230" alt="sketch render"></td></tr> <tr><td>_{**source** — one `tests/ideogram4/` image, used for all three}</td><td>_{**img2img prompt:** `An oil painting of an abstract composition with a large glowing golden circle at the center over a flowing rainbow gradient, thick visible brushstrokes and canvas texture.` — 1024×1024, **16 steps**, **guidance 1.0**, **strength 0.98**, seed 42}</td><td>_{**img2img prompt:** `A watercolor painting of an abstract composition with a soft golden circle over a rainbow wash, bleeding edges and transparent layers on rough paper.` — 1024×1024, **16 steps**, **guidance 1.0**, **strength 0.97**, seed 999}</td><td>_{**img2img prompt:** `An impressionist oil painting of an abstract composition with a golden circle at the center over a vivid rainbow gradient, lively broken brushwork in the same bright colors.` — 1024×1024, **16 steps**, **guidance 1.0**, **strength 0.97**, seed 456}</td></tr> </table>

⚠ Always set guidance: 1.0

This is a turbo merge, and guidance: 1.0 means CFG off — not weak CFG. The sampler blends v = g·cond + (1−g)·uncond, so at 1.0 the output is the pure conditional branch.

Leave it unset and the pipeline falls back to the full model's per-step schedule (7.0 main, 3.0 for the last three), which this merge was never trained for, giving a compounding loss of brightness. Same source, prompt, strength and seed, at 8 steps:

Because the error applies per step, more steps make it worse. Across the three fixtures, correct guidance gives luminance 87 / 113 / 99 against 47 / 90 / 55 with it omitted.

Steps: 16 for restyling, 8 for general use

A turbo model needs far fewer steps than the 48 quoted for full ideogram4. At correct guidance, 4 steps barely transforms, 8 gives visible paint texture, 16 is where the brushwork lands. By 24 this typography-focused model begins hallucinating lettering.

strength must be high — 0.97

The model anchors hard to source content; the usable restyle band starts around 0.93. Below it the model reconstructs the source and largely ignores the prompt. At a fixed step count the exact value matters little — 0.95/0.97/0.99 are near-indistinguishable — so set 0.97 and tune steps.

The prompts are structured JSON

Captions show each prompt's high_level_description. In full:

<details> <summary><b>oil</b> — full structured prompt</summary>

{
  "high_level_description": "An oil painting of an abstract composition with a large glowing golden circle at the center over a flowing rainbow gradient, thick visible brushstrokes and canvas texture.",
  "compositional_deconstruction": {
    "background": "A flowing rainbow gradient painted in thick impasto oil strokes, red tones sweeping from the left into greens and violets toward the lower right, visible canvas weave beneath the paint.",
    "elements": [
      {
        "type": "obj",
        "desc": "A large luminous golden circle at the center of the canvas, built from swirling concentric brushstrokes of cadmium yellow and amber with raised paint ridges catching the light."
      }
    ]
  }
}

</details> <details> <summary><b>watercolor</b> — full structured prompt</summary>

{
  "high_level_description": "A watercolor painting of an abstract composition with a soft golden circle over a rainbow wash, bleeding edges and transparent layers on rough paper.",
  "compositional_deconstruction": {
    "background": "Transparent watercolor washes blending red through green to violet across rough cold-press paper, soft bleeding edges where the pigments meet, granulation visible in the wet areas.",
    "elements": [
      {
        "type": "obj",
        "desc": "A soft-edged golden yellow circle at the center, painted wet-into-wet so its rim feathers into the surrounding washes, a lighter halo where the paper shows through."
      }
    ]
  }
}

</details> <details> <summary><b>sketch</b> — full structured prompt</summary>

{
  "high_level_description": "An impressionist oil painting of an abstract composition with a golden circle at the center over a vivid rainbow gradient, lively broken brushwork in the same bright colors.",
  "compositional_deconstruction": {
    "background": "A vivid rainbow gradient built from short broken impressionist brushstrokes, reds and magentas on the right flowing through greens and blues to violet on the left, dabs of pure color set side by side.",
    "elements": [
      {
        "type": "obj",
        "desc": "A large golden yellow circle at the center painted in swirling dabs of cadmium yellow and warm orange, its edge broken into short strokes that mingle with the surrounding colors."
      }
    ]
  }
}

</details>

Note on test_03: the fixture is named sketch, but its prompt asks for "An impressionist oil painting … lively broken brushwork" — no pencil, no graphite. The output matches the prompt, not the filename.

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: 1.0 is CFG-off here. The sampler blends v = g·cond + (1−g)·uncond, so at 1.0 the output is purely conditional.
• Never leave guidance unset. Omitting it falls back to a 7.0/3.0 CFG schedule that the turbo merge was not trained for.
• The 8B text encoder plus two transformers is a large working set, so offloading the text encoder to CPU after each prompt encoding is recommended.
• An unconditional transformer ships alongside the main one for the CFG path; the turbo profile does not use it.

---

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: not publicly published
• 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.