RelayVSR X4: int8 / W6A8 / W4A8 Wan quants for ComfyUI
Pre-quantized Wan checkpoints for RelayVSR's original 4x model (kopper/RelayVSR),
so it runs on 16 GB and 24 GB cards at full H3 resolution (1280x704 in, 2560x1408 out), and faster than full precision.
They are made for the RelayVSR nodes in ComfyUI-MAINodes
(relayvsr/README.md), which run RelayVSR through
LightX2V in its own Python.
Where the originals live: RelayVSR is by kopperx. Code, paper, project page and demo are on
github.com/kopperx/RelayVSR; its "Model Weights" link is
kopper/RelayVSR, which holds the original X4 wan.safetensors and
flash.safetensors without a model card of its own. lightx2v/RelayVSR_X2
is the LightX2V team's separate native-2x retrain, not the source of these files.
Use the X4 model even for 2x output: it computes at 4x and resizes, and on our clips it was clearly better than the native X2 model.
Pick by card
Download one Wan file plus flash.safetensors into ComfyUI/models/relayvsr/RelayVSR/. On the
RelayVSR • X2 / X4 Settings node set variant = X4, output_scale = 2, execution_mode = single GPU, and vram =
the matching tier (or auto, which picks the best tier your card fits from the files present).
| card | Wan file | size | vram tier |
peak VRAM | time per 3 s clip | drift from full precision |
|---|---|---|---|---|---|---|
| 32 GB | wan.safetensors from kopper/RelayVSR |
10.1 GB | full precision, with Wan block offload | 27.9 GB | 28.4 s | — |
| 24 GB+ | wan_int8_convrot.safetensors |
5.2 GB | 24 GB+: int8 ConvRot weights + int8 KV | 21.8 GB | 22.0 s | 53.1 dB |
| 16 GB | wan_w6a8.safetensors |
4.2 GB | 16 GB: W6A8 weights + int4 KV | fits a 13.5 GiB cap | 23.0 s | 47.0 dB |
| 16 GB, more room | wan_w4a8.safetensors |
3.0 GB | 16 GB, most headroom: W4A8 weights + int4 KV | fits a 13.0 GiB cap | 22.8 s | 44.3 dB |
Measured on one RTX 5090: a 3 s (73-frame) MiniMax-H3 clip, 1280x704 -> 2560x1408, the node's default faithful quality
preset, no offload for the quantized tiers. "Peak" is nvidia-smi. The 16 GB tiers ran under a PyTorch memory cap that
leaves room for the CUDA context and a desktop on a 16 GB card. Drift is PSNR between the frames and the full-precision
output; above ~45 dB the difference is invisible. On five 3 s clips scored against ground truth (2x from half
resolution), every tier scored the same as full precision (35.9-36.0 dB overall, 34.3-34.5 dB on a mustache crop).
Memory is set by resolution, not clip length: most of it is Wan's key/value cache over four keyframes (19.6 GiB in bf16 at this size), which the tiers store as Hadamard-rotated int8 / int4 at run time. That is why smaller weights alone would not take a 12 GB card to this resolution.
Pixels
Frame 36 of the test clip, 1:1 crops of the 2560x1408 outputs (top: the input upscaled with plain Lanczos).
Mustache, 2x nearest-neighbour zoom
Mustache, 1:1
Shelf, 1:1
Full frame (full precision, shown at half size)
What's in the files
The 300 linear layers of Wan's 30 blocks are quantized with comfy-kitchen
0.2.40; everything else (norms, biases, modulation tables, input and output layers) is unchanged bf16, and the original
checkpoint metadata is kept, plus a relayvsr_quant entry.
wan_int8_convrot: W8A8 ConvRot (256-wide Hadamard groups, per-channel int8 weights, int8 activations).wan_w6a8/wan_w4a8: comfy-kitchen grouped W6A8 / W4A8 (6- / 4-bit weights, int8 activations).flash.safetensors: RelayVSR's Flash model, byte-identical to kopper/RelayVSR (re-hosted so one repo has a full set).
Made from wan.safetensors (sha256 638acb6a...2eb98) with relayvsr/tools/quantize_wan.py in ComfyUI-MAINodes.
Checksums: SHA256SUMS. The files load only through the MAINodes RelayVSR worker (the quantized tensors
are not in LightX2V's own quant layout).
Credits and license
RelayVSR by kopperx (GitHub: code, paper links, project page, demo, paper, project page, original weights), built on Wan 2.2 and FlashVSR; inference via LightX2V; quantized kernels from comfy-kitchen.
These are derived (quantized) weights, released under Apache-2.0, the license the RelayVSR project states for itself. The original weight repository does not carry its own license field; if its authors publish different terms for the weights, those apply. Quantized by MATLOWAI.