Update TI2V-5B memory and validation card

README.md

@@ -8,6 +8,7 @@ tags:
 - mlx-gen
 - mflux
 - apple-silicon
+- bf16
 - wan
 - wan2.2
 - video-generation
@@ -16,31 +17,54 @@ tags:
 ---
 # wan2.2-ti2v-5b-diffusers-bf16
 
-This repository contains MLX-Gen saved weights for `Wan-AI/Wan2.2-TI2V-5B-Diffusers`. The checkpoint is designed for local Apple Silicon inference with [`mlx-gen`](https://github.com/lpalbou/mlx-gen).
+This repository contains BF16 MLX-Gen saved weights for
+[`Wan-AI/Wan2.2-TI2V-5B-Diffusers`](https://huggingface.co/Wan-AI/Wan2.2-TI2V-5B-Diffusers).
+It is designed for local Apple Silicon inference with
+[`mlx-gen`](https://github.com/lpalbou/mlx-gen).
 
-It uses the mflux/MLX saved-weight layout. It is not a Diffusers or Transformers `from_pretrained()` checkpoint.
+It uses the mflux/MLX saved-weight layout. It is not a Diffusers or Transformers
+`from_pretrained()` checkpoint.
 
 ## Source Model
 
 Original model: [`Wan-AI/Wan2.2-TI2V-5B-Diffusers`](https://huggingface.co/Wan-AI/Wan2.2-TI2V-5B-Diffusers).
 
-## License and Access
-
 This prepared derivative follows the Apache 2.0 license of the source model.
 
-## Quantization
+## Precision
+
+The upstream TI2V-5B source snapshot is not uniformly 16-bit on disk: the transformer and VAE
+safetensors are FP32, while the UMT5 text encoder is BF16. MLX-Gen loads Wan transformer/VAE
+weights at BF16 runtime precision, so this prepared BF16 package reduces storage and download size
+but is not a runtime-memory optimization versus source generation.
+
+Use this package when you want a smaller reusable MLX-Gen folder that preserves source behavior.
+Use the mixed q8/BF16 package when you want a smaller model footprint.
 
-This checkpoint stores MLX-Gen Wan2.2 TI2V-5B weights without an explicit quantization level.
+## Measurements
 
-For Wan checkpoints, MLX-Gen loads transformer and VAE weights at BF16 runtime precision. The UMT5 text encoder is preserved from the source model. Wan supports text-to-video and selected image-to-video routes depending on the source model.
+Measured on 2026-06-04 with `mlx-gen 0.18.10` on an Apple M5 Max with 128 GiB unified memory.
 
-## Compatibility
+Validation profile: `1280x704`, 17 frames, 20 denoising steps, guidance `5`, 24 fps, seed `321`,
+explicit empty negative prompt.
 
-Requires `mlx-gen >= 0.18.10`.
+| Layout | Storage | Logical Model | Full-Process Physical Peak | Max RSS | MLX Peak | Total Time | Output |
+| --- | ---: | ---: | ---: | ---: | ---: | ---: | --- |
+| Upstream source snapshot | 31.9 GiB | 10.6 GiB | 102.7 GiB | 13.7 GiB | 58.5 GiB | 216.2 s | [base-source.mp4](validation/ti2v5b-clean/base-source.mp4) |
+| This BF16 package | 21.2 GiB | 10.6 GiB | 102.6 GiB | 14.5 GiB | 58.5 GiB | 261.6 s | [prepared-bf16.mp4](validation/ti2v5b-clean/prepared-bf16.mp4) |
+| Mixed q8/BF16 package | 16.9 GiB | 6.3 GiB | 103.7 GiB | 13.8 GiB | 54.2 GiB | 243.4 s | [mixed-q8-bf16.mp4](validation/ti2v5b-clean/mixed-q8-bf16.mp4) |
 
-Generated with `mlx-gen 0.18.10`.
+The source and this BF16 package produced byte-identical decoded MP4 frames. The mixed q8/BF16
+package stayed visually in the same family with mean frame MAE `1.66` versus source/BF16.
 
-Use the `mlxgen` command and Python import path for new MLX-Gen projects.
+`Storage` is the Hugging Face repository total. `Logical Model` is the loaded Wan transformer plus
+VAE tensor footprint measured from MLX arrays. `Full-Process Physical Peak` is Darwin
+`phys_footprint` sampled from model initialization through MP4 save and health validation.
+
+Validation assets:
+
+- [contact-sheet.png](validation/ti2v5b-clean/contact-sheet.png)
+- [metrics.json](validation/ti2v5b-clean/metrics.json)
 
 ## Usage
 
@@ -51,19 +75,23 @@ mlxgen download --model AbstractFramework/wan2.2-ti2v-5b-diffusers-bf16
 
 mlxgen generate \
   --model AbstractFramework/wan2.2-ti2v-5b-diffusers-bf16 \
-  --prompt "Your video prompt here" \
+  --prompt "A short cinematic video of a glowing orange glass sphere floating above calm teal water, soft reflections, gentle camera movement" \
+  --negative-prompt "" \
   --width 1280 \
   --height 704 \
-  --frames 121 \
-  --steps 50 \
+  --frames 17 \
+  --steps 20 \
   --guidance 5 \
   --fps 24 \
-  --seed 42 \
+  --seed 321 \
   --output video.mp4
 ```
 
+TI2V-5B also supports first-frame image-to-video in MLX-Gen when one input image is supplied.
+
 ## Attribution
 
-MLX-Gen is based on [mflux](https://github.com/filipstrand/mflux) by Filip Strand and the original mflux contributors. This model card is generated by MLX-Gen so derived checkpoints keep that attribution visible.
+MLX-Gen is based on [mflux](https://github.com/filipstrand/mflux) by Filip Strand and the original
+mflux contributors.
 
 Prepared and contributed by [@lpalbou](https://huggingface.co/lpalbou).