RUDRA ACES 2 and AI fill v3 (Apache 2.0)

README.md

@@ -1,7 +1,6 @@
 ---
 license: apache-2.0
 library_name: rudra
-inference: false
 pipeline_tag: image-to-image
 base_model:
   - Wan-AI/Wan2.1-VACE-1.3B-diffusers
@@ -23,12 +22,12 @@ commercial use permitted.**
 
 | Folder | What it is | Size |
 |---|---|---|
-| [`models/RUDRA_ACES_2/`](models/RUDRA_ACES_2) | **RUDRA ACES 2**: the learned ACES 2.0 reconstruction. 8-bit SDR in, an ACEScg master out, whose ACES 2.0 SDR view keeps the source's 8-bit codes. Ships as TorchScript and ONNX (DirectML, Core ML or CPU). | 2.2 MB |
+| [`models/RUDRA_ACES_2/`](models/RUDRA_ACES_2) | **RUDRA ACES 2**: the learned ACES 2.0 reconstruction. 8-bit SDR in, an ACEScg master out, whose ACES 2.0 SDR view keeps the source's 8-bit codes. Ships as TorchScript and ONNX (DirectML/CPU). | 2.2 MB |
 | [`models/rudra_genfill_v3/`](models/rudra_genfill_v3) | **RUDRA AI fill v3**: a LoRA for Wan2.1-VACE-1.3B that draws the *shape* inside fully clipped highlights, and a small brightness estimator (`brightness.json`) that sets *how bright* they are. | 271 MB |
 
 ## Use
 
-**In the RUDRA app** (Windows and macOS):
+**In the RUDRA app** (Windows; macOS builds are unsigned for now):
 
 - **RUDRA ACES 2:** File › Model packages, or Look › Download the model. Every
   file is checked against its SHA-256 before it is used.
@@ -36,8 +35,8 @@ commercial use permitted.**
   this LoRA and `brightness.json`. It also needs:
   - the base model [Wan2.1-VACE-1.3B-diffusers](https://huggingface.co/Wan-AI/Wan2.1-VACE-1.3B-diffusers)
     (set its folder in Deliver › AI fill › Setup…, or put it in `<RUDRA folder>/models/genfill/`);
-  - Python (`scripts\GENFILL.ps1 -Setup` on Windows, `scripts/genfill_setup.sh` on a Mac);
-  - a 16 GB GPU (on a Mac, 16 GB of memory or more: it runs on Metal).
+  - Python (`scripts\GENFILL.ps1 -Setup`);
+  - a 16 GB GPU.
 
   Then use Deliver › AI fill.
 
@@ -52,6 +51,21 @@ python -m rudra.genfill.run --master <EXR folder> --out <new folder> \
 `run.py` loads `brightness.json` from the LoRA's folder by default. Add
 `--brightness-offset <stops>` to shift the brightness (±3).
 
+## RUDRA ACES 2: what it guarantees, and its evidence
+
+- **Codes kept:** the master's ACES 2.0 SDR 100-nit view gives back the
+  source's 8-bit codes within 1 code, fully clipped pixels included.
+- **2.0 (w4 + lock):** in partially clipped highlights the channels the camera
+  recorded are held to the source (the lock), and only the clipped channel is
+  rebuilt. Needs RUDRA 1.2.0 or later; older apps refuse the package.
+- **Held-out test** (The Crew, ARRI ALEXA LogC3, 56 cases from 18 scenes,
+  registered before it was run, run once): better than the plain ACES 2.0
+  inverse at −3 EV and +3 EV and in highlight colour; at the delivered
+  exposure **within 0.1 code RMS of it, not better** (0.311 against 0.242).
+  One production and one camera: a result on that footage, not on all footage.
+- **Rebuilt highlights are estimates**, marked in the `rudra.reconstructed`
+  EXR channel. Not camera RAW.
+
 ## What the AI fill guarantees
 
 - **Codes kept:** no 8-bit code of the master's ACES 2.0 SDR 100-nit view

models/RUDRA_ACES_2/manifest.json

@@ -1,108 +1,162 @@
-{
-  "name": "RUDRA_ACES_2",
-  "title": "RUDRA ACES 2",
-  "source_package": "aces_v2_partial_pcgrad_duration6400_retry1_20261025",
-  "contract": "rudra_native_aces_v2_staged",
-  "contract_major": 2,
-  "model_contract": {
-    "id": "aces2_ap1_reconstruction_v9_full_context_experimental",
-    "config": "cg-config-v4.0.0_aces-v2.0_ocio-v2.5",
-    "display": "Rec.1886 Rec.709 - Display",
-    "view": "ACES 2.0 - SDR 100 nits (Rec.709)",
-    "working_space": "ACEScg",
-    "ocio_version": "2.5.2",
-    "config_sha256": "24ec81841048fc5db160a7bad882263246183385c5d49d0e86e11464917ead15",
-    "input": "Rec709 Rec1886 display RGB codes",
-    "output": "ACEScg linear",
-    "source_code_bound": 0.0019215686274509803,
-    "reconstruction_policy": "observed_clip_v1",
-    "residual": "signed_linear_shared_rgb_scale",
-    "residual_scale_floor": 0.001,
-    "radiance_clamp": false,
-    "scene_exposure_recovered": false,
-    "release_authorized": false,
-    "normalization": "pixel_rms",
-    "restoration": "local_codes",
-    "restoration_support": "source reconstruction_weight == 0",
-    "restoration_context_kernels": [
-      5,
-      17,
-      65
-    ],
-    "shadow": "analytic",
-    "shadow_support": "source reconstruction_weight > 0 and max source <= .5",
-    "shadow_output": "w*exact source inverse + (1-w)*exact inverse of bounded restored source",
-    "shadow_reconstructed": false,
-    "shadow_reason": "5-seed study 24 Oct 2026: no trained shadow branch reliably beat the analytic inverse",
-    "highlight_context": "independent_pixel_rms",
-    "highlight_support": "source reconstruction_weight>0 and max source>.5",
-    "frozen_parent_fields": true,
-    "temporal_inference": false,
-    "temporal_training": "known subpixel planar-motion residual consistency; no recurrent inference",
-    "full_context": "independent_pixel_rms",
-    "full_support": "reconstruction_weight>0 and min source>=254.5/255",
-    "full_transition": "hard source support; boundary and temporal qualification required"
-  },
-  "checkpoint_sha256": "f73f14c7e74d5bb54d0cbf949b94365f2eeb12a3cc50ed3ea45d1ad1b163256e",
-  "g1_sha256": "fb30e3df748f4fa9ae17f7db189c8fe49a58d9863af6c1c45a408a72f3b7a59b",
-  "g1_file": "rudra_g1.ts",
-  "g1_inputs": [
-    "source BCHW float32 display codes [0,1] Rec709 Rec1886",
-    "baseline BCHW float32 ACEScg = OCIO inverse(source)"
-  ],
-  "g1_outputs": [
-    "restored_source B3HW",
-    "highlight_fields B3HW",
-    "full_fields B3HW",
-    "weight B1HW"
-  ],
-  "ocio": {
-    "ocio_version": "2.5.2",
-    "config": "cg-config-v4.0.0_aces-v2.0_ocio-v2.5",
-    "view": "ACES 2.0 - SDR 100 nits (Rec.709)",
-    "display": "Rec.1886 Rec.709 - Display"
-  },
-  "stages": [
-    "inverse_view(source)->baseline",
-    "G1",
-    "inverse_view(restored_source)->restored",
-    "compose",
-    "clipped_smoothing",
-    "appearance_constraint(include_fully_clipped)",
-    "mask"
-  ],
-  "compose": {
-    "scale": "max_c|restored|+0.001",
-    "high": "w>0 & max(src)>0.5",
-    "full": "w>0 & min(src)>=254.5/255",
-    "shadow": "w>0 & max(src)<=0.5 -> w>=1 ? baseline : w*baseline+(1-w)*restored",
-    "else": "restored"
-  },
-  "clipped_smoothing": {
-    "name": "hybrid64",
-    "sigma": 64.0,
-    "ramp": 1.0,
-    "start": 0.0,
-    "mode": "hybrid",
-    "erode": "cross 3x3 x2, border 0",
-    "components": 8,
-    "gaussian": "k=int(4*sigma)|1, BORDER_REFLECT_101"
-  },
-  "appearance_constraint": {
-    "max_display_error_codes": 1,
-    "include_fully_clipped": true,
-    "method": "halving backtrack toward baseline",
-    "forbid_new_negative_y": true
-  },
-  "onnx_file": "rudra_g1.onnx",
-  "onnx_sha256": "8ba97cb0ed36f5033958e752afad95d585d50bcefefc3bc66a61b27a6618f237",
-  "onnx_tolerance": {
-    "final_max_display_code_diff": 0.10628391802310944,
-    "final_max_rel": 0.0007460270426236093,
-    "mask_exact": true,
-    "limit_display_codes": 0.25,
-    "limit_rel": 0.005
-  },
-  "parity_pass": true,
-  "release_authorized": true
-}
+{
+  "name": "RUDRA_ACES_2_w4",
+  "title": "RUDRA ACES 2",
+  "contract": "rudra_native_aces_v2_staged",
+  "contract_major": 3,
+  "model_contract": {
+    "id": "aces2_ap1_reconstruction_v9_full_context_experimental",
+    "config": "cg-config-v4.0.0_aces-v2.0_ocio-v2.5",
+    "display": "Rec.1886 Rec.709 - Display",
+    "view": "ACES 2.0 - SDR 100 nits (Rec.709)",
+    "working_space": "ACEScg",
+    "ocio_version": "2.5.2",
+    "config_sha256": "24ec81841048fc5db160a7bad882263246183385c5d49d0e86e11464917ead15",
+    "input": "Rec709 Rec1886 display RGB codes",
+    "output": "ACEScg linear",
+    "source_code_bound": 0.0019215686274509803,
+    "reconstruction_policy": "observed_clip_v1",
+    "residual": "signed_linear_shared_rgb_scale",
+    "residual_scale_floor": 0.001,
+    "radiance_clamp": false,
+    "scene_exposure_recovered": false,
+    "release_authorized": false,
+    "normalization": "pixel_rms",
+    "restoration": "local_codes",
+    "restoration_support": "source reconstruction_weight == 0",
+    "restoration_context_kernels": [
+      5,
+      17,
+      65
+    ],
+    "shadow": "analytic",
+    "shadow_support": "source reconstruction_weight > 0 and max source <= .5",
+    "shadow_output": "w*exact source inverse + (1-w)*exact inverse of bounded restored source",
+    "shadow_reconstructed": false,
+    "shadow_reason": "5-seed study 24 Oct 2026: no trained shadow branch reliably beat the analytic inverse",
+    "highlight_context": "independent_pixel_rms",
+    "highlight_support": "source reconstruction_weight>0 and max source>.5",
+    "frozen_parent_fields": true,
+    "temporal_inference": false,
+    "temporal_training": "known subpixel planar-motion residual consistency; no recurrent inference",
+    "full_context": "independent_pixel_rms",
+    "full_support": "reconstruction_weight>0 and min source>=254.5/255",
+    "full_transition": "hard source support; boundary and temporal qualification required"
+  },
+  "checkpoint_sha256": "b9a903a58dccfcd2e1d2aa15b7d01d33cf0858dacb09cbe5910df05998f2825f",
+  "g1_sha256": "7082eb869d265d6e8c4fc209f7cac7e5dce2f40c10df5e73a889fb85efb9dbcc",
+  "g1_file": "rudra_g1.ts",
+  "g1_inputs": [
+    "source BCHW float32 display codes [0,1] Rec709 Rec1886",
+    "baseline BCHW float32 ACEScg = OCIO inverse(source)"
+  ],
+  "g1_outputs": [
+    "restored_source B3HW",
+    "highlight_fields B3HW",
+    "full_fields B3HW",
+    "weight B1HW"
+  ],
+  "ocio": {
+    "ocio_version": "2.5.2",
+    "config": "cg-config-v4.0.0_aces-v2.0_ocio-v2.5",
+    "view": "ACES 2.0 - SDR 100 nits (Rec.709)",
+    "display": "Rec.1886 Rec.709 - Display"
+  },
+  "stages": [
+    "inverse_view(source)->baseline",
+    "G1",
+    "inverse_view(restored_source)->restored",
+    "compose",
+    "clipped_smoothing",
+    "appearance_constraint(include_fully_clipped)",
+    "lock",
+    "mask"
+  ],
+  "compose": {
+    "scale": "max_c|restored|+0.001",
+    "high": "w>0 & max(src)>0.5",
+    "full": "w>0 & min(src)>=254.5/255",
+    "shadow": "w>0 & max(src)<=0.5 -> w>=1 ? baseline : w*baseline+(1-w)*restored",
+    "else": "restored"
+  },
+  "clipped_smoothing": {
+    "name": "hybrid64",
+    "sigma": 64.0,
+    "ramp": 1.0,
+    "start": 0.0,
+    "mode": "hybrid",
+    "erode": "cross 3x3 x2, border 0",
+    "components": 8,
+    "gaussian": "k=int(4*sigma)|1, BORDER_REFLECT_101"
+  },
+  "appearance_constraint": {
+    "max_display_error_codes": 1,
+    "include_fully_clipped": true,
+    "method": "halving backtrack toward baseline",
+    "forbid_new_negative_y": true
+  },
+  "onnx_file": "rudra_g1.onnx",
+  "onnx_sha256": "880e7b698a099b8dd60549444392d51af3022efbae8f68f05c9f0f3a29f8ee49",
+  "onnx_tolerance": {
+    "final_max_display_code_diff": 0.10628391872160137,
+    "final_max_rel": 0.018843110650777817,
+    "mask_exact": true,
+    "limit_display_codes": 0.25,
+    "limit_rel": 0.005,
+    "rel_fraction_limit": 0.001,
+    "pixels_rel_over_limit": 1,
+    "per_probe_rel_over_limit": [
+      0,
+      0,
+      1
+    ],
+    "locked": {
+      "p999_display_code_diff": 0.014085752964021859,
+      "max_display_code_diff": 0.7523596286773682,
+      "max_rel": 0.3374467194080353,
+      "pixels_over_limit": 3,
+      "pixels": 1855488,
+      "limit_p999_codes": 0.25,
+      "limit_max_codes": 1.0,
+      "pixels_rel_over_limit": 26,
+      "pass": true
+    },
+    "locked_per_probe_rel_over_limit": [
+      21,
+      0,
+      5
+    ]
+  },
+  "lock": {
+    "name": "lock_dqs050g",
+    "mode": "lock",
+    "strength": 0.5,
+    "target": "dequant",
+    "iters": 4,
+    "band_codes": 0.0,
+    "dq_iters": 200,
+    "dq_max_lap": 1.5,
+    "registration": "configs/experiments/holdout_crew_eval_20261107.json",
+    "registration_sha256": "a7271ad62db39ec0af97085bfd39cabfdf5d379cd93f65d0fed36551c69ac106"
+  },
+  "provenance": {
+    "model": "RUDRA ACES 2",
+    "version": "2.0",
+    "checkpoint": {
+      "run": "research_bin_hinge_w4_20261102",
+      "step": 1600,
+      "sha256": "b9a903a58dccfcd2e1d2aa15b7d01d33cf0858dacb09cbe5910df05998f2825f"
+    },
+    "lock": "lock_dqs050g",
+    "holdout": {
+      "registration": "configs\\experiments\\holdout_crew_eval_20261107.json",
+      "registration_sha256": "a7271ad62db39ec0af97085bfd39cabfdf5d379cd93f65d0fed36551c69ac106",
+      "verdict_sha256": "c6710884e187a2367050b3339e41cf6393fea7cdea85e5f7e00a334bc8cf7034",
+      "result": "docs/competitive/RESULT_CREW_HOLDOUT_2026_11_07.md",
+      "cases": 56,
+      "scenes": 18
+    },
+    "limits": "One production (The Crew), one camera (ARRI ALEXA LogC3), single frames."
+  },
+  "parity_pass": true,
+  "release_authorized": false
+}

models/RUDRA_ACES_2/parity.json

@@ -35,8 +35,8 @@
   }
  ],
  "onnx": {
-  "final_max_display_code_diff": 0.10628391802310944,
-  "final_max_rel": 0.0007460270426236093,
+  "final_max_display_code_diff": 0.10628391872160137,
+  "final_max_rel": 0.018843110650777817,
   "mask_exact": true,
   "limit_display_codes": 0.25,
   "limit_rel": 0.005,
@@ -48,8 +48,12 @@
      128,
      3
     ],
-    "max_display_code_diff": 0.10628391802310944,
-    "max_rel": 0.0003397462423890829,
+    "max_display_code_diff": 0.10628391872160137,
+    "p999_display_code_diff": 0.0014061886444687933,
+    "pixels_over_limit": 0,
+    "pixels": 12288,
+    "max_rel": 6.0725302319042385e-05,
+    "pixels_rel_over_limit": 0,
     "mask_exact": true
    },
    {
@@ -58,8 +62,12 @@
      1280,
      3
     ],
-    "max_display_code_diff": 0.0005167722702026367,
+    "max_display_code_diff": 0.0015503168106079102,
+    "p999_display_code_diff": 0.00021278858184814453,
+    "pixels_over_limit": 0,
+    "pixels": 921600,
     "max_rel": 0.00022069606347940862,
+    "pixels_rel_over_limit": 0,
     "mask_exact": true
    },
    {
@@ -68,11 +76,72 @@
      1280,
      3
     ],
-    "max_display_code_diff": 0.0005927681922912598,
-    "max_rel": 0.0007460270426236093,
+    "max_display_code_diff": 0.0016415119171142578,
+    "p999_display_code_diff": 0.00025838613510131836,
+    "pixels_over_limit": 0,
+    "pixels": 921600,
+    "max_rel": 0.018843110650777817,
+    "pixels_rel_over_limit": 1,
     "mask_exact": true
    }
   ],
-  "pass": true
+  "rel_fraction_limit": 0.001,
+  "pixels_rel_over_limit": 1,
+  "pass": true,
+  "locked": {
+   "p999_display_code_diff": 0.014085752964021859,
+   "max_display_code_diff": 0.7523596286773682,
+   "max_rel": 0.3374467194080353,
+   "pixels_over_limit": 3,
+   "pixels": 1855488,
+   "limit_p999_codes": 0.25,
+   "limit_max_codes": 1.0,
+   "probes": [
+    {
+     "shape": [
+      96,
+      128,
+      3
+     ],
+     "max_display_code_diff": 0.7523596286773682,
+     "p999_display_code_diff": 0.014085752964021859,
+     "pixels_over_limit": 3,
+     "pixels": 12288,
+     "max_rel": 0.3374467194080353,
+     "pixels_rel_over_limit": 21,
+     "mask_exact": true
+    },
+    {
+     "shape": [
+      720,
+      1280,
+      3
+     ],
+     "max_display_code_diff": 0.0015503168106079102,
+     "p999_display_code_diff": 0.00021278858184814453,
+     "pixels_over_limit": 0,
+     "pixels": 921600,
+     "max_rel": 0.0007740037399344146,
+     "pixels_rel_over_limit": 0,
+     "mask_exact": true
+    },
+    {
+     "shape": [
+      720,
+      1280,
+      3
+     ],
+     "max_display_code_diff": 0.013907253742218018,
+     "p999_display_code_diff": 0.00025838613510131836,
+     "pixels_over_limit": 0,
+     "pixels": 921600,
+     "max_rel": 0.018843110650777817,
+     "pixels_rel_over_limit": 5,
+     "mask_exact": true
+    }
+   ],
+   "pixels_rel_over_limit": 26,
+   "pass": true
+  }
  }
 }

models/RUDRA_ACES_2/rudra_g1.onnx

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:8ba97cb0ed36f5033958e752afad95d585d50bcefefc3bc66a61b27a6618f237
+oid sha256:880e7b698a099b8dd60549444392d51af3022efbae8f68f05c9f0f3a29f8ee49
 size 1157294

models/RUDRA_ACES_2/rudra_g1.ts

@@ -1,3 +1,3 @@
 version https://git-lfs.github.com/spec/v1
-oid sha256:fb30e3df748f4fa9ae17f7db189c8fe49a58d9863af6c1c45a408a72f3b7a59b
+oid sha256:7082eb869d265d6e8c4fc209f7cac7e5dce2f40c10df5e73a889fb85efb9dbcc
 size 1037772

models/rudra_genfill_v3/prompt_cache/19805c5814225ef6a3c96bad.json

@@ -0,0 +1 @@
+{"text": "clear sky with soft clouds over the sea, distant coastline", "tokens": 14}

models/rudra_genfill_v3/prompt_cache/19805c5814225ef6a3c96bad.pt

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:a25186b90f16ad0ae397e72bd748a8150ebbfbcedc107057605e64245d36f243
+size 8390432