🎛️ Smart USDU Universal (No Upscale) V2

The V2 of the solver-driven Universal (No Upscale) is a small but useful step: it adds a second output, debug_info (STRING), alongside the IMAGE. Everything else is the same contract as V1 - pre-upscaled upscaled_image plus output_width, output_height, tiles_x, tiles_y, tile_width, tile_height, tile_padding from the Smart Tile Solver, the safe_guard validation switch, and the Universal feature toggles (enable_diffdiff, enable_controlnet).

So why would you pick V2 over V1? Debugging. Tile-upscaling failures are notoriously opaque - a seam shows up and you don't know which tile did it, or the grid silently came out wrong. The debug_info string gives you a text log of what the node actually did: tile layout, per-tile processing, conditioning count, warnings. Wire it to a text display node or just read it in the console, and the mystery usually evaporates.

That's a bigger deal than it sounds, because the two silent failure modes in this family - conditioning count ≠ tile count, and a safe_guard bypass hiding a wrong value - are exactly the kind of thing a debug log makes visible. If you're still tuning your first solver→USDU graph, take V2 over V1. When it's stable and you want a cleaner node, V1 is fine.

The inputs, briefly

Same required set as V1: upscaled_image, output_width/output_height/tiles_x/tiles_y/tile_width/tile_height/tile_padding (all "from Matrix Search" per the tooltips), safe_guard, the two toggles, model/conditionings/negative/vae, the sampler block, mode_type, mask_blur, seam-fix settings, tiled_decode. Optional: denoise_mask, multiplier, model_patch, control_image, control_strength, control_mask. Outputs: image + debug_info.

Installing it

One of ~100 nodes in 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. Only ComfyUI's own torch/numpy/Pillow required; the heavy deps in requirements.txt serve other pack nodes. Free for personal/non-commercial use; commercial work needs the paid license.

The usual suspects

Same gotchas as V1, plus one new habit: actually read the debug_info when a seam or grid problem shows up - it usually names the tile and the mismatch. Keep safe_guard on during setup, feed the solver's upscaled image (not the raw source), and remember the tile sizes here are output-space.