Instructions to use TensorForger/Steppe-Wan2.1 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Wan2.2
How to use TensorForger/Steppe-Wan2.1 with Wan2.2:
# No code snippets available yet for this library. # To use this model, check the repository files and the library's documentation. # Want to help? PRs adding snippets are welcome at: # https://github.com/huggingface/huggingface.js
- Notebooks
- Google Colab
- Kaggle
Steppe for Wan 2.1 VAE latents
π§© ComfyUI nodes: ComfyUI-Steppe
Available in ComfyUI-Manager: search for "Steppe" and install (or
comfy node install steppe). The nodes download these models on first use.
Steppe is a family of generative latent upscalers: small generative models trained only for upscaling, which run directly on VAE latents. The upscaled latent is decoded straight by the VAE: no second sampling pass of the base model, no hires fix, no prompt.
These models upscale latents of the Wan 2.1 VAE, the latent space shared by Wan 2.1, Wan 2.2 14B, Qwen-Image, Qwen-Image-Edit and Krea 2.
- 2x resolution of images and videos, e.g. 512 β 1024 or 1024 β 2048, and chained 2x β 2x.
- 2x frame rate of videos (latent frame interpolation), also combined with 2x resolution.
- One step: ~45 ms for a 1024 px image with the default model (RTX 5090). Most of the time goes to the VAE decode.
- Sharpness control through the high frequency feature conditioning (hff).
Wan 2.1 1.3B, 640x512 at 16 fps β Steppe 1280x1024 at 32 fps (2x resolution and 2x frame rate in one pass).
Gallery
All examples: Krea 2 Turbo, Steppe 200M 1-step, chained 2x β 2x, no prompt and no refinement pass. Bicubic tiles are upscaled by the same factor from the same input. Click an image for the full resolution card.
Use in ComfyUI
Install ComfyUI-Steppe: search for "Steppe" in ComfyUI-Manager,
or run comfy node install steppe. The models download automatically on first use.
KSampler β Steppe Upscale Latent β VAE Decode
Example workflows (Krea 2 image 4x, Wan 2.1 video 2x resolution + 2x frame rate) are in
example_workflows/.
To install the models manually, put the files into ComfyUI/models/latent_upscale_models.
Files
| file | steps | parameters | use |
|---|---|---|---|
steppe_wan_2_1_200M_1step.safetensors |
1 | 222M | default, 90% of use cases: the quality of the base model in one step |
steppe_wan_2_1_200M_base.safetensors |
1-200 (20) | 222M | most control and research: steps, CFG on hff; same quality as the 1-step model in general use |
steppe_wan_2_1_20M_1step.safetensors |
1 | 19.5M | lite: very large outputs (2048 β 4096), real time and streaming use |
All files are bfloat16 safetensors with the model configuration in the metadata. config.json is the catalog of this
repository (versions, recommended settings).
Compatibility
| model | VAE | status |
|---|---|---|
| Wan 2.1 (T2V, I2V, FLF2V, VACE; 1.3B, 14B) | Wan 2.1 VAE | native |
| Wan 2.2 A14B (T2V, I2V) | Wan 2.1 VAE | native |
| Qwen-Image, Qwen-Image-Edit | Qwen-Image VAE: the Wan 2.1 encoder (identical weights) with a fine-tuned decoder | native, tested with qwen_image_vae |
| Krea 2 | Wan 2.1 VAE | native, tested |
| Wan 2.2 TI2V 5B | Wan 2.2 VAE (48 channels) | not supported |
| FLUX, SD3, SDXL, β¦ | other VAEs | not supported |
Tested in ComfyUI with both wan_2.1_vae and qwen_image_vae, chained 2x β 2x, any aspect ratio, inputs from
512x512 pixels up.
Settings
- hff (
0...1, default 0.9): target amount of fine detail and sharpness. Off (-1) lets the model choose. The values are absolute: an Immerkaer noise estimate, quantile-normalized on ReLAION photos. - guidance:
- 1-step models: a distilled guidance input, trained on 1-3, no extra cost. The default 1 (off) is safe and stable; 2 also works well.
- Base model: classifier free guidance between the hff and the null hff. Use 4-8 for a strong effect; the cost is two passes per step.
- Base model sampler: 20 Euler steps, sigma shift 4. The initial noise scale is 1.0 for spatial upscaling and 0.8 for temporal only.
- Temporal 2x: T latent frames become 1 + 2 (T - 1), i.e. 81 β 161 pixel frames. The first frame is kept.
Benchmark
1000 photos (Axis-V1), 512 β 1024. Every solution gets only the Wan 2.1 latent (no prompt). Patch FID on native 256 px tiles (lower is better); latency at batch 1, VAE decode included, RTX 5090, eager bfloat16.
| solution | patch FID | FID | latency | peak VRAM |
|---|---|---|---|---|
| Steppe 200M base, 20 steps | 4.31 | 3.01 | 1051 ms | 5.0 GB |
| Steppe 200M 1-step | 4.36 | 3.07 | 179 ms | 4.9 GB |
| Steppe 20M 1-step | 5.85 | 3.85 | 141 ms | 4.5 GB |
| Wan2.1-VAE-upscale2x decoder (spacepxl) | 6.33 | 5.80 | 29 ms | 1.3 GB |
| SPAN 2x after decode | 11.19 | 4.83 | 35 ms | 1.3 GB |
| Real-ESRGAN x2 after decode | 13.83 | 8.83 | 57 ms | 1.3 GB |
| bicubic after decode | 14.13 | 3.33 | 30 ms | 1.3 GB |
| SesquiLSR (latent, made for hires fix) | 29.23 | 7.65 | 136 ms | 4.5 GB |
Steppe stays close to the input: the roundtrip color error (ΞE00 2.36) equals the VAE reconstruction floor.
Benchmark images: Axis-V1 by refine-axis (CC BY 4.0), cropped.
Python
pip install "steppe[standalone] @ git+https://github.com/TensorForger/ComfyUI-Steppe"
import torch
from diffusers import AutoencoderKLWan
from steppe import UpscaleSettings, load_upscaler
vae = AutoencoderKLWan.from_pretrained(
"Wan-AI/Wan2.1-T2V-1.3B-Diffusers", subfolder="vae", torch_dtype=torch.float32
).to("cuda")
upscaler = load_upscaler("steppe_wan_2_1_200M_1step.safetensors")
upscaler.model.to("cuda")
# pixels: [B, 3, T, H, W] in [-1, 1]; raw (unnormalized) latents in and out
latents = vae.encode(pixels.to("cuda")).latent_dist.mode()
upscaled = upscaler.upscale(
latents, UpscaleSettings(spatial=True, temporal=False, hff=0.9, guidance=1.0)
)
pixels_2x = vae.decode(upscaled.to("cuda")).sample
How it works
A window transformer runs on the full resolution latent grid. It uses DiT style adaLN-zero blocks, shifted 8x8 window attention and a causal depthwise temporal convolution. A learned source encoder upsamples the input latent. The model generates the normalized residual over the aligned low resolution latent with rectified flow, conditioned on the noise level and the hff.
- Base model: 222M parameters, trained from scratch for ~46 h on 6 RTX 5090s. Data: images from ReLAION-high-resolution (512 β 1024 and 256 β 512) and a set of ~50k video clips at 1024x1024 (17 β 33 frames at 512, plus 1024 and combined spatial and temporal pairs). Training pairs are made by downscaling and encoding with the Wan 2.1 VAE; no captions are used. hff dropout enables classifier free guidance.
- 1-step model: rectified flow distillation of the base model (40k teacher pairs, 2 h on 8 GPUs). It keeps ~99% of the base model's quality.
- 20M model: the same architecture scaled down and trained from scratch on pairs from the 1-step model.
The architecture and recipe come from agent-driven autoresearch: ~80 runs on FLUX.2 latents, then ~70 on Wan 2.1 latents (rounds of parallel 30 min and 2 h training runs, judged by patch FID).
Limitations
- Small text and small background faces are where all upscalers fail. Steppe improves them less than textures and edges, and the 20M model the least.
- The upscaling factor is fixed at 2x. For 4x, chain two upscales (the 1-step model is as good as the base model there).
- Long videos run in one pass, but the model was trained on clips up to 33 output frames. For very long clips, temporal windows (Advanced node) can be more stable.
License
MIT. Steppe works on latents of the Wan 2.1 VAE (Apache-2.0, Wan Team, Alibaba Group), see NOTICE. This repository
does not contain VAE weights.
The ancestor of Steppe is comfyui-flow-upscaler (FLUX.2).
@misc{steppe2026,
author = {TensorForger},
title = {Steppe: Generative Latent Upscalers},
year = {2026},
url = {https://huggingface.co/TensorForger/Steppe-Wan2.1}
}
- Downloads last month
- 84
Model tree for TensorForger/Steppe-Wan2.1
Base model
Qwen/Qwen-Image








