Release 0.23.1

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: lpalbou

CHANGELOG.md

@@ -5,6 +5,19 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.23.1] - 2026-07-18
+
+Documentation and verification patch; no behavior changes.
+
+### Changed
+
+- Wan2.2 A14B video-to-video: re-verified the documented proof command end to end on 0.23.0
+  (bit-identical output to the archived 0.18.24 clip across all 17 frames - the route is
+  seed-stable across releases). New proof card at
+  `docs/assets/examples/spaceship-v2v/README.md` with the cross-release verification record;
+  the Wan video page now cites the measured runtime (`298.7 s`, `13.8 GiB` peak RSS with
+  `--low-ram`) instead of a stale 90-second estimate.
+
 ## [0.23.0] - 2026-07-17
 
 Performance release: three fixes from a structured adversarial audit, each independently

docs/assets/examples/spaceship-v2v/README.md

@@ -0,0 +1,36 @@
+# Wan2.2 A14B Video-To-Video Proof Card
+
+Prompt-guided plain video-to-video on `AbstractFramework/wan2.2-t2v-a14b-diffusers-8bit`:
+one source clip plus one text prompt, run through unified `mlxgen generate`. The route,
+command, and behavior contract live in [Wan video](../../../wan-video.md#video-to-video);
+this card holds the reproducible proof artifacts.
+
+## Source
+
+17-frame lift-off clip from the spaceship-snow example set:
+[06_i2v_a14b_spaceship_takeoff_from_source.mp4](../spaceship-snow/06_i2v_a14b_spaceship_takeoff_from_source.mp4)
+
+![Source contact sheet](starship_v2v_source_contact_sheet.png)
+
+## Output
+
+Bounded diagnostic settings (`448x256`, `17` frames, `5` requested steps resolving to `3`
+effective steps at `--video-strength 0.7`, seed `4242`): the ship is rebuilt as a bulkier
+smuggler-style starship while the icy cliffs, snow haze, sunrise lighting, and camera motion
+carry over from the source.
+
+![Output contact sheet](starship_v2v_output_contact_sheet.png)
+
+- output video: [starship_v2v_a14b.mp4](starship_v2v_a14b.mp4)
+- run metadata: [starship_v2v_a14b.metadata.json](starship_v2v_a14b.metadata.json)
+- exact command: see [Wan video](../../../wan-video.md#video-to-video); replay it from the
+  metadata sidecar with `mlxgen generate -C starship_v2v_a14b.metadata.json`
+
+## Verification Record
+
+| Date | Version | Result |
+| --- | --- | --- |
+| 2026-07-18 | 0.23.0 | Re-ran the exact command: output bit-identical to the archived clip (0.00/255 mean abs diff on all 17 frames), `298.7 s` generation time, `13.8 GiB` peak RSS with `--low-ram` |
+| (archived) | 0.18.24 | Original proof run, `221.3 s` generation time |
+
+The route is seed-stable across releases: same command, same pixels.

docs/wan-video.md

@@ -527,7 +527,8 @@ mlxgen generate \
 Use A14B T2V for the current plain public video-to-video route. This is the exact command that
 produced the included proof artifacts. It uses bounded diagnostic settings (`448x256`, `17` frames,
 `5` requested steps, which resolve to `3` effective steps at `--video-strength 0.7`) so it runs in
-about 90 seconds; it is a route and behavior proof, not a quality setting:
+about 4-5 minutes end to end (measured `298.7 s` on 0.23.0, `13.8 GiB` peak RSS with `--low-ram`);
+it is a route and behavior proof, not a quality setting:
 
 ```sh
 mlxgen generate \
@@ -558,7 +559,9 @@ settings; see the timing profiles above.
 The proof used this source clip:
 [06_i2v_a14b_spaceship_takeoff_from_source.mp4](assets/examples/spaceship-snow/06_i2v_a14b_spaceship_takeoff_from_source.mp4)
 
-Included proof artifacts:
+Included proof artifacts (see the
+[proof card](assets/examples/spaceship-v2v/README.md) for the cross-release verification
+record — the 0.23.0 rerun reproduced the archived clip bit-identically):
 
 - output video: [starship_v2v_a14b.mp4](assets/examples/spaceship-v2v/starship_v2v_a14b.mp4)
 - run metadata: [starship_v2v_a14b.metadata.json](assets/examples/spaceship-v2v/starship_v2v_a14b.metadata.json)

pyproject.toml

@@ -14,7 +14,7 @@ source-exclude = [
 
 [project]
 name = "mlx-gen"
-version = "0.23.0"
+version = "0.23.1"
 description = "Generative image and video model runtimes for MLX."
 readme = "README.md"
 keywords = ["flux", "ai", "ml", "transformers", "mlx", "huggingface", "apple-silicon", "diffusers", "qwen", "qwen-image", "seedvr2", "z-image"]

src/mflux/utils/version_util.py

@@ -8,7 +8,7 @@
 
 
 class VersionUtil:
-    PACKAGED_RELEASE_DATE = "2026-07-17"
+    PACKAGED_RELEASE_DATE = "2026-07-18"
     _version: str | None = None
     _release_date: str | None = None