feat(image): flux.2 klein 4b, 9b and 9b kv, with edits from up to 10 reference images

CHANGELOG.md

@@ -10,10 +10,19 @@ adhere to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 - `gmlx pull`, `image generate`, `serve` and the ComfyUI pack run FLUX.3 klein
   and FLUX.3 klein Base GGUFs, with edits from up to 10 reference images.
+- `gmlx pull`, `image generate`, `serve` and the ComfyUI pack run FLUX.2 klein
+  4B and FLUX.2 klein Base 4B GGUFs, with edits from up to 10 reference images.
+- `gmlx pull`, `image generate`, `serve` and the ComfyUI pack run FLUX.2 klein
+  9B and FLUX.2 klein Base 9B GGUFs, licensed for non-commercial use only.
+- `gmlx pull`, `image generate`, `serve` and the ComfyUI pack run FLUX.2 klein
+  9B KV GGUFs, which edit from two 1024x1024 references in about half the
+  9B's time.
 - `context_copy: true` or `GMLX_CONTEXT_COPY=1` drafts from the prompt when the
   output repeats it, which speeds up edits and quotes.
 - Muse Spark (GGUF arch `muse-spark`), with reasoning effort intents, tool calls
   and image and audio input through its `--mmproj` companion.
+- An image LoRA whose PEFT header sets `use_rslora` loads, scaled as PEFT
+  scales it, where it was refused.
 
 ### Changed
 
@@ -25,9 +34,15 @@ adhere to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
   runs faster on NAX GPUs (M5).
 - With `--stream-experts`, a prompt that uses most of a layer's experts
   prefills faster. `GMLX_ARENA_SPLIT_MAX_SHARE` tunes the choice.
+- `gmlx pull` of an image model reuses a VAE GGUF on disk packed for its
+  family from another source, and names it, where it downloaded the VAE again.
 
 ### Fixed
 
+- A streamed image request refused while it ran, such as one too large for
+  memory, got a server error frame where the same request unstreamed got a 400.
+- The `gmlx pull` plan of an image model could say its parts fit in stages
+  when `image generate` then refused the image, as it counted file bytes alone.
 - A DFlash drafter that took speculation back up after a batch shrank within
   the width cap drafted from stale context, so almost no draft was accepted.
 - A sampled request whose structured output allowed fewer tokens than its
@@ -52,6 +67,10 @@ adhere to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
   `serve`, and `response_format` constrains only the final answer.
 - `gmlx launch` could miss a SIGTERM or SIGHUP on a busy Mac, so a stop or a
   closed terminal did not end the session until the client exited.
+- `gmlx Sigmas` in ComfyUI gave Qwen-Image 2.1 ComfyUI's simple schedule. It
+  takes the image's width and height and gives the schedule of that size.
+- An image request that failed on an internal error got a 400 and left no
+  trace in the log. It gets a 500, and the server logs its trace.
 
 ## [0.5.0] - 2026-10-12
 

README.md

@@ -98,9 +98,9 @@ The recording runs at true speed, with a 27B model in a local server.
 - Embeddings, rerank, speech-to-text and text-to-speech on the same server,
   for a local RAG and voice stack. See
   [Speech, embeddings and rerank](https://asher.github.io/gmlx/services.html).
-- Image generation from Z-Image, Qwen-Image 2.1, Krea 2 Turbo and FLUX.3
-  klein GGUFs, on the command line, on the OpenAI image routes and in
-  ComfyUI. It needs an M3 chip or newer. See
+- Image generation from Z-Image, Qwen-Image 2.1, Krea 2 Turbo, FLUX.2 klein
+  and FLUX.3 klein GGUFs, on the command line, on the OpenAI image routes
+  and in ComfyUI. It needs an M3 chip or newer. See
   [Image generation](https://asher.github.io/gmlx/images.html).
 - A decision API at `/v1/systemone` that returns a probability for each
   answer to yes-or-no, choice and score questions about a text. See

THIRD_PARTY_NOTICES.md

@@ -22,6 +22,7 @@ in [`licenses/`](licenses/).
 | [mflux](https://github.com/filipstrand/mflux) | MIT | The Z-Image transformer at commit `e066d98`, ported to `gmlx/image/families/z_image/model.py` with the fused qkv kept and modules named after the GGUF tensors, and its attention, timestep and RoPE helpers in `gmlx/image/ops/attention.py` and `gmlx/image/ops/embeds.py`. |
 | [diffusers](https://github.com/huggingface/diffusers) | Apache-2.0 | Code at commit `e0abab8`, ported to MLX and modified for gmlx: the Z-Image forward of `transformer_z_image.py` in `gmlx/image/families/z_image/model.py`, its timestep embedding, RoPE tables and rotary product in `gmlx/image/ops/embeds.py` and `gmlx/image/ops/attention.py`, the RMSNorm rounding of `normalization.py` in `gmlx/image/ops/norms.py`, and the FLUX.1 autoencoder of `autoencoders/vae.py`, `resnet.py`, `unet_2d_blocks.py`, `downsampling.py`, `upsampling.py` and `attention_processor.py` in `gmlx/image/vae/flux1_ae.py`, the quant convs and BatchNorm statistics of `autoencoders/autoencoder_kl_flux2.py` in `gmlx/image/vae/flux2_ae.py`, the Qwen-Image 2.1 autoencoder of `autoencoders/autoencoder_kl_qwenimage21.py`, for one frame, in `gmlx/image/vae/qwen_image21_vae.py`, and the UniPC bh2 sampler of `schedulers/scheduling_unipc_multistep.py` in `gmlx/image/unipc.py`. Also the Qwen-Image 2.1 forward, token layout and RoPE of `transformer_qwenimage21.py` in `gmlx/image/families/qwen_image21/model.py` and `layout.py`, and the dynamic shift of `pipelines/qwenimage21/pipeline_qwenimage21.py` and `schedulers/scheduling_flow_match_euler_discrete.py` in `gmlx/image/schedule.py`, and the reference image sizes, the prompt template with image slots and the image branch of the encoder tap of that pipeline in `gmlx/image/families/qwen_image21/edit.py`. For Krea 2, at the same commit: the forward of `transformer_krea2.py` in `gmlx/image/families/krea2/model.py`, the Qwen-Image autoencoder of `autoencoders/autoencoder_kl_qwenimage.py`, for one frame, in `gmlx/image/vae/qwen_image_vae.py`, the prompt template, encoder layers and constants of `pipelines/krea2/pipeline_krea2.py` and `modular_pipelines/krea2/` in `gmlx/image/families/krea2/family.py`, and the schedule of that pipeline in `krea2_sigmas` of `gmlx/image/schedule.py`. |
 | [flux-3-image-klein](https://github.com/black-forest-labs/flux-3-image-klein) | Apache-2.0 | BFL's FLUX.3 klein reference at commit `45e57c9`, ported to MLX and modified for gmlx: the DiT constants and tensor layout of `src/flux3/dit.py`, the image RoPE scale and schedule alpha of `src/flux3/pipeline.py` and the encoder layers, pad multiple, length, pad token and position and chat template of `src/flux3/text_encoder.py` in `gmlx/image/families/flux3_klein/family.py`, the DiT forward of `src/flux3/dit.py` with the position ids of `pipeline.py`, `autoencoder.py` and `text_encoder.py` in `gmlx/image/families/flux3_klein/model.py`, the schedule of `src/flux3/sampling.py` in `flux3_sigmas` of `gmlx/image/schedule.py`, the latent patchify and BatchNorm of `src/flux3/autoencoder.py` in `gmlx/image/vae/flux2_ae.py`, and the reference canvas, reference preparation and default size of `src/flux3/pipeline.py` with the reference choice and output crop of `src/flux3/generate.py` in `gmlx/image/families/flux3_klein/edit.py`. |
+| [flux2](https://github.com/black-forest-labs/flux2) | Apache-2.0 | BFL's FLUX.2 reference at commit `50fe516`, ported to MLX and modified for gmlx: the DiT constants of `Klein4BParams`, `Klein9BParams` and `Flux2Params` and the tensor names and shapes of `Flux2` in `src/flux2/model.py`, the sampling defaults of `FLUX2_MODEL_INFO` in `src/flux2/util.py`, the prompt rules of `Qwen3Embedder` in `src/flux2/text_encoder.py`, the rounding of `denoise` and `denoise_cfg` and the reference image rules of `encode_image_refs` in `src/flux2/sampling.py` in `gmlx/image/families/flux2_klein/family.py`, the constants of `Klein9BParams`, the 9B rows of `FLUX2_MODEL_INFO` and the Qwen3-8B encoder of `load_qwen3_embedder` in `src/flux2/text_encoder.py` in `gmlx/image/families/flux2_klein_9b/family.py`, the `flux.2-klein-9b-kv` row of `FLUX2_MODEL_INFO` in `gmlx/image/families/flux2_klein_9b_kv/family.py` and the step of `denoise_cached` in `src/flux2/sampling.py` in `gmlx/image/families/flux2_klein_9b_kv/step.py`, the DiT forward of `src/flux2/model.py`, with `forward_kv_extract`, `forward_kv_cached` and `causal_attn_fn`, and the token ids of `prc_img`, `prc_txt` and `encode_image_refs` in `src/flux2/sampling.py` in `gmlx/image/families/flux2_klein/model.py`, and the schedule of `compute_empirical_mu` and `get_schedule` in `src/flux2/sampling.py` in `flux2_mu` and `flux2_sigmas` of `gmlx/image/schedule.py`, and the reference image preparation of `encode_image_refs` and `default_prep` in `src/flux2/sampling.py` in `gmlx/image/families/flux2_klein/edit.py`. |
 | [ComfyUI-GGUF](https://github.com/city96/ComfyUI-GGUF) | Apache-2.0 | The model detection keys of `convert.py` at commit `6ea2651`, which `gmlx/image/fingerprint.py` uses to refuse other diffusion model layouts by name. |
 | [misaki](https://github.com/hexgrad/misaki) | Apache-2.0 | Whole package vendored at `gmlx/_vendor/misaki` (commit `fba1236`): Kokoro's grapheme-to-phoneme front-end, used by the TTS service until upstream's next PyPI release. |
 | [musl](https://musl.libc.org) | MIT | Statically linked into the guest entry binary `gmlx/container/guest/gmlx-entry` as its C library ([`licenses/musl-COPYRIGHT`](licenses/musl-COPYRIGHT)). |