TBG ETUR Refiner PRO
TBG ETUR Refiner PRO
- model
- clip
- vae
- TBG_Pipe
- Controlnet_Pipe
- Enrichment_Pipe
- RF_UntwistingRoPE
- denoise_mask
- Redux_Style_Model
- Redux_Clip_Vision
- labs_refiner
- Refined
- Refined without Segs
- Refined without ColorCorrection
- Original Upscaled
- Original
- Tiles
The TBG ETUR Refiner PRO is the heart of the whole TBG pack. The Tiler node splits your image and builds the TBG_Pipe; this node is where the actual tiled sampling happens - tile by tile, with each tile getting its own prompt, denoise, and seed, then getting stitched back together so the seams don't look like a quilt. If you've only got room to learn one node in this pack, this is it.
The pack itself is by Tobias Laarmann (TBG / TB_LAAR, TBG______ on Reddit), and it's an unusually ambitious tiled upscaler-and-refiner. It's still labeled beta and gets updated nearly daily, which cuts both ways: you get new features fast, and you also get the occasional regression. PRO nodes like this one need a free Patreon membership plus an API key (TBG_ETUR_API_KEY as an environment variable is safer than pasting it into the node, because pasting it embeds the key in your workflow metadata).
How it works
The refiner takes the TBG_Pipe from the Tiler, which carries your upscaled image, the tiles, masks, and any per-tile prompts. It then samples each tile with your model and fuses them back together. The headline fusion mode is Neuro-Generative Tile Fusion (NGTF): instead of just blurring tile borders, it remembers the surrounding generated content and adapts later sampling steps to it, so you can run higher denoise without the color shifts and seams you'd normally get. There's also a Soft Merge mode for low-denoise work.
The other thing that makes this pack distinctive is how it treats the scheduler. denoise_method defaults to "normalized advanced," which splits sigmas by noise values rather than step percentages, so you can swap samplers without losing the creative behavior you dialed in. And vae_encode defaults to "tiled slow" but offers "tbg Color-preserving fast" and "Nvidia PiD 4x" - the latter hands decode to NVIDIA's pixel-diffusion decoder, which is a fast 4x upscaler in its own right. The KB's take on PiD is worth remembering: it's an upscaler that invents detail, not a lossless VAE swap, and it fixed a mixed CPU/CUDA crash in v1.2.8.
Inputs that actually matter
You must connect model, clip, vae, and TBG_Pipe. Set model_type to match your model (FLUX1, FLUX2, Qwen Image, SDXL, SD3, Z-Image, and more) - it changes the assumed native tile size. Beyond that:
- steps (30) and denoise (0.27) - denoise is the single biggest lever. Low and slow for faithful upscales, higher for creative re-imagining.
- Flux_Guidance (3.5) - the tooltip says it plainly: if areas aren't blending well across tiles, raise it.
- VRAM_Profile - defaults to "Low VRAM Cache (Unload Models)." If you're on 8–12 GB, leave it there; "Fast Cache" precomputes everything and will eat your card.
- Image Stabilizer, Smoother-Sharper, Detail_Enhancer - all default 0 (off). Turn them on one at a time, not all at once.
- Scale-Invariant Feature Transform (on by default) realigns each generated tile back to its reference, which is what kills the creeping drift that plagues big tiled jobs.
- Fast_1_Tile_Preview - render one tile first and check your settings before burning an hour on the full run. Use this. Always.
Optional Controlnet_Pipe, Redux_Style_Model/Redux_Clip_Vision, denoise_mask, and RF_UntwistingRoPE (from the pack's RF pipe node) plug into the same spot. Outputs are Refined (the money shot), plus Refined without Segs, Refined without ColorCorrection, Original Upscaled, Original, and Tiles - the ablated outputs are genuinely useful for diagnosing whether it's the fusion or the color match doing something you don't like.
Install
ComfyUI Manager → search "TBG" and install "TBG Enhanced Upscaler" node set, or:
cd ComfyUI/custom_nodes
git clone https://github.com/Ltamann/ComfyUI-TBG-ETUR
cd ComfyUI-TBG-ETUR
pip install -r requirements.txt
Restart ComfyUI. This pack needs a recent ComfyUI - it registers through the v3 API (comfy_api.v0_0_2) - and its requirements list is heavy: opencv-contrib-python (SIFT), kornia, transformers/diffusers/accelerate (PiD), timm, triton, and optional Qwen-VL bits. The README also lists a long roster of models you'll want (flux fp8, t5xxl encoder, Flux VAE, Redux, sigclip vision, ControlNet models). "A ton of extra models needed to dl before it works" is the community's #1 complaint about this pack, and it's fair.
Common issues
- VRAM OOM on big images - use the Low VRAM or Ultra Low Memory profiles, and don't run "Fast Cache" on a small card.
- Seams or color bands at tile borders - raise
Flux_Guidance, lowerFusion Strengthon the Tiler, or switchColor_Match. - Daily-update breakage - the README tells you to update as often as they ship. When a fresh update acts weird, check the changelog before assuming you broke something.
Inputs (37)
| Name | Type | Default | Description |
|---|---|---|---|
| model_type | COMBO | FLUX1 | 11 options: FLUX1, FLUX2, Ideogram4, FLUX1 Kontext, Krea2, Qwen Image, +5 |
| model | MODEL | — | |
| clip | CLIP | — | |
| vae | VAE | — | |
| cfg | FLOAT | 1.0-10–100 | — |
| steps | INT | 301–10000 | — |
| TBG_Pipe | TBG_Pipe | — | |
| seed | INT | 40–18446744073709550000 | — |
| Flux_Guidance | FLOAT | 3.5-100–100 | All Fusion Modes benefit from high Guidance, so if you notice that certain areas aren't blending well, try increasing the Guidance value. |
| sampler_name | COMBO | 47 options: euler, TBG Flux2 Sampler, pid_sde, pid_creative_sde, euler_cfg_pp, euler_ancestral, +41 | |
| basic_scheduler | COMBO | 9 options: simple, sgm_uniform, karras, exponential, ddim_uniform, beta, +3 | |
| vae_encode | COMBO | tiled slow | tiled slow is the standard ComfyUI tiled VAE path. tbg Color-preserving fast is the faster TBG VAE path that preserves colors. Nvidia PiD 4x changes VAE decoding to the PiD model; 1024x1024 uses the native fast path, while other tile or segment sizes use tiled PiD latent decode. It works with FLUX1, FLUX2, Qwen Image, Qwen Image Edit, SDXL, SD3, and Z-Image. |
| tile_size_vae | INT | 1024256–4096 | — |
| General_Prompt_Positive | STRING | General_Prompt_Positive | |
| General_Prompt_Negative | STRING | 低质量,模糊,噪点,失焦,曝光不良,过度曝光,欠曝光,重影,漂浮的物体,穿模,错误的结构,解剖错误,多余的肢体,多余的手指,缺少手指,手指融合,肢体融合,奇怪的骨骼,扭曲的身体,不自然的姿势,不自然的动作,不对称,身体比例不正确,脸部变形,重复的脸,五官错位,眼睛不对称,视线错误,面部畸形,表情僵硬,卡通化,非真实皮肤纹理,塑料感皮肤,过度光滑,噪点伪影,阴影错误,光照不一致,颜色溢出,奇怪的反射,重复的图案,破碎结构,AI 痕迹,水印,文字,logo,二维码,杂乱背景,物体穿插,图像缺损,像素化,低分辨率,乱色块,扭曲纹理,异常的毛发,不自然的布料褶皱,边缘锯齿,锐化过度,发光边缘,异常色彩,噪声纹理 | General_Prompt_Negative |
| denoise | FLOAT | 0.270–1 | — |
| denoise_method | COMBO | normalized advanced | Default: splits sigmas by step percentage and interpolates back to full steps | Normalize Advanced: splits by sigma noise values and interpolates back to full steps, best for sampler-independent creative control | Default Short: splits sigmas by step percentage and keeps only low-noise steps for efficient img2img denoising. |
| Per_Pixel_Denoise_Mask_Strength | FLOAT | 1.000–1 | Changes the influence of the Per_Pixel_Denoise_Mask |
| Image Stabilizer | FLOAT | 0.000–1 | 0=OFF. Applys adaptive denoising based on local image complexity. Flat regions are stabilized to prevent color shifts, while detailed areas allow stronger creative changes. Useful for light backgrounds and large uniform areas and as alternative to cnets. |
| Smoother - Sharper | FLOAT | 0.00-1–1 | 0=OFF. Dual-stage adaptive sharpening. At high sigma (early steps), adds structured noise for detail invention. At low sigma (late steps), applies high-pass edge sharpening. Positive values sharpen and add details. Negative values soften and blur. Zero disables sharpening. Higher absolute values create stronger effects. |
| Detail_Enhancer | FLOAT | 0.00-1–1 | 0=OFF. Substep evaluation for detail control. Positive values (0.1-1.0): lookahead to next sigma, adds coherent details and refinement, reduces variation. Negative values (-0.1 to -1.0): lookback to previous sigma, adds creative variation and texture complexity. Zero = disabled (single pass, fastest). Performance cost: 2x slower on affected steps. |
| FLux_Redux_Krea2VL_strength | FLOAT | 0.5000–1 | Controls how strongly visual information is transferred. 0 disables VL style transfer; 1.0 applies full strength. |
| Controlnet_Pipe_strength | FLOAT | 1.000–1 | 0=OFF. It's a multiplier value applied uniformly to all ControlNets from CnetPipe, scaling their combined influence. |
| Color_Match | COMBO | TBG ETUR Detail-Preserving Tile Stabilizer | Tile-aware detail-preserving color stabilization with feathered seam blending into generated neighbor tiles. If tile-aware conditions are unavailable, it falls back to TBG Detail-Preserving Color Stabilizer. |
| Scale-Invariant Feature Transform | BOOLEAN | false | After a tile is generated, aligns it back to the reference tile. Off disables it. On uses the strongest x4 drift-correction path. |
| Fusion Extra Steps | INT | 00–20 | 0 is the default and is recommended. If you need better tile fusion use Values from 1-20 this adds extra fusion steps to generate a better tile fusion, stay between 1 and 5. Each extra step adds one model call per outer sampler step and increases sampling time. |
| Fast_1_Tile_Preview | BOOLEAN | false | The first Selected_Tiles_By_Number are processed at full scale as a preview, allowing a quick check of settings before processing the entire set. |
| Selected_Tiles_Only | BOOLEAN | false | — |
| Selected_Tiles_By_Numbers | STRING | You can set a list of selected tiles to process like 1,2,3,6 and activate Selected_Tiles_Only | |
| VRAM_Profile | COMBO | Low VRAM Cache (Unload Models) | Fast Cache (Max Speed): Precomputes full tile conditioning (text + Redux + ControlNet) for all tiles and keeps models loaded. Fastest sampling, highest RAM/VRAM usage. Low VRAM Cache (Unload Models): Same full precompute, then unloads models to reduce VRAM. RAM can still be high with many tiles. Ultra Low Memory (Per-Tile Streaming): Caches repeated text conditioning only; Redux/ControlNet are rebuilt per tile and released immediately. Also unloads/reloads models between steps/tiles for minimum VRAM. Slowest mode; best for very low-spec systems. |
| Controlnet_Pipeopt | Controlnet_Pipe | — | |
| Enrichment_Pipeopt | Enrichment_Pipe | — | |
| RF_UntwistingRoPEopt | RF_UntwistingRoPE_Pipe | — | |
| denoise_maskopt | MASK | — | |
| Redux_Style_Modelopt | STYLE_MODEL | — | |
| Redux_Clip_Visionopt | CLIP_VISION | — | |
| labs_refineropt | labs_refiner | TBG ETUR experimental tools |
Outputs (6)
| Name | Type | Description |
|---|---|---|
| Refined | IMAGE | — |
| Refined without Segs | IMAGE | — |
| Refined without ColorCorrection | IMAGE | — |
| Original Upscaled | IMAGE | — |
| Original | IMAGE | — |
| Tiles | IMAGE | — |