Nodes/ComfyUI-ArchAi3d-Qwen/πŸŽ›οΈ Smart USDU V3 (Standalone - Feather Debug)
ComfyUI Node

πŸŽ›οΈ Smart USDU V3 (Standalone - Feather Debug)

A bare-bones tiled upscaler you can take apart, feather masks and all

By amir84ferdosΒ·Created 11 months agoΒ·Updated 5 months agoΒ· 70
πŸŽ›οΈ Smart USDU V3 (Standalone - Feather Debug)
  • image
  • model
  • positive
  • negative
  • vae
  • denoise_mask
  • image
  • debug_info
  • input_tiles
  • output_tiles
  • feather_masks
  • combined_view
β—„tiles_x2β–Ί
β—„tiles_y2β–Ί
β—„tile_width512β–Ί
β—„tile_height512β–Ί
β—„feather_enabledtrueβ–Ί
β—„feather_width32β–Ί
β—„feather_blur8β–Ί
β—„seed0β–Ί
β—„steps20β–Ί
β—„cfg7.0β–Ί
β—„sampler_nameβ–Ύβ–Ί
β—„schedulerβ–Ύβ–Ί
β—„denoise0.50β–Ί

This one is a debug build wearing a node's clothes. "Smart USDU V3 (Standalone - Feather Debug)" lives in the pack's Utils category rather than the USDU folder, and the source is frank about it: it's a standalone implementation for debugging the tile feather mask concept, with no dependency on the pack's processing pipeline. You give it a plain image, a grid (tiles_x, tiles_y), a tile size, and a sampler setup - and it tiles, samples, feathers, and blends, with every intermediate stage exposed as an output so you can watch exactly what happens.

Don't reach for this for production upscales. It's missing most of what the USDU family adds: no per-tile conditioning list (just a single positive), no safe_guard solver integration, no ControlNet or diffdiff options, and the inputs are raw image + tile_width/tile_height rather than solver outputs. What it has is transparency.

The debugging outputs

  • image - the final blended result
  • input_tiles - grid of the original tile crops, so you can check the geometry is what you think
  • output_tiles - grid of tiles after sampling, before blending
  • feather_masks - the feather masks as grayscale images (1.0 center β†’ 0.0 at interior edges)
  • combined_view - tiles with feather zones tinted red, the single most useful thing here
  • debug_info - text log of the whole run

The feather controls are the same trio as the V3 universal: feather_enabled, feather_width, feather_blur. Sampling defaults are a bit different from the USDU family - cfg 7, denoise 0.5 - and the only optional input is a denoise_mask for per-pixel denoise. Outputs are your diagnostics.

Installing it

Part of ComfyUI-ArchAi3d-Qwen by Amir Ferdos (ArchAi3d). ComfyUI Manager β†’ search "ArchAi3d Qwen" β†’ install β†’ restart, or:

cd ComfyUI/custom_nodes
git clone https://github.com/amir84ferdos/ComfyUI-ArchAi3d-Qwen.git
cd ComfyUI-ArchAi3d-Qwen
pip install -r requirements.txt

Restart. Needs only ComfyUI's bundled torch/numpy/Pillow. Free for personal use; commercial use needs the paid license.

The honest verdict

This node exists to answer one question: is the feather mask the reason my seams look better (or worse)? Use combined_view and feather_masks to see it, then apply the same settings on the V3 Universal, which is the production version. If you don't care about the mechanism, skip this node entirely - the Universal V3 does everything it does plus conditioning lists, toggles, and solver integration.

CategoryArchAi3d/Utils

Inputs (19)

NameTypeDefaultDescription
imageIMAGEβ€”
tiles_xINT21–10β€”
tiles_yINT21–10β€”
tile_widthINT51264–8192β€”
tile_heightINT51264–8192β€”
feather_enabledBOOLEANtrueEnable tile feather mask for color consistency
feather_widthINT320–256Width of gradient zone at tile edges (pixels)
feather_blurINT80–64Gaussian blur radius for smooth gradients
modelMODELβ€”
positiveCONDITIONINGβ€”
negativeCONDITIONINGβ€”
vaeVAEβ€”
seedINT00–18446744073709550000β€”
stepsINT201–100β€”
cfgFLOAT7.00–30β€”
sampler_nameCOMBO44 options: euler, euler_cfg_pp, euler_ancestral, euler_ancestral_cfg_pp, heun, heunpp2, +38
schedulerCOMBO9 options: simple, sgm_uniform, karras, exponential, ddim_uniform, beta, +3
denoiseFLOAT0.500–1β€”
denoise_maskoptMASKOptional per-pixel denoise mask (for DiffDiff)

Outputs (6)

NameTypeDescription
imageIMAGEβ€”
debug_infoSTRINGβ€”
input_tilesIMAGEβ€”
output_tilesIMAGEβ€”
feather_masksIMAGEβ€”
combined_viewIMAGEβ€”