Add model card, workflows, and verified release evidence

.gitattributes

@@ -1,35 +1,2 @@
-*.7z filter=lfs diff=lfs merge=lfs -text
-*.arrow filter=lfs diff=lfs merge=lfs -text
-*.bin filter=lfs diff=lfs merge=lfs -text
-*.bz2 filter=lfs diff=lfs merge=lfs -text
-*.ckpt filter=lfs diff=lfs merge=lfs -text
-*.ftz filter=lfs diff=lfs merge=lfs -text
-*.gz filter=lfs diff=lfs merge=lfs -text
-*.h5 filter=lfs diff=lfs merge=lfs -text
-*.joblib filter=lfs diff=lfs merge=lfs -text
-*.lfs.* filter=lfs diff=lfs merge=lfs -text
-*.mlmodel filter=lfs diff=lfs merge=lfs -text
-*.model filter=lfs diff=lfs merge=lfs -text
-*.msgpack filter=lfs diff=lfs merge=lfs -text
-*.npy filter=lfs diff=lfs merge=lfs -text
-*.npz filter=lfs diff=lfs merge=lfs -text
-*.onnx filter=lfs diff=lfs merge=lfs -text
-*.ot filter=lfs diff=lfs merge=lfs -text
-*.parquet filter=lfs diff=lfs merge=lfs -text
-*.pb filter=lfs diff=lfs merge=lfs -text
-*.pickle filter=lfs diff=lfs merge=lfs -text
-*.pkl filter=lfs diff=lfs merge=lfs -text
-*.pt filter=lfs diff=lfs merge=lfs -text
-*.pth filter=lfs diff=lfs merge=lfs -text
-*.rar filter=lfs diff=lfs merge=lfs -text
 *.safetensors filter=lfs diff=lfs merge=lfs -text
-saved_model/**/* filter=lfs diff=lfs merge=lfs -text
-*.tar.* filter=lfs diff=lfs merge=lfs -text
-*.tar filter=lfs diff=lfs merge=lfs -text
-*.tflite filter=lfs diff=lfs merge=lfs -text
-*.tgz filter=lfs diff=lfs merge=lfs -text
-*.wasm filter=lfs diff=lfs merge=lfs -text
-*.xz filter=lfs diff=lfs merge=lfs -text
-*.zip filter=lfs diff=lfs merge=lfs -text
-*.zst filter=lfs diff=lfs merge=lfs -text
-*tfevents* filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text

LICENSE_NOTICE.md

@@ -0,0 +1,16 @@
+# License notice
+
+The model weights in this repository are quantized derivatives of
+`black-forest-labs/FLUX.1-dev`, source revision:
+
+`3de623fc3c33e44ffbe2bad470d0f45bccf2eb21`
+
+They are subject to the FLUX.1-dev Non-Commercial License and the upstream
+acceptable-use terms. Review the exact license before downloading or using the
+weights:
+
+https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/3de623fc3c33e44ffbe2bad470d0f45bccf2eb21/LICENSE.md
+
+Nothing in the helper scripts, workflows, documentation, or repository
+metadata grants rights beyond the upstream model license. Users are responsible
+for determining whether their intended use complies with all applicable terms.

README.md

@@ -0,0 +1,156 @@
+---
+license: other
+license_name: flux-1-dev-non-commercial-license
+license_link: https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/3de623fc3c33e44ffbe2bad470d0f45bccf2eb21/LICENSE.md
+base_model: black-forest-labs/FLUX.1-dev
+base_model_relation: quantized
+pipeline_tag: text-to-image
+library_name: comfyui
+tags:
+- flux
+- flux.1-dev
+- comfyui
+- quantization
+- convrot
+- int8
+- int4
+- text-to-image
+inference: false
+---
+
+# FLUX.1-dev ConvRot for ComfyUI
+
+Native ComfyUI ConvRot quantizations of **FLUX.1-dev**, with three diffusion-model choices and an optional INT8 ConvRot T5-XXL text encoder.
+
+These are post-training quantized derivatives of [`black-forest-labs/FLUX.1-dev`](https://huggingface.co/black-forest-labs/FLUX.1-dev) at source revision `3de623fc3c33e44ffbe2bad470d0f45bccf2eb21`. They load with ComfyUI's core `UNETLoader`; no custom INT4 loader is required.
+
+> **License:** The model weights are subject to the upstream FLUX.1-dev Non-Commercial License. Access and use require compliance with that license and the upstream acceptable-use terms. See [License](#license) before downloading.
+
+![Twenty-prompt comparison: Original BF16, Whole W8A8 + INT8 T5, Whole W8A8 + BF16 T5, Partial INT8 + BF16 T5, Paper W4A4 + BF16 T5](assets/overview_contact_sheet.png)
+
+## Files and recommended combinations
+
+| File | Role | Size | Recommendation |
+|---|---|---:|---|
+| `FLUX.1-dev-w8a8-convrot.safetensors` | Whole-DiT ConvRot W8A8 | 11.981 GB | **Default DiT**: best storage/fidelity balance |
+| `FLUX.1-dev-int8_convrot.safetensors` | Partial ConvRot INT8 with sensitive tensors preserved | 15.920 GB | **Quality-first DiT**: closest tested quantized variant to BF16 |
+| `FLUX.1-dev-paper-w4a4-convrot.safetensors` | Paper-aligned whole-DiT ConvRot W4A4 | 6.248 GB | **Memory-first / experimental** |
+| `t5xxl_flux1_int8_convrot.safetensors` | Experimental T5-XXL ConvRot W8A8 | 4.898 GB | Optional text-encoder companion |
+
+The four uploadable files total 39.047 GB. The Original BF16 model shown in the comparison is a reference and is **not** included.
+
+Recommended pipelines:
+
+1. Lowest combined storage: `FLUX.1-dev-w8a8-convrot.safetensors` + `t5xxl_flux1_int8_convrot.safetensors`.
+2. Default quality/storage balance: `FLUX.1-dev-w8a8-convrot.safetensors` + upstream BF16 T5-XXL.
+3. Quality-first: `FLUX.1-dev-int8_convrot.safetensors` + upstream BF16 T5-XXL.
+4. Memory-first: `FLUX.1-dev-paper-w4a4-convrot.safetensors` + upstream BF16 T5-XXL.
+
+The optional INT8 T5 does not contain CLIP-L. FLUX still requires CLIP-L and a VAE.
+
+## What W8A8 and W4A4 mean
+
+ConvRot stores rotated quantized weights plus per-layer metadata. At runtime, the quantized weight layout dispatches the matching ComfyUI/comfy-kitchen linear operator. The current BF16 activation is rotated and dynamically quantized for the matrix multiplication; activations are not stored in the checkpoint.
+
+- **W8A8:** INT8 weights and dynamically quantized INT8 activations for selected linear layers.
+- **W4A4:** packed INT4 weights and dynamically quantized INT4 activations for selected linear layers.
+- Biases, norms, embeddings, and tensors outside each policy remain at their declared higher precision.
+
+Rotation group size is 256. The W4A4 artifact uses quantization group size 64.
+
+## ComfyUI installation
+
+Place the selected files as follows:
+
+```text
+ComfyUI/models/diffusion_models/FLUX.1-dev-w8a8-convrot.safetensors
+# or FLUX.1-dev-int8_convrot.safetensors
+# or FLUX.1-dev-paper-w4a4-convrot.safetensors
+
+ComfyUI/models/text_encoders/t5xxl_flux1_int8_convrot.safetensors  # optional
+```
+
+You must separately obtain the standard FLUX assets under their applicable licenses:
+
+```text
+ComfyUI/models/text_encoders/clip_l_flux1.safetensors
+ComfyUI/models/text_encoders/t5xxl_flux1_bf16.safetensors  # unless using the INT8 T5 here
+ComfyUI/models/vae/ae_flux1.safetensors
+```
+
+Use a current ComfyUI and comfy-kitchen build with native ConvRot support. The validated environment was:
+
+- ComfyUI `0.28.0`
+- comfy-kitchen `0.2.20`
+- comfy-cli `1.11.1`
+- NVIDIA CUDA GPU
+
+W4A4 requires SM 8.0 or newer. The first run may compile kernels and take longer.
+
+Load the diffusion model with core `UNETLoader` and `weight_dtype=default`. Load CLIP-L and the chosen T5 with `DualCLIPLoader(type=flux)`.
+
+A ready-to-use API/comfy-cli workflow is provided at
+[`workflows/FLUX1_Dev_ConvRot_API.json`](workflows/FLUX1_Dev_ConvRot_API.json).
+It defaults to Whole W8A8 + INT8 T5. Change the diffusion-model and/or T5
+filename to test another combination.
+
+## Paired quality evaluation
+
+Twenty 1024×1024 images were generated per pipeline with identical prompts, seeds, sampler, scheduler, guidance, steps, CLIP-L, and VAE. Metrics compare final 8-bit RGB images to Original BF16.
+
+| Pipeline | Global PSNR vs BF16 | Mean per-pair PSNR | Low-VRAM maximum peak |
+|---|---:|---:|---:|
+| Whole W8A8 + INT8 T5 | 26.559 dB | 28.872 dB | 16,265 MiB |
+| Whole W8A8 + BF16 T5 | 27.399 dB | 29.449 dB | 16,298 MiB |
+| Partial INT8 + BF16 T5 | **27.888 dB** | **29.857 dB** | 20,351 MiB |
+| Paper W4A4 + BF16 T5 | 17.926 dB | 19.041 dB | **10,797 MiB** |
+
+The isolated T5 comparison—same Whole W8A8 DiT, BF16 T5 versus INT8 T5—measured 27.389 dB global PSNR and 30.054 dB mean per-pair PSNR.
+
+PSNR measures paired pixel similarity, not aesthetics, prompt adherence, anatomy, typography, or human preference. Small spatial changes can sharply reduce PSNR. LPIPS and human-preference metrics were not computed.
+
+Full records:
+
+- [`assets/quality_metrics.json`](assets/quality_metrics.json)
+- [`assets/VRAM_MATRIX.md`](assets/VRAM_MATRIX.md)
+- [`assets/grid_verification.json`](assets/grid_verification.json)
+
+## VRAM methodology
+
+Each benchmark cell used a fresh ComfyUI process. Total physical GPU memory was sampled every 20 ms under an exclusive GPU lock. Settings were 1024×1024, batch 1, 20 steps, Euler/simple, CFG 1.0, FLUX guidance 3.5. `--lowvram` is an offloading result; hardware, runtime versions, attention backend, and workflow can materially change memory use.
+
+The no-offloading `--highvram` maximum peaks for the four publication pipelines were 19,998 MiB, 21,342 MiB, 21,342 MiB, and 18,974 MiB in the table's order. Original BF16 hit a capacity failure in that 24 GiB environment.
+
+## Quantization policies
+
+- **Whole W8A8:** all 304 paper-scoped 2-D transformer-block linear weights use tensorwise INT8 ConvRot; 476 tensors remain BF16 or otherwise preserved.
+- **Partial INT8:** profile-based selective INT8 ConvRot with a larger BF16-preserved set. This is the largest and highest-PSNR tested quantized DiT.
+- **Paper W4A4:** 301 paper-scoped transformer-block linears use W4A4; 479 tensors remain BF16 or otherwise preserved. ComfyUI's fused `single_blocks.*.linear1` expands some paper component-level decisions to the fused tensor.
+- **INT8 T5-XXL:** 168 encoder linear projections use W8A8; 51 embedding, relative-attention-bias, and normalization tensors remain BF16. This T5 policy is experimental and was not evaluated by the ConvRot paper.
+
+See [`manifests/conversion_summaries.json`](manifests/conversion_summaries.json) and [`release_manifest.json`](release_manifest.json) for artifact-level provenance and hashes.
+
+## Limitations
+
+- These are post-training quantizations, not fine-tuned models.
+- The W4A4 result diverges substantially more from BF16 and is labeled experimental.
+- INT8 T5 image similarity does not establish long-prompt comprehension equivalence.
+- Results cover 20 fixed prompts and one validated runtime/hardware environment.
+- No safety classifier or content filter is included.
+- Quantized checkpoints do not remove the limitations or usage restrictions of FLUX.1-dev.
+
+## License
+
+The quantized weights are derivatives of FLUX.1-dev and are provided under the **FLUX.1-dev Non-Commercial License**. Review and comply with the exact upstream license:
+
+- License: https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/3de623fc3c33e44ffbe2bad470d0f45bccf2eb21/LICENSE.md
+- Base model: https://huggingface.co/black-forest-labs/FLUX.1-dev
+
+The helper workflow/scripts do not grant additional rights to the model weights. See [`LICENSE_NOTICE.md`](LICENSE_NOTICE.md).
+
+## Credits
+
+- Base model: Black Forest Labs, [`FLUX.1-dev`](https://huggingface.co/black-forest-labs/FLUX.1-dev)
+- Quantized runtime: [ComfyUI](https://github.com/comfyanonymous/ComfyUI) and [comfy-kitchen](https://github.com/Comfy-Org/comfy-kitchen)
+- Conversion tooling: [Starnodes Model Converter](https://github.com/Starnodes2024/comfyui-starnodes-modelconverter)
+- Method reference: *ConvRot: Rotation-Based Plug-and-Play 4-bit Quantization for Diffusion Transformers*, arXiv:2512.03673

assets/VRAM_MATRIX.md

@@ -0,0 +1,27 @@
+# FLUX.1 offloading versus no-offloading VRAM matrix
+
+Fresh ComfyUI process per cell; total physical-GPU memory sampled every 20 ms under the exclusive GPU lock.
+`--highvram` is the no-model-offloading control; it is not `--gpu-only`.
+
+| Policy | Pipeline | Status | Cold peak MiB | Warm peak MiB | Maximum peak MiB |
+|---|---|---|---:|---:|---:|
+| lowvram | Original BF16 | success | 24091 | 23650 | 24091 |
+| lowvram | Partial INT8 | success | 20351 | 20016 | 20351 |
+| lowvram | Partial INT4 | success | 16642 | 16604 | 16642 |
+| lowvram | Paper Mixed | success | 12066 | 12050 | 12066 |
+| lowvram | Paper W4A4 | success | 10765 | 10797 | 10797 |
+| lowvram | Whole W8A8 | success | 16298 | 16298 | 16298 |
+| lowvram | Whole W8A8 + INT8 T5 | success | 16265 | 16265 | 16265 |
+| highvram | Original BF16 | capacity_failure | 23939 |  | 23939 |
+| highvram | Partial INT8 | success | 21342 | 21342 | 21342 |
+| highvram | Partial INT4 | success | 21438 | 21438 | 21438 |
+| highvram | Paper Mixed | success | 20062 | 20158 | 20158 |
+| highvram | Paper W4A4 | success | 18942 | 18974 | 18974 |
+| highvram | Whole W8A8 | success | 21342 | 21342 | 21342 |
+| highvram | Whole W8A8 + INT8 T5 | success | 19966 | 19998 | 19998 |
+
+GPU UUID: `GPU-27ff99d6-d77d-2226-a4b5-7a11b8ef6bdd`
+
+Settings: 1024×1024, batch 1, 20 steps, Euler/simple, CFG 1.0, Flux guidance 3.5.
+
+Source benchmark state: measurement complete, run `20260719T215033Z_1143248`. The benchmark used total physical-GPU memory because WSL did not expose per-process memory for compute rows.

assets/grid_verification.json

@@ -0,0 +1,28 @@
+{
+  "schema_version": 1,
+  "status": "PASS",
+  "grid_count": 20,
+  "source_image_count": 100,
+  "unique_grid_hashes": 20,
+  "unique_source_hashes": 100,
+  "grid_dimensions": {
+    "width": 5168,
+    "height": 1136
+  },
+  "labels": [
+    "Original BF16",
+    "Whole W8A8 + INT8 T5",
+    "Whole W8A8 + BF16 T5",
+    "Partial INT8 + BF16 T5",
+    "Paper W4A4 + BF16 T5"
+  ],
+  "pixel_identity_check": "PASS for all 100 rendered source regions",
+  "source_grid_manifest_sha256": "22354490f79e3126d129098ad14d4baa07fbba43d8f9f9d4a2862f4a385b914d",
+  "overview_contact_sheet": {
+    "path": "assets/overview_contact_sheet.png",
+    "bytes": 9961323,
+    "sha256": "3af42bd633bd813f806ff8652a23e21b133004b012ef509656ce336914e914d0",
+    "width": 2596,
+    "height": 2948
+  }
+}

assets/quality_metrics.json

@@ -0,0 +1,644 @@
+{
+  "contract": {
+    "channels": "RGB",
+    "height": 1024,
+    "pixel_range": "8-bit [0,255]",
+    "prompt_count": 20,
+    "same_prompt_seed_sampler_and_settings": true,
+    "width": 1024
+  },
+  "created_at": "2026-07-20T16:42:54+00:00",
+  "limitations": [
+    "PSNR measures paired pixel similarity to the BF16 reference, not aesthetics or prompt adherence.",
+    "LPIPS and human-preference metrics were not computed."
+  ],
+  "reference": {
+    "label": "Original BF16",
+    "model_id": "original_bf16"
+  },
+  "results": [
+    {
+      "global_mae_rgb_8bit": 4.184344148635864,
+      "global_mse_rgb_8bit": 143.60905289649963,
+      "global_psnr_db": 26.55898542834396,
+      "label": "Whole W8A8 + INT8 T5",
+      "max_pair_psnr_db": 42.96481803223763,
+      "mean_pair_psnr_db": 28.871755201270258,
+      "median_pair_psnr_db": 29.34872857885429,
+      "min_pair_psnr_db": 20.67506469049193,
+      "model_id": "t5_int8_convrot",
+      "pair_count": 20,
+      "pairs": [
+        {
+          "mae_rgb_8bit": 1.8707882563273113,
+          "mse_rgb_8bit": 25.03745937347412,
+          "prompt_id": "prompt_01",
+          "psnr_db": 34.14490103264843,
+          "seed": 2737473617249173572
+        },
+        {
+          "mae_rgb_8bit": 0.6493326822916666,
+          "mse_rgb_8bit": 3.285477956136068,
+          "prompt_id": "prompt_02",
+          "psnr_db": 42.96481803223763,
+          "seed": 5636279213593584334
+        },
+        {
+          "mae_rgb_8bit": 5.9316714604695635,
+          "mse_rgb_8bit": 281.34023062388104,
+          "prompt_id": "prompt_03",
+          "psnr_db": 23.638485217397374,
+          "seed": 2337272915321693975
+        },
+        {
+          "mae_rgb_8bit": 4.219496726989746,
+          "mse_rgb_8bit": 117.22437000274658,
+          "prompt_id": "prompt_04",
+          "psnr_db": 27.44062453473368,
+          "seed": 5284037423569190479
+        },
+        {
+          "mae_rgb_8bit": 2.4964122772216797,
+          "mse_rgb_8bit": 54.10380299886068,
+          "prompt_id": "prompt_05",
+          "psnr_db": 30.798525677877432,
+          "seed": 6913066525750388688
+        },
+        {
+          "mae_rgb_8bit": 2.657512982686361,
+          "mse_rgb_8bit": 49.35343837738037,
+          "prompt_id": "prompt_06",
+          "psnr_db": 31.197629461863695,
+          "seed": 7394637781574154634
+        },
+        {
+          "mae_rgb_8bit": 8.83125114440918,
+          "mse_rgb_8bit": 497.9759298960368,
+          "prompt_id": "prompt_07",
+          "psnr_db": 21.158720096061163,
+          "seed": 8805682773639136733
+        },
+        {
+          "mae_rgb_8bit": 3.2949819564819336,
+          "mse_rgb_8bit": 72.90100193023682,
+          "prompt_id": "prompt_08",
+          "psnr_db": 29.503468636914594,
+          "seed": 8599963958067732996
+        },
+        {
+          "mae_rgb_8bit": 5.054506619771321,
+          "mse_rgb_8bit": 201.2291866938273,
+          "prompt_id": "prompt_09",
+          "psnr_db": 25.093893889533007,
+          "seed": 5673822435512390978
+        },
+        {
+          "mae_rgb_8bit": 3.1050949096679688,
+          "mse_rgb_8bit": 75.71082433064778,
+          "prompt_id": "prompt_10",
+          "psnr_db": 29.339223861101253,
+          "seed": 4537681100734872717
+        },
+        {
+          "mae_rgb_8bit": 2.4548552831014,
+          "mse_rgb_8bit": 44.98679256439209,
+          "prompt_id": "prompt_11",
+          "psnr_db": 31.59995330610588,
+          "seed": 6991054715693460219
+        },
+        {
+          "mae_rgb_8bit": 3.227843920389811,
+          "mse_rgb_8bit": 66.2210823694865,
+          "prompt_id": "prompt_12",
+          "psnr_db": 29.92084085943045,
+          "seed": 4444155078815147914
+        },
+        {
+          "mae_rgb_8bit": 10.309847195943197,
+          "mse_rgb_8bit": 556.6393340428671,
+          "prompt_id": "prompt_13",
+          "psnr_db": 20.67506469049193,
+          "seed": 6135808568015678407
+        },
+        {
+          "mae_rgb_8bit": 1.6483319600423176,
+          "mse_rgb_8bit": 23.638425827026367,
+          "prompt_id": "prompt_14",
+          "psnr_db": 34.39461809022444,
+          "seed": 713035478727730346
+        },
+        {
+          "mae_rgb_8bit": 4.416806221008301,
+          "mse_rgb_8bit": 114.49958451588948,
+          "prompt_id": "prompt_15",
+          "psnr_db": 27.542764501115137,
+          "seed": 248937108497645287
+        },
+        {
+          "mae_rgb_8bit": 9.364078839619955,
+          "mse_rgb_8bit": 304.6785605748494,
+          "prompt_id": "prompt_16",
+          "psnr_db": 23.292384657250743,
+          "seed": 5277644178537905334
+        },
+        {
+          "mae_rgb_8bit": 2.052689552307129,
+          "mse_rgb_8bit": 51.52497704823812,
+          "prompt_id": "prompt_17",
+          "psnr_db": 31.010625538727638,
+          "seed": 7635742545595743441
+        },
+        {
+          "mae_rgb_8bit": 4.981616973876953,
+          "mse_rgb_8bit": 159.03070195515951,
+          "prompt_id": "prompt_18",
+          "psnr_db": 26.11599384959113,
+          "seed": 300265456486907271
+        },
+        {
+          "mae_rgb_8bit": 3.245227813720703,
+          "mse_rgb_8bit": 97.41972096761067,
+          "prompt_id": "prompt_19",
+          "psnr_db": 28.244334795492247,
+          "seed": 5279743298653840878
+        },
+        {
+          "mae_rgb_8bit": 3.8745361963907876,
+          "mse_rgb_8bit": 75.38015588124593,
+          "prompt_id": "prompt_20",
+          "psnr_db": 29.358233296607324,
+          "seed": 533279967017145387
+        }
+      ],
+      "reference_model_id": "original_bf16"
+    },
+    {
+      "global_mae_rgb_8bit": 3.8457299709320067,
+      "global_mse_rgb_8bit": 118.34940997759502,
+      "global_psnr_db": 27.39914263741072,
+      "label": "Whole W8A8 + BF16 T5",
+      "max_pair_psnr_db": 45.70847505288416,
+      "mean_pair_psnr_db": 29.449424636693966,
+      "median_pair_psnr_db": 28.553903379427116,
+      "min_pair_psnr_db": 23.10766015887956,
+      "model_id": "whole_w8a8",
+      "pair_count": 20,
+      "pairs": [
+        {
+          "mae_rgb_8bit": 1.9576581319173176,
+          "mse_rgb_8bit": 29.332815806070965,
+          "prompt_id": "prompt_01",
+          "psnr_db": 33.45726605751621,
+          "seed": 2737473617249173572
+        },
+        {
+          "mae_rgb_8bit": 0.48685487111409503,
+          "mse_rgb_8bit": 1.7467584609985352,
+          "prompt_id": "prompt_02",
+          "psnr_db": 45.70847505288416,
+          "seed": 5636279213593584334
+        },
+        {
+          "mae_rgb_8bit": 6.599390983581543,
+          "mse_rgb_8bit": 317.9174343744914,
+          "prompt_id": "prompt_03",
+          "psnr_db": 23.10766015887956,
+          "seed": 2337272915321693975
+        },
+        {
+          "mae_rgb_8bit": 4.497992197672526,
+          "mse_rgb_8bit": 121.32832463582356,
+          "prompt_id": "prompt_04",
+          "psnr_db": 27.29118160190623,
+          "seed": 5284037423569190479
+        },
+        {
+          "mae_rgb_8bit": 4.595889409383138,
+          "mse_rgb_8bit": 152.80340512593588,
+          "prompt_id": "prompt_05",
+          "psnr_db": 26.289473285462584,
+          "seed": 6913066525750388688
+        },
+        {
+          "mae_rgb_8bit": 2.397451400756836,
+          "mse_rgb_8bit": 38.380432764689125,
+          "prompt_id": "prompt_06",
+          "psnr_db": 32.28970493484174,
+          "seed": 7394637781574154634
+        },
+        {
+          "mae_rgb_8bit": 4.228646278381348,
+          "mse_rgb_8bit": 191.70894972483316,
+          "prompt_id": "prompt_07",
+          "psnr_db": 25.3043797294873,
+          "seed": 8805682773639136733
+        },
+        {
+          "mae_rgb_8bit": 2.0582707722981772,
+          "mse_rgb_8bit": 24.999243418375652,
+          "prompt_id": "prompt_08",
+          "psnr_db": 34.151534955637366,
+          "seed": 8599963958067732996
+        },
+        {
+          "mae_rgb_8bit": 5.316611925760905,
+          "mse_rgb_8bit": 213.4386822382609,
+          "prompt_id": "prompt_09",
+          "psnr_db": 24.838072299396377,
+          "seed": 5673822435512390978
+        },
+        {
+          "mae_rgb_8bit": 3.1878668467203775,
+          "mse_rgb_8bit": 82.49698829650879,
+          "prompt_id": "prompt_10",
+          "psnr_db": 28.96642266743221,
+          "seed": 4537681100734872717
+        },
+        {
+          "mae_rgb_8bit": 2.101264317830404,
+          "mse_rgb_8bit": 36.28457514444987,
+          "prompt_id": "prompt_11",
+          "psnr_db": 32.53358318568201,
+          "seed": 6991054715693460219
+        },
+        {
+          "mae_rgb_8bit": 2.8856945037841797,
+          "mse_rgb_8bit": 55.548718770345054,
+          "prompt_id": "prompt_12",
+          "psnr_db": 30.684063144656623,
+          "seed": 4444155078815147914
+        },
+        {
+          "mae_rgb_8bit": 4.770760218302409,
+          "mse_rgb_8bit": 148.125763575236,
+          "prompt_id": "prompt_13",
+          "psnr_db": 26.424497587582426,
+          "seed": 6135808568015678407
+        },
+        {
+          "mae_rgb_8bit": 1.4494740168253581,
+          "mse_rgb_8bit": 19.55673948923747,
+          "prompt_id": "prompt_14",
+          "psnr_db": 35.217839102049666,
+          "seed": 713035478727730346
+        },
+        {
+          "mae_rgb_8bit": 4.08154296875,
+          "mse_rgb_8bit": 99.75667190551758,
+          "prompt_id": "prompt_15",
+          "psnr_db": 28.141384091422022,
+          "seed": 248937108497645287
+        },
+        {
+          "mae_rgb_8bit": 8.978434880574545,
+          "mse_rgb_8bit": 286.14463488260907,
+          "prompt_id": "prompt_16",
+          "psnr_db": 23.564947534252543,
+          "seed": 5277644178537905334
+        },
+        {
+          "mae_rgb_8bit": 2.162648836771647,
+          "mse_rgb_8bit": 46.40346622467041,
+          "prompt_id": "prompt_17",
+          "psnr_db": 31.46529938372888,
+          "seed": 7635742545595743441
+        },
+        {
+          "mae_rgb_8bit": 7.308785438537598,
+          "mse_rgb_8bit": 290.49807771046954,
+          "prompt_id": "prompt_18",
+          "psnr_db": 23.49937097953946,
+          "seed": 300265456486907271
+        },
+        {
+          "mae_rgb_8bit": 2.9200544357299805,
+          "mse_rgb_8bit": 81.00839010874431,
+          "prompt_id": "prompt_19",
+          "psnr_db": 29.045503594061852,
+          "seed": 5279743298653840878
+        },
+        {
+          "mae_rgb_8bit": 4.929306983947754,
+          "mse_rgb_8bit": 129.50812689463297,
+          "prompt_id": "prompt_20",
+          "psnr_db": 27.007833387459964,
+          "seed": 533279967017145387
+        }
+      ],
+      "reference_model_id": "original_bf16"
+    },
+    {
+      "global_mae_rgb_8bit": 3.529950507481893,
+      "global_mse_rgb_8bit": 105.74577018419902,
+      "global_psnr_db": 27.88817356191052,
+      "label": "Partial INT8 + BF16 T5",
+      "max_pair_psnr_db": 45.66462536442023,
+      "mean_pair_psnr_db": 29.856776264624564,
+      "median_pair_psnr_db": 29.571032038674957,
+      "min_pair_psnr_db": 23.511026520961206,
+      "model_id": "convrot_int8",
+      "pair_count": 20,
+      "pairs": [
+        {
+          "mae_rgb_8bit": 1.6430425643920898,
+          "mse_rgb_8bit": 22.24471886952718,
+          "prompt_id": "prompt_01",
+          "psnr_db": 34.65853439396324,
+          "seed": 2737473617249173572
+        },
+        {
+          "mae_rgb_8bit": 0.45065879821777344,
+          "mse_rgb_8bit": 1.7644844055175781,
+          "prompt_id": "prompt_02",
+          "psnr_db": 45.66462536442023,
+          "seed": 5636279213593584334
+        },
+        {
+          "mae_rgb_8bit": 2.1578118006388345,
+          "mse_rgb_8bit": 47.41307862599691,
+          "prompt_id": "prompt_03",
+          "psnr_db": 31.371822050243104,
+          "seed": 2337272915321693975
+        },
+        {
+          "mae_rgb_8bit": 2.8128862380981445,
+          "mse_rgb_8bit": 66.53188991546631,
+          "prompt_id": "prompt_04",
+          "psnr_db": 29.90050500608385,
+          "seed": 5284037423569190479
+        },
+        {
+          "mae_rgb_8bit": 6.780258814493815,
+          "mse_rgb_8bit": 268.41435559590656,
+          "prompt_id": "prompt_05",
+          "psnr_db": 23.842746213927057,
+          "seed": 6913066525750388688
+        },
+        {
+          "mae_rgb_8bit": 2.7879279454549155,
+          "mse_rgb_8bit": 58.42911624908447,
+          "prompt_id": "prompt_06",
+          "psnr_db": 30.464510432902898,
+          "seed": 7394637781574154634
+        },
+        {
+          "mae_rgb_8bit": 5.940625826517741,
+          "mse_rgb_8bit": 289.7194878260295,
+          "prompt_id": "prompt_07",
+          "psnr_db": 23.511026520961206,
+          "seed": 8805682773639136733
+        },
+        {
+          "mae_rgb_8bit": 2.69136110941569,
+          "mse_rgb_8bit": 49.07272084554037,
+          "prompt_id": "prompt_08",
+          "psnr_db": 31.22240222686356,
+          "seed": 8599963958067732996
+        },
+        {
+          "mae_rgb_8bit": 5.244619369506836,
+          "mse_rgb_8bit": 213.63016319274902,
+          "prompt_id": "prompt_09",
+          "psnr_db": 24.83417788619411,
+          "seed": 5673822435512390978
+        },
+        {
+          "mae_rgb_8bit": 3.4313023885091147,
+          "mse_rgb_8bit": 102.67724291483562,
+          "prompt_id": "prompt_10",
+          "psnr_db": 28.01606162369761,
+          "seed": 4537681100734872717
+        },
+        {
+          "mae_rgb_8bit": 1.7503690719604492,
+          "mse_rgb_8bit": 21.204309781392414,
+          "prompt_id": "prompt_11",
+          "psnr_db": 34.86656220502798,
+          "seed": 6991054715693460219
+        },
+        {
+          "mae_rgb_8bit": 2.6095762252807617,
+          "mse_rgb_8bit": 47.14798386891683,
+          "prompt_id": "prompt_12",
+          "psnr_db": 31.396172345967884,
+          "seed": 4444155078815147914
+        },
+        {
+          "mae_rgb_8bit": 3.23709774017334,
+          "mse_rgb_8bit": 77.43270905812581,
+          "prompt_id": "prompt_13",
+          "psnr_db": 29.24155907126606,
+          "seed": 6135808568015678407
+        },
+        {
+          "mae_rgb_8bit": 1.647062619527181,
+          "mse_rgb_8bit": 26.97847906748454,
+          "prompt_id": "prompt_14",
+          "psnr_db": 33.82062898527484,
+          "seed": 713035478727730346
+        },
+        {
+          "mae_rgb_8bit": 4.368714014689128,
+          "mse_rgb_8bit": 104.97626558939616,
+          "prompt_id": "prompt_15",
+          "psnr_db": 27.91989241690556,
+          "seed": 248937108497645287
+        },
+        {
+          "mae_rgb_8bit": 6.765830675760905,
+          "mse_rgb_8bit": 187.27487786610922,
+          "prompt_id": "prompt_16",
+          "psnr_db": 25.406008383558977,
+          "seed": 5277644178537905334
+        },
+        {
+          "mae_rgb_8bit": 2.061037063598633,
+          "mse_rgb_8bit": 50.301029205322266,
+          "prompt_id": "prompt_17",
+          "psnr_db": 31.11503489656528,
+          "seed": 7635742545595743441
+        },
+        {
+          "mae_rgb_8bit": 6.625752766927083,
+          "mse_rgb_8bit": 274.37188784281415,
+          "prompt_id": "prompt_18",
+          "psnr_db": 23.747407493878026,
+          "seed": 300265456486907271
+        },
+        {
+          "mae_rgb_8bit": 3.0780162811279297,
+          "mse_rgb_8bit": 86.96947542826335,
+          "prompt_id": "prompt_19",
+          "psnr_db": 28.737135103091486,
+          "seed": 5279743298653840878
+        },
+        {
+          "mae_rgb_8bit": 4.515058835347493,
+          "mse_rgb_8bit": 118.36112753550212,
+          "prompt_id": "prompt_20",
+          "psnr_db": 27.398712671698327,
+          "seed": 533279967017145387
+        }
+      ],
+      "reference_model_id": "original_bf16"
+    },
+    {
+      "global_mae_rgb_8bit": 17.185767714182536,
+      "global_mse_rgb_8bit": 1048.3769245465596,
+      "global_psnr_db": 17.92562907590282,
+      "label": "Paper W4A4 + BF16 T5",
+      "max_pair_psnr_db": 27.43898551645215,
+      "mean_pair_psnr_db": 19.040987054028783,
+      "median_pair_psnr_db": 18.33645593419423,
+      "min_pair_psnr_db": 13.220893291481797,
+      "model_id": "paper_w4a4",
+      "pair_count": 20,
+      "pairs": [
+        {
+          "mae_rgb_8bit": 9.805227279663086,
+          "mse_rgb_8bit": 363.933437983195,
+          "prompt_id": "prompt_01",
+          "psnr_db": 22.520584007352777,
+          "seed": 2737473617249173572
+        },
+        {
+          "mae_rgb_8bit": 4.84106985727946,
+          "mse_rgb_8bit": 117.2686185836792,
+          "prompt_id": "prompt_02",
+          "psnr_db": 27.43898551645215,
+          "seed": 5636279213593584334
+        },
+        {
+          "mae_rgb_8bit": 10.301324208577475,
+          "mse_rgb_8bit": 391.7325661977132,
+          "prompt_id": "prompt_03",
+          "psnr_db": 22.20090683289783,
+          "seed": 2337272915321693975
+        },
+        {
+          "mae_rgb_8bit": 21.82541561126709,
+          "mse_rgb_8bit": 1270.901157061259,
+          "prompt_id": "prompt_04",
+          "psnr_db": 17.089685857758415,
+          "seed": 5284037423569190479
+        },
+        {
+          "mae_rgb_8bit": 15.27580738067627,
+          "mse_rgb_8bit": 945.251550356547,
+          "prompt_id": "prompt_05",
+          "psnr_db": 18.3753296252364,
+          "seed": 6913066525750388688
+        },
+        {
+          "mae_rgb_8bit": 10.646452903747559,
+          "mse_rgb_8bit": 339.07828934987384,
+          "prompt_id": "prompt_06",
+          "psnr_db": 22.827803773929737,
+          "seed": 7394637781574154634
+        },
+        {
+          "mae_rgb_8bit": 22.21392822265625,
+          "mse_rgb_8bit": 1860.1204293568928,
+          "prompt_id": "prompt_07",
+          "psnr_db": 15.435392983101881,
+          "seed": 8805682773639136733
+        },
+        {
+          "mae_rgb_8bit": 14.578474362691244,
+          "mse_rgb_8bit": 789.6456416447958,
+          "prompt_id": "prompt_08",
+          "psnr_db": 19.156481181901018,
+          "seed": 8599963958067732996
+        },
+        {
+          "mae_rgb_8bit": 23.46330388387044,
+          "mse_rgb_8bit": 1956.1720809936523,
+          "prompt_id": "prompt_09",
+          "psnr_db": 15.216733046194022,
+          "seed": 5673822435512390978
+        },
+        {
+          "mae_rgb_8bit": 35.05847581227621,
+          "mse_rgb_8bit": 3097.355337460836,
+          "prompt_id": "prompt_10",
+          "psnr_db": 13.220893291481797,
+          "seed": 4537681100734872717
+        },
+        {
+          "mae_rgb_8bit": 17.353435516357422,
+          "mse_rgb_8bit": 991.8816242218018,
+          "prompt_id": "prompt_11",
+          "psnr_db": 18.166205163497114,
+          "seed": 6991054715693460219
+        },
+        {
+          "mae_rgb_8bit": 9.548001925150553,
+          "mse_rgb_8bit": 311.9878346125285,
+          "prompt_id": "prompt_12",
+          "psnr_db": 23.189427010278493,
+          "seed": 4444155078815147914
+        },
+        {
+          "mae_rgb_8bit": 26.1892032623291,
+          "mse_rgb_8bit": 1978.286860148112,
+          "prompt_id": "prompt_13",
+          "psnr_db": 15.167910944629083,
+          "seed": 6135808568015678407
+        },
+        {
+          "mae_rgb_8bit": 12.478487650553385,
+          "mse_rgb_8bit": 633.0524272918701,
+          "prompt_id": "prompt_14",
+          "psnr_db": 20.116406825397924,
+          "seed": 713035478727730346
+        },
+        {
+          "mae_rgb_8bit": 19.866172154744465,
+          "mse_rgb_8bit": 1099.4894485473633,
+          "prompt_id": "prompt_15",
+          "psnr_db": 17.718892949379445,
+          "seed": 248937108497645287
+        },
+        {
+          "mae_rgb_8bit": 20.394683837890625,
+          "mse_rgb_8bit": 962.3258158365885,
+          "prompt_id": "prompt_16",
+          "psnr_db": 18.29758224315206,
+          "seed": 5277644178537905334
+        },
+        {
+          "mae_rgb_8bit": 9.971921920776367,
+          "mse_rgb_8bit": 427.9283091227214,
+          "prompt_id": "prompt_17",
+          "psnr_db": 21.817093431638046,
+          "seed": 7635742545595743441
+        },
+        {
+          "mae_rgb_8bit": 19.527167956034344,
+          "mse_rgb_8bit": 1111.8292411168416,
+          "prompt_id": "prompt_18",
+          "psnr_db": 17.67042269067247,
+          "seed": 300265456486907271
+        },
+        {
+          "mae_rgb_8bit": 16.195018132527668,
+          "mse_rgb_8bit": 903.1033693949381,
+          "prompt_id": "prompt_19",
+          "psnr_db": 18.573428982747764,
+          "seed": 5279743298653840878
+        },
+        {
+          "mae_rgb_8bit": 24.181782404581707,
+          "mse_rgb_8bit": 1416.1944516499836,
+          "prompt_id": "prompt_20",
+          "psnr_db": 16.61957472287724,
+          "seed": 533279967017145387
+        }
+      ],
+      "reference_model_id": "original_bf16"
+    }
+  ],
+  "schema_version": 1,
+  "source_grid_manifest_sha256": "22354490f79e3126d129098ad14d4baa07fbba43d8f9f9d4a2862f4a385b914d",
+  "status": "verified_complete"
+}

manifests/conversion_summaries.json

@@ -0,0 +1,64 @@
+{
+  "schema_version": 1,
+  "base_model": {
+    "repo_id": "black-forest-labs/FLUX.1-dev",
+    "revision": "3de623fc3c33e44ffbe2bad470d0f45bccf2eb21",
+    "license_name": "flux-1-dev-non-commercial-license",
+    "license_url": "https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/3de623fc3c33e44ffbe2bad470d0f45bccf2eb21/LICENSE.md"
+  },
+  "artifacts": {
+    "FLUX.1-dev-w8a8-convrot.safetensors": {
+      "policy": "whole_dit_w8a8_convrot",
+      "convrot_group_size": 256,
+      "counts": {
+        "w8a8": 304,
+        "preserve_bf16": 476
+      },
+      "limitations": [
+        "Paper scope is the FLUX.1 diffusion transformer; CLIP, T5, VAE, biases, norms, and non-block linears remain BF16.",
+        "ComfyUI fuses single-block q/k/v/MLP input projections into linear1, expanding component-level decisions to the fused tensor."
+      ],
+      "source_manifest_sha256": "859aa6f5321c0a528426a0518d1c3b20d0b1701d84896c1cf9c34611a8a8b322"
+    },
+    "FLUX.1-dev-int8_convrot.safetensors": {
+      "policy": "partial_profile_int8_convrot",
+      "convrot_group_size": 256,
+      "limitations": [
+        "Profile-based selective quantization rather than the whole-DiT paper ablation.",
+        "Larger checkpoint because more sensitive tensors remain at higher precision."
+      ],
+      "source_manifest_sha256": null
+    },
+    "FLUX.1-dev-paper-w4a4-convrot.safetensors": {
+      "policy": "paper_whole_dit_w4a4_convrot",
+      "convrot_group_size": 256,
+      "quantization_group_size": 64,
+      "counts": {
+        "w4a4": 301,
+        "preserve_bf16": 479
+      },
+      "limitations": [
+        "Memory-first experimental variant with substantially lower paired PSNR than INT8 variants.",
+        "ComfyUI fuses single-block q/k/v/MLP input projections into linear1, expanding component-level decisions to the fused tensor."
+      ],
+      "source_manifest_sha256": "aaa49f1d13d719eb813addf57e380f4d77c01032db1b33e03b8d9c1156fb7390"
+    },
+    "t5xxl_flux1_int8_convrot.safetensors": {
+      "policy": "t5xxl_encoder_w8a8_convrot",
+      "convrot_group_size": 256,
+      "counts": {
+        "w8a8": 168,
+        "preserve_bf16": 51
+      },
+      "limitations": [
+        "Experimental T5-XXL policy not evaluated by the ConvRot paper.",
+        "Image similarity does not establish text-comprehension equivalence."
+      ],
+      "source_manifest_sha256": "5ef2d35fef8945a9e9e5c68c028aa74a0ea47f2e834e80614fc4ab9542199bfb"
+    }
+  },
+  "paper": {
+    "title": "ConvRot: Rotation-Based Plug-and-Play 4-bit Quantization for Diffusion Transformers",
+    "arxiv": "2512.03673"
+  }
+}

release_manifest.json

@@ -0,0 +1,99 @@
+{
+  "schema_version": 1,
+  "status": "ready_for_local_verification",
+  "created_at": "2026-07-20T16:40:30Z",
+  "suggested_repo_id": "SearchingMan/FLUX.1-dev-ConvRot",
+  "remote_status": "not_created",
+  "base_model": {
+    "repo_id": "black-forest-labs/FLUX.1-dev",
+    "revision": "3de623fc3c33e44ffbe2bad470d0f45bccf2eb21",
+    "gated": true,
+    "license": "other",
+    "license_name": "flux-1-dev-non-commercial-license",
+    "license_url": "https://huggingface.co/black-forest-labs/FLUX.1-dev/blob/3de623fc3c33e44ffbe2bad470d0f45bccf2eb21/LICENSE.md"
+  },
+  "artifact_total_bytes": 39047204632,
+  "artifacts": [
+    {
+      "repo_path": "FLUX.1-dev-w8a8-convrot.safetensors",
+      "source_relative_path": "diffusion_models/FLUX.1-dev-w8a8-convrot.safetensors",
+      "role": "whole_dit_w8a8_default",
+      "bytes": 11980878688,
+      "sha256": "3a15dd0b701173132bda34835b07fc6640bff94f048ee2e7a9660aa8e1bf723a",
+      "source_manifest_relative_path": "diffusion_models/FLUX.1-dev-w8a8-convrot.safetensors.manifest.json",
+      "source_manifest_sha256": "859aa6f5321c0a528426a0518d1c3b20d0b1701d84896c1cf9c34611a8a8b322"
+    },
+    {
+      "repo_path": "FLUX.1-dev-int8_convrot.safetensors",
+      "source_relative_path": "diffusion_models/FLUX.1-dev-int8_convrot.safetensors",
+      "role": "partial_int8_quality_first",
+      "bytes": 15920463088,
+      "sha256": "18f0af3a5ccc3c59044e282b8c1c70cce8356e8c01888693fc5e386e2576b72a",
+      "source_manifest_relative_path": null,
+      "source_manifest_sha256": null
+    },
+    {
+      "repo_path": "FLUX.1-dev-paper-w4a4-convrot.safetensors",
+      "source_relative_path": "diffusion_models/FLUX.1-dev-paper-w4a4-convrot.safetensors",
+      "role": "whole_dit_w4a4_memory_first_experimental",
+      "bytes": 6247752968,
+      "sha256": "431b92916da98eaa6c7a622db8302db5a49277fda97a7076835ebc3ca3f56ea0",
+      "source_manifest_relative_path": "diffusion_models/FLUX.1-dev-paper-w4a4-convrot.safetensors.manifest.json",
+      "source_manifest_sha256": "aaa49f1d13d719eb813addf57e380f4d77c01032db1b33e03b8d9c1156fb7390"
+    },
+    {
+      "repo_path": "t5xxl_flux1_int8_convrot.safetensors",
+      "source_relative_path": "text_encoders/t5xxl_flux1_int8_convrot.safetensors",
+      "role": "optional_t5xxl_w8a8_companion",
+      "bytes": 4898109888,
+      "sha256": "78cd681f670b4bc064a8880e40bd4806aa266c6b484a2012846cbeae6f0bfe17",
+      "source_manifest_relative_path": "text_encoders/t5xxl_flux1_int8_convrot.safetensors.manifest.json",
+      "source_manifest_sha256": "5ef2d35fef8945a9e9e5c68c028aa74a0ea47f2e834e80614fc4ab9542199bfb"
+    }
+  ],
+  "required_repository_files": [
+    ".gitattributes",
+    "LICENSE_NOTICE.md",
+    "README.md",
+    "assets/VRAM_MATRIX.md",
+    "assets/grid_verification.json",
+    "assets/overview_contact_sheet.png",
+    "assets/quality_metrics.json",
+    "manifests/conversion_summaries.json",
+    "release_manifest.json",
+    "scripts/compute_quality_metrics.py",
+    "scripts/upload.py",
+    "scripts/verify_release.py",
+    "workflows/FLUX1_Dev_ConvRot_API.json"
+  ],
+  "excluded_artifacts": [
+    "Original BF16 reference",
+    "CLIP-L",
+    "BF16 T5-XXL",
+    "VAE"
+  ],
+  "evidence": {
+    "overview_contact_sheet": {
+      "repo_path": "assets/overview_contact_sheet.png",
+      "bytes": 9961323,
+      "sha256": "3af42bd633bd813f806ff8652a23e21b133004b012ef509656ce336914e914d0",
+      "width": 2596,
+      "height": 2948
+    },
+    "source_grid_manifest_sha256": "22354490f79e3126d129098ad14d4baa07fbba43d8f9f9d4a2862f4a385b914d",
+    "quality_global_psnr_db": {
+      "t5_int8_convrot": 26.55898542834396,
+      "whole_w8a8": 27.39914263741072,
+      "convrot_int8": 27.88817356191052,
+      "paper_w4a4": 17.92562907590282
+    },
+    "grid_pixel_identity": "PASS for all 100 rendered source regions",
+    "vram_run_id": "20260719T215033Z_1143248"
+  },
+  "upload_policy": {
+    "default_mode": "dry_run",
+    "remote_creation": "explicit_private_only",
+    "license_acceptance_flag_required": true,
+    "full_model_hash_verification_required": true
+  }
+}

release_verification.json

@@ -0,0 +1,110 @@
+{
+  "artifact_count": 4,
+  "artifact_total_bytes": 39047204632,
+  "artifacts": [
+    {
+      "bytes": 11980878688,
+      "hash_verified": true,
+      "repo_path": "FLUX.1-dev-w8a8-convrot.safetensors",
+      "sha256": "3a15dd0b701173132bda34835b07fc6640bff94f048ee2e7a9660aa8e1bf723a",
+      "source_relative_path": "diffusion_models/FLUX.1-dev-w8a8-convrot.safetensors"
+    },
+    {
+      "bytes": 15920463088,
+      "hash_verified": true,
+      "repo_path": "FLUX.1-dev-int8_convrot.safetensors",
+      "sha256": "18f0af3a5ccc3c59044e282b8c1c70cce8356e8c01888693fc5e386e2576b72a",
+      "source_relative_path": "diffusion_models/FLUX.1-dev-int8_convrot.safetensors"
+    },
+    {
+      "bytes": 6247752968,
+      "hash_verified": true,
+      "repo_path": "FLUX.1-dev-paper-w4a4-convrot.safetensors",
+      "sha256": "431b92916da98eaa6c7a622db8302db5a49277fda97a7076835ebc3ca3f56ea0",
+      "source_relative_path": "diffusion_models/FLUX.1-dev-paper-w4a4-convrot.safetensors"
+    },
+    {
+      "bytes": 4898109888,
+      "hash_verified": true,
+      "repo_path": "t5xxl_flux1_int8_convrot.safetensors",
+      "sha256": "78cd681f670b4bc064a8880e40bd4806aa266c6b484a2012846cbeae6f0bfe17",
+      "source_relative_path": "text_encoders/t5xxl_flux1_int8_convrot.safetensors"
+    }
+  ],
+  "model_hashes_verified": true,
+  "overview_sha256": "3af42bd633bd813f806ff8652a23e21b133004b012ef509656ce336914e914d0",
+  "quality_source_grid_manifest_sha256": "22354490f79e3126d129098ad14d4baa07fbba43d8f9f9d4a2862f4a385b914d",
+  "remote_status": "not_created",
+  "schema_version": 1,
+  "status": "PASS",
+  "suggested_repo_id": "SearchingMan/FLUX.1-dev-ConvRot",
+  "support_file_count": 13,
+  "support_files": [
+    {
+      "bytes": 92,
+      "path": ".gitattributes",
+      "sha256": "32c3d5d9a15f591030c3a116ba7d068f88aa3e59f3f50edfa173e9174fa8d627"
+    },
+    {
+      "bytes": 682,
+      "path": "LICENSE_NOTICE.md",
+      "sha256": "89032e53e2394d6c57571ff9040feab2c0035836d0bb1bf5ea778f8436014c0a"
+    },
+    {
+      "bytes": 8682,
+      "path": "README.md",
+      "sha256": "e89065eda3304345d8ea7b751013646277347f6ee78a7482d9eecd1294112175"
+    },
+    {
+      "bytes": 1546,
+      "path": "assets/VRAM_MATRIX.md",
+      "sha256": "046a6f12f5f5bde79c3313b024ce8d52a582290aaea32004dca8d3313d15ff66"
+    },
+    {
+      "bytes": 770,
+      "path": "assets/grid_verification.json",
+      "sha256": "8d3e99f9b1c57ec0a6799ad82fb4254aef76a01944501e87ce1ea9931a890cbb"
+    },
+    {
+      "bytes": 9961323,
+      "path": "assets/overview_contact_sheet.png",
+      "sha256": "3af42bd633bd813f806ff8652a23e21b133004b012ef509656ce336914e914d0"
+    },
+    {
+      "bytes": 20793,
+      "path": "assets/quality_metrics.json",
+      "sha256": "344a9a188960ca8649ab4f85f0c28aa6da06d08b2a8f2e8fa81f2e22d756efa4"
+    },
+    {
+      "bytes": 2596,
+      "path": "manifests/conversion_summaries.json",
+      "sha256": "bfaa7cfcd14e55460cac0a63e6293ccc9bc6f25d31e2fd882d7c087f39e85bfc"
+    },
+    {
+      "bytes": 4058,
+      "path": "release_manifest.json",
+      "sha256": "c90982a897a7ebdbf1938e9c0ad1486ba095eb41ad854467bb701b317a4c7a2b"
+    },
+    {
+      "bytes": 7160,
+      "path": "scripts/compute_quality_metrics.py",
+      "sha256": "e38c568d5d2797fc6f70a0e7e2eca75e5e0a981c85652126e2ed575f55b7fa8d"
+    },
+    {
+      "bytes": 6261,
+      "path": "scripts/upload.py",
+      "sha256": "7717d9a996bdc76c80fe81b022d381b9c5720de1cd0e8cc8ed864efc405990c5"
+    },
+    {
+      "bytes": 7812,
+      "path": "scripts/verify_release.py",
+      "sha256": "b90a5074b0a4349c6cceba0461b95d3814f291b4a7309484eec03389962dac85"
+    },
+    {
+      "bytes": 1848,
+      "path": "workflows/FLUX1_Dev_ConvRot_API.json",
+      "sha256": "b369b4acd6111fbb7549724eaeebf3c3325dad244590078f1428de44f1b2ac6e"
+    }
+  ],
+  "verified_at": "2026-07-20T16:53:14+00:00"
+}

scripts/compute_quality_metrics.py

@@ -0,0 +1,187 @@
+#!/usr/bin/env python3
+"""Compute paired RGB metrics for publication candidates against Original BF16."""
+from __future__ import annotations
+
+import argparse
+import hashlib
+import json
+import math
+import os
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+import numpy as np
+from PIL import Image
+
+REFERENCE_ID = "original_bf16"
+EXPECTED_GRID_COUNT = 20
+CHUNK_BYTES = 4 * 1024 * 1024
+
+
+class MetricError(RuntimeError):
+    pass
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--grid-manifest", type=Path, required=True)
+    parser.add_argument("--output", type=Path, required=True)
+    return parser.parse_args()
+
+
+def sha256_file(path: Path) -> str:
+    digest = hashlib.sha256()
+    with path.open("rb") as handle:
+        for chunk in iter(lambda: handle.read(CHUNK_BYTES), b""):
+            digest.update(chunk)
+    return digest.hexdigest()
+
+
+def psnr(mse: float) -> float | str:
+    if mse == 0.0:
+        return "infinity"
+    return 10.0 * math.log10((255.0**2) / mse)
+
+
+def load_rgb(record: dict[str, Any]) -> np.ndarray:
+    path = Path(str(record["path"])).resolve(strict=True)
+    if path.stat().st_size != int(record["bytes"]):
+        raise MetricError(f"byte drift: {path}")
+    if sha256_file(path) != str(record["sha256"]):
+        raise MetricError(f"hash drift: {path}")
+    with Image.open(path) as image:
+        if image.size != (1024, 1024):
+            raise MetricError(f"dimension drift: {path}: {image.size}")
+        return np.asarray(image.convert("RGB"), dtype=np.float64)
+
+
+def atomic_json(path: Path, value: dict[str, Any]) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    temporary = path.with_name(f".{path.name}.{os.getpid()}.tmp")
+    temporary.write_text(
+        json.dumps(value, indent=2, sort_keys=True) + "\n", encoding="utf-8"
+    )
+    os.replace(temporary, path)
+
+
+def main() -> int:
+    args = parse_args()
+    manifest_path = args.grid_manifest.expanduser().resolve(strict=True)
+    manifest = json.loads(manifest_path.read_text(encoding="utf-8"))
+    grids = manifest.get("grids")
+    if not isinstance(grids, list) or len(grids) != EXPECTED_GRID_COUNT:
+        raise MetricError(f"expected {EXPECTED_GRID_COUNT} verified grids")
+    if manifest.get("status") != "verified" or manifest.get("profile") != "publication":
+        raise MetricError("grid manifest is not a verified publication profile")
+
+    expected_models: list[tuple[str, str]] | None = None
+    accumulators: dict[str, dict[str, Any]] = {}
+    prompt_ids: set[str] = set()
+
+    for grid in grids:
+        prompt_id = str(grid["prompt_id"])
+        if prompt_id in prompt_ids:
+            raise MetricError(f"duplicate prompt: {prompt_id}")
+        prompt_ids.add(prompt_id)
+        columns = grid.get("columns")
+        if not isinstance(columns, list):
+            raise MetricError(f"missing columns for {prompt_id}")
+        by_id = {str(column["model_id"]): column for column in columns}
+        if len(by_id) != len(columns) or REFERENCE_ID not in by_id:
+            raise MetricError(f"invalid model inventory for {prompt_id}")
+        models = [(str(column["model_id"]), str(column["label"])) for column in columns]
+        if expected_models is None:
+            expected_models = models
+            for model_id, label in models:
+                if model_id != REFERENCE_ID:
+                    accumulators[model_id] = {
+                        "label": label,
+                        "sum_abs_error": 0.0,
+                        "sum_squared_error": 0.0,
+                        "value_count": 0,
+                        "pairs": [],
+                    }
+        elif models != expected_models:
+            raise MetricError(f"column order drift for {prompt_id}")
+
+        reference = load_rgb(by_id[REFERENCE_ID])
+        for model_id, _label in models:
+            if model_id == REFERENCE_ID:
+                continue
+            candidate = load_rgb(by_id[model_id])
+            difference = candidate - reference
+            absolute_error = float(np.abs(difference).sum(dtype=np.float64))
+            squared_error = float(np.square(difference).sum(dtype=np.float64))
+            value_count = int(difference.size)
+            pair_mse = squared_error / value_count
+            accumulator = accumulators[model_id]
+            accumulator["sum_abs_error"] += absolute_error
+            accumulator["sum_squared_error"] += squared_error
+            accumulator["value_count"] += value_count
+            accumulator["pairs"].append(
+                {
+                    "prompt_id": prompt_id,
+                    "seed": int(grid["seed"]),
+                    "mae_rgb_8bit": absolute_error / value_count,
+                    "mse_rgb_8bit": pair_mse,
+                    "psnr_db": psnr(pair_mse),
+                }
+            )
+
+    if expected_models is None:
+        raise MetricError("no models found")
+
+    results: list[dict[str, Any]] = []
+    for model_id, label in expected_models:
+        if model_id == REFERENCE_ID:
+            continue
+        accumulator = accumulators[model_id]
+        value_count = int(accumulator["value_count"])
+        global_mse = float(accumulator["sum_squared_error"]) / value_count
+        global_mae = float(accumulator["sum_abs_error"]) / value_count
+        pair_scores = [float(pair["psnr_db"]) for pair in accumulator["pairs"]]
+        results.append(
+            {
+                "model_id": model_id,
+                "label": label,
+                "reference_model_id": REFERENCE_ID,
+                "pair_count": len(pair_scores),
+                "global_mae_rgb_8bit": global_mae,
+                "global_mse_rgb_8bit": global_mse,
+                "global_psnr_db": psnr(global_mse),
+                "mean_pair_psnr_db": float(np.mean(pair_scores)),
+                "median_pair_psnr_db": float(np.median(pair_scores)),
+                "min_pair_psnr_db": min(pair_scores),
+                "max_pair_psnr_db": max(pair_scores),
+                "pairs": accumulator["pairs"],
+            }
+        )
+
+    output = {
+        "schema_version": 1,
+        "status": "verified_complete",
+        "created_at": datetime.now(timezone.utc).isoformat(timespec="seconds"),
+        "source_grid_manifest_sha256": sha256_file(manifest_path),
+        "reference": {"model_id": REFERENCE_ID, "label": "Original BF16"},
+        "contract": {
+            "prompt_count": EXPECTED_GRID_COUNT,
+            "width": 1024,
+            "height": 1024,
+            "channels": "RGB",
+            "pixel_range": "8-bit [0,255]",
+            "same_prompt_seed_sampler_and_settings": True,
+        },
+        "results": results,
+        "limitations": [
+            "PSNR measures paired pixel similarity to the BF16 reference, not aesthetics or prompt adherence.",
+            "LPIPS and human-preference metrics were not computed.",
+        ],
+    }
+    atomic_json(args.output.expanduser().resolve(), output)
+    print(json.dumps({"status": output["status"], "results": results}, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

scripts/upload.py

@@ -0,0 +1,170 @@
+#!/usr/bin/env python3
+"""Dry-run by default uploader for the FLUX.1-dev ConvRot Hugging Face repo."""
+from __future__ import annotations
+
+import argparse
+import hashlib
+import json
+import os
+import subprocess
+import sys
+from pathlib import Path
+from typing import Any
+
+ROOT = Path(__file__).resolve().parents[1]
+MANIFEST_PATH = ROOT / "release_manifest.json"
+VERIFY_SCRIPT = ROOT / "scripts/verify_release.py"
+VERIFICATION_PATH = ROOT / "release_verification.json"
+CHUNK_BYTES = 16 * 1024 * 1024
+
+
+def parse_args() -> argparse.Namespace:
+    manifest = json.loads(MANIFEST_PATH.read_text(encoding="utf-8"))
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--repo-id", default=manifest["suggested_repo_id"])
+    parser.add_argument(
+        "--model-root",
+        type=Path,
+        default=Path(os.environ.get("COMFYUI_MODELS_ROOT", "/mnt/d/comfyui/models")),
+    )
+    parser.add_argument("--revision", default="main")
+    parser.add_argument("--execute", action="store_true", help="Perform network writes; default is dry-run.")
+    parser.add_argument(
+        "--create-private",
+        action="store_true",
+        help="Create a new private model repository before upload.",
+    )
+    parser.add_argument(
+        "--accept-flux-license",
+        action="store_true",
+        help="Confirm that the uploader reviewed and accepts the upstream FLUX.1-dev license.",
+    )
+    return parser.parse_args()
+
+
+def load_manifest() -> dict[str, Any]:
+    value = json.loads(MANIFEST_PATH.read_text(encoding="utf-8"))
+    if not isinstance(value, dict):
+        raise RuntimeError("release manifest must be a JSON object")
+    return value
+
+
+def sha256_file(path: Path) -> str:
+    digest = hashlib.sha256()
+    with path.open("rb") as handle:
+        for chunk in iter(lambda: handle.read(CHUNK_BYTES), b""):
+            digest.update(chunk)
+    return digest.hexdigest()
+
+
+def existing_verification_is_current(manifest: dict[str, Any], model_root: Path) -> bool:
+    if not VERIFICATION_PATH.is_file():
+        return False
+    verification = json.loads(VERIFICATION_PATH.read_text(encoding="utf-8"))
+    if verification.get("status") != "PASS" or not verification.get("model_hashes_verified"):
+        return False
+    if verification.get("artifact_total_bytes") != manifest.get("artifact_total_bytes"):
+        return False
+    support = {record["path"]: record for record in verification.get("support_files", [])}
+    for relative in manifest["required_repository_files"]:
+        record = support.get(relative)
+        path = ROOT / relative
+        if record is None or not path.is_file() or path.is_symlink():
+            return False
+        if path.stat().st_size != record["bytes"] or sha256_file(path) != record["sha256"]:
+            return False
+    verified_artifacts = {
+        record["repo_path"]: record for record in verification.get("artifacts", [])
+    }
+    verification_mtime_ns = VERIFICATION_PATH.stat().st_mtime_ns
+    for artifact in manifest["artifacts"]:
+        record = verified_artifacts.get(artifact["repo_path"])
+        source = model_root / artifact["source_relative_path"]
+        if record is None or not record.get("hash_verified") or not source.is_file():
+            return False
+        if record.get("sha256") != artifact["sha256"]:
+            return False
+        if source.stat().st_size != artifact["bytes"] or source.stat().st_mtime_ns > verification_mtime_ns:
+            return False
+    return True
+
+
+def main() -> int:
+    args = parse_args()
+    manifest = load_manifest()
+    model_root = args.model_root.expanduser().resolve(strict=True)
+    plan = {
+        "mode": "execute" if args.execute else "dry-run",
+        "repo_id": args.repo_id,
+        "revision": args.revision,
+        "create_private": args.create_private,
+        "support_root": str(ROOT),
+        "artifact_total_bytes": manifest["artifact_total_bytes"],
+        "artifacts": [
+            {
+                "source": str(model_root / artifact["source_relative_path"]),
+                "repo_path": artifact["repo_path"],
+                "bytes": artifact["bytes"],
+                "sha256": artifact["sha256"],
+            }
+            for artifact in manifest["artifacts"]
+        ],
+    }
+    print(json.dumps(plan, indent=2))
+    if not args.execute:
+        print("DRY RUN: no repository was created and no files were uploaded.")
+        return 0
+    if not args.accept_flux_license:
+        raise SystemExit("Refusing upload: pass --accept-flux-license after reviewing LICENSE_NOTICE.md")
+
+    if existing_verification_is_current(manifest, model_root):
+        print("Reusing current full-hash release_verification.json")
+    else:
+        subprocess.run(
+            [sys.executable, str(VERIFY_SCRIPT), "--model-root", str(model_root), "--models"],
+            check=True,
+        )
+
+    from huggingface_hub import HfApi
+
+    api = HfApi()
+    if args.create_private:
+        api.create_repo(repo_id=args.repo_id, repo_type="model", private=True, exist_ok=False)
+
+    support_paths = [
+        ".gitattributes",
+        "LICENSE_NOTICE.md",
+        "README.md",
+        "assets/*",
+        "manifests/*",
+        "release_manifest.json",
+        "release_verification.json",
+        "scripts/*",
+        "workflows/*",
+    ]
+    api.upload_folder(
+        repo_id=args.repo_id,
+        repo_type="model",
+        folder_path=str(ROOT),
+        path_in_repo=".",
+        revision=args.revision,
+        allow_patterns=support_paths,
+        commit_message="Add model card, workflows, and verified release evidence",
+    )
+    for artifact in manifest["artifacts"]:
+        source = model_root / artifact["source_relative_path"]
+        api.upload_file(
+            repo_id=args.repo_id,
+            repo_type="model",
+            path_or_fileobj=str(source),
+            path_in_repo=artifact["repo_path"],
+            revision=args.revision,
+            commit_message=f"Add {artifact['repo_path']}",
+        )
+    print(f"Upload complete: https://huggingface.co/{args.repo_id}")
+    print("If publication is intended, configure gating and review visibility in Hugging Face settings before making the repository public.")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

scripts/verify_release.py

@@ -0,0 +1,192 @@
+#!/usr/bin/env python3
+"""Verify the local FLUX.1-dev ConvRot Hugging Face release package."""
+from __future__ import annotations
+
+import argparse
+import hashlib
+import json
+import math
+import os
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+CHUNK_BYTES = 16 * 1024 * 1024
+ROOT = Path(__file__).resolve().parents[1]
+MANIFEST_PATH = ROOT / "release_manifest.json"
+OUTPUT_PATH = ROOT / "release_verification.json"
+
+
+class VerificationError(RuntimeError):
+    pass
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument(
+        "--model-root",
+        type=Path,
+        default=Path(os.environ.get("COMFYUI_MODELS_ROOT", "/mnt/d/comfyui/models")),
+    )
+    parser.add_argument(
+        "--models",
+        action="store_true",
+        help="Hash all four model artifacts; required before upload.",
+    )
+    return parser.parse_args()
+
+
+def sha256_file(path: Path) -> str:
+    digest = hashlib.sha256()
+    with path.open("rb") as handle:
+        for chunk in iter(lambda: handle.read(CHUNK_BYTES), b""):
+            digest.update(chunk)
+    return digest.hexdigest()
+
+
+def load_json(path: Path) -> dict[str, Any]:
+    value = json.loads(path.read_text(encoding="utf-8"))
+    if not isinstance(value, dict):
+        raise VerificationError(f"expected JSON object: {path}")
+    return value
+
+
+def require(condition: bool, message: str) -> None:
+    if not condition:
+        raise VerificationError(message)
+
+
+def verify_regular_file(path: Path) -> None:
+    require(path.exists(), f"missing file: {path}")
+    require(path.is_file(), f"not a regular file: {path}")
+    require(not path.is_symlink(), f"symlink is not allowed: {path}")
+
+
+def main() -> int:
+    args = parse_args()
+    manifest = load_json(MANIFEST_PATH)
+    require(manifest.get("status") == "ready_for_local_verification", "release status drift")
+    require(manifest.get("remote_status") == "not_created", "unexpected remote-status claim")
+    required = manifest.get("required_repository_files")
+    artifacts = manifest.get("artifacts")
+    if not isinstance(required, list):
+        raise VerificationError("missing required_repository_files")
+    if not isinstance(artifacts, list) or len(artifacts) != 4:
+        raise VerificationError("expected four artifacts")
+
+    support_records: list[dict[str, Any]] = []
+    for relative in required:
+        path = ROOT / str(relative)
+        verify_regular_file(path)
+        support_records.append(
+            {
+                "path": str(relative),
+                "bytes": path.stat().st_size,
+                "sha256": sha256_file(path),
+            }
+        )
+
+    unexpected_models = sorted(str(path.relative_to(ROOT)) for path in ROOT.rglob("*.safetensors"))
+    require(not unexpected_models, f"model files must not be duplicated into staging: {unexpected_models}")
+
+    readme = (ROOT / "README.md").read_text(encoding="utf-8")
+    for marker in (
+        "license: other",
+        "license_name: flux-1-dev-non-commercial-license",
+        "base_model: black-forest-labs/FLUX.1-dev",
+        "base_model_relation: quantized",
+        "pipeline_tag: text-to-image",
+        "FLUX.1-dev ConvRot for ComfyUI",
+    ):
+        require(marker in readme, f"model-card marker missing: {marker}")
+
+    workflow = load_json(ROOT / "workflows/FLUX1_Dev_ConvRot_API.json")
+    require(workflow["1"]["class_type"] == "UNETLoader", "workflow loader drift")
+    require(
+        workflow["1"]["inputs"]["unet_name"] == "FLUX.1-dev-w8a8-convrot.safetensors",
+        "workflow DiT default drift",
+    )
+    require(
+        workflow["2"]["inputs"]["clip_name2"] == "t5xxl_flux1_int8_convrot.safetensors",
+        "workflow T5 default drift",
+    )
+
+    evidence = manifest["evidence"]
+    overview = ROOT / evidence["overview_contact_sheet"]["repo_path"]
+    require(overview.stat().st_size == evidence["overview_contact_sheet"]["bytes"], "overview byte drift")
+    require(sha256_file(overview) == evidence["overview_contact_sheet"]["sha256"], "overview hash drift")
+
+    quality = load_json(ROOT / "assets/quality_metrics.json")
+    require(quality.get("status") == "verified_complete", "quality evidence status drift")
+    require(
+        quality.get("source_grid_manifest_sha256") == evidence["source_grid_manifest_sha256"],
+        "quality source-manifest drift",
+    )
+    results = quality.get("results")
+    if not isinstance(results, list) or len(results) != 4:
+        raise VerificationError("quality result inventory drift")
+    measured = {str(item["model_id"]): float(item["global_psnr_db"]) for item in results}
+    for model_id, expected in evidence["quality_global_psnr_db"].items():
+        require(model_id in measured, f"missing quality result: {model_id}")
+        require(math.isclose(measured[model_id], float(expected), rel_tol=0.0, abs_tol=1e-12), f"quality drift: {model_id}")
+
+    model_root = args.model_root.expanduser().resolve(strict=True)
+    artifact_records: list[dict[str, Any]] = []
+    total_bytes = 0
+    repo_paths: set[str] = set()
+    for artifact in artifacts:
+        repo_path = str(artifact["repo_path"])
+        require(repo_path not in repo_paths, f"duplicate repo path: {repo_path}")
+        repo_paths.add(repo_path)
+        source = (model_root / str(artifact["source_relative_path"])).resolve(strict=True)
+        require(source.is_file(), f"artifact is not a file: {source}")
+        actual_bytes = source.stat().st_size
+        require(actual_bytes == int(artifact["bytes"]), f"artifact byte drift: {source}")
+        total_bytes += actual_bytes
+        actual_hash = None
+        if args.models:
+            actual_hash = sha256_file(source)
+            require(actual_hash == str(artifact["sha256"]), f"artifact hash drift: {source}")
+        source_manifest_relative = artifact.get("source_manifest_relative_path")
+        if source_manifest_relative is not None:
+            source_manifest = (model_root / str(source_manifest_relative)).resolve(strict=True)
+            verify_regular_file(source_manifest)
+            require(
+                sha256_file(source_manifest) == str(artifact["source_manifest_sha256"]),
+                f"source conversion-manifest drift: {source_manifest}",
+            )
+        artifact_records.append(
+            {
+                "repo_path": repo_path,
+                "source_relative_path": str(artifact["source_relative_path"]),
+                "bytes": actual_bytes,
+                "sha256": actual_hash if actual_hash is not None else str(artifact["sha256"]),
+                "hash_verified": bool(args.models),
+            }
+        )
+
+    require(total_bytes == int(manifest["artifact_total_bytes"]), "artifact total-byte drift")
+    result = {
+        "schema_version": 1,
+        "status": "PASS",
+        "verified_at": datetime.now(timezone.utc).isoformat(timespec="seconds"),
+        "suggested_repo_id": manifest["suggested_repo_id"],
+        "remote_status": manifest["remote_status"],
+        "model_hashes_verified": bool(args.models),
+        "artifact_count": len(artifact_records),
+        "artifact_total_bytes": total_bytes,
+        "artifacts": artifact_records,
+        "support_file_count": len(support_records),
+        "support_files": support_records,
+        "overview_sha256": evidence["overview_contact_sheet"]["sha256"],
+        "quality_source_grid_manifest_sha256": evidence["source_grid_manifest_sha256"],
+    }
+    temporary = OUTPUT_PATH.with_name(f".{OUTPUT_PATH.name}.{os.getpid()}.tmp")
+    temporary.write_text(json.dumps(result, indent=2, sort_keys=True) + "\n", encoding="utf-8")
+    os.replace(temporary, OUTPUT_PATH)
+    print(json.dumps(result, indent=2, sort_keys=True))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

workflows/FLUX1_Dev_ConvRot_API.json

@@ -0,0 +1,87 @@
+{
+  "1": {
+    "class_type": "UNETLoader",
+    "inputs": {
+      "unet_name": "FLUX.1-dev-w8a8-convrot.safetensors",
+      "weight_dtype": "default"
+    },
+    "_meta": {
+      "title": "FLUX.1-dev Whole W8A8 ConvRot"
+    }
+  },
+  "2": {
+    "class_type": "DualCLIPLoader",
+    "inputs": {
+      "clip_name1": "clip_l_flux1.safetensors",
+      "clip_name2": "t5xxl_flux1_int8_convrot.safetensors",
+      "type": "flux",
+      "device": "default"
+    },
+    "_meta": {
+      "title": "FLUX CLIP-L + INT8 ConvRot T5-XXL"
+    }
+  },
+  "3": {
+    "class_type": "VAELoader",
+    "inputs": {
+      "vae_name": "ae_flux1.safetensors"
+    }
+  },
+  "4": {
+    "class_type": "CLIPTextEncode",
+    "inputs": {
+      "clip": ["2", 0],
+      "text": "A cinematic photograph of a futuristic city at sunrise, atmospheric light, intricate architecture, realistic materials, highly detailed"
+    }
+  },
+  "5": {
+    "class_type": "FluxGuidance",
+    "inputs": {
+      "conditioning": ["4", 0],
+      "guidance": 3.5
+    }
+  },
+  "6": {
+    "class_type": "ConditioningZeroOut",
+    "inputs": {
+      "conditioning": ["4", 0]
+    }
+  },
+  "7": {
+    "class_type": "EmptySD3LatentImage",
+    "inputs": {
+      "width": 1024,
+      "height": 1024,
+      "batch_size": 1
+    }
+  },
+  "8": {
+    "class_type": "KSampler",
+    "inputs": {
+      "model": ["1", 0],
+      "seed": 2737473617249173572,
+      "steps": 20,
+      "cfg": 1.0,
+      "sampler_name": "euler",
+      "scheduler": "simple",
+      "positive": ["5", 0],
+      "negative": ["6", 0],
+      "latent_image": ["7", 0],
+      "denoise": 1.0
+    }
+  },
+  "9": {
+    "class_type": "VAEDecode",
+    "inputs": {
+      "samples": ["8", 0],
+      "vae": ["3", 0]
+    }
+  },
+  "10": {
+    "class_type": "SaveImage",
+    "inputs": {
+      "images": ["9", 0],
+      "filename_prefix": "FLUX1-dev-ConvRot"
+    }
+  }
+}