Nodes/TBG_Enhanced Tiled Upscaler & Refiner FLUX PRO/TBG ETUR Upscaler and Tile Generator PRO
ComfyUI Node

TBG ETUR Upscaler and Tile Generator PRO

Where neuro-generative tile fusion gets built

By Ltamann·Created about a year ago·Updated 19 days ago· 156
TBG ETUR Upscaler and Tile Generator PRO
  • image
  • Segment_Mask
  • PRO_segs
  • labs_upscaler
  • TBG_Pipe
  • Upscaled Image
presetsNONE
Fragmentation1.00
tile_size_w1024
tile_size_h1024
upscale_modelNONE
upscale_by2.00
Optimize_Upscale_Factor_For_Tile_Usefalse
VLM_ModelNONE
VLM_QuantizationNone (FP16)
VLM_PromptProvide a highly detailed description of the image, emphasizing materials and textures. Enhance every visual detail, including accurate colors, lighting, and stylistic elements. Also describe the artistic or photographic style, such as film type, camera style, era, or overall aesthetic.
VLM_Process_Selected_Tiles_Onlyfalse
VLM_Selected_Tiles_Index_Numbers
VLM_seed0
Fusion ModeNeuro_Generative_Tile_Fusion
Fusion Reference Margin0
Fusion Margin64
Fusion Strength0.95
Feather Mask16
PRO_api_token

The PRO Tiler is the CE Tiler with the training wheels off. Same job - upscale, tile, generate per-tile VLM prompts, hand a TBG_Pipe to the Refiner - but it adds per-tile control, a real fusion mode, and the settings that decide whether your 100MP upscale looks seamless or looks like a grid of differently-colored squares. This is also the node where the pack's Patreon line gets drawn: PRO features need a free TB_LAAR membership and an API key, which you can pass as PRO_api_token or (better) as the TBG_ETUR_API_KEY environment variable so it doesn't get baked into your workflow JSON.

The pack is by TBG (Tobias Laarmann) and is an honest beta - updated daily, so expect the occasional regression along with the new toys.

How it works

The pipeline matches the CE node: ESRGAN-style upscale, split into tiles, optional VLM description per tile, then package into TBG_Pipe. The difference is the fusion strategy. The CE node uses Soft Merge, which limits how much creative (high-denoise) refinement you can do before seams appear. The PRO tiler defaults to Neuro-Generative Tile Fusion (NGTF): each tile's generated surroundings are remembered and fed into subsequent sampling steps, so later tiles "know" what's already been generated around them. That's what lets the Refiner run high denoise and still produce seamless results - the README's whole pitch is "no need for blended borders."

The controls cluster around that:

  • Fusion Margin (64) - the blur width used to blend NGTF tiles.
  • Fusion Strength (0.95) - strength of the fusion mask. The tooltip gives you the exact fix for the most common complaint: "If you see light color shifts on tile borders, lower this a little." 0 = off, 1 = full.
  • Feather Mask (16) - final-composite gradient, separate from the NGTF fusion itself.
  • Fusion Reference Margin (0) - reference border content kept per tile and cropped at stitch time.

Inputs that matter

  • presets - drops in curated combinations so you don't have to hand-tune everything. Handy until you outgrow them.
  • Fragmentation (1.0, 0.5–4) - how aggressively the image is cut up. Higher = more, smaller tiles = less VRAM per pass but more seams to fuse. Raise it only if you're OOMing.
  • tile_size_w / tile_size_h (1024 × 1024) - unlike the CE node you can tile non-square, which matters for wide panoramas.
  • upscale_by (2.0) and upscale_model ("NONE") - same as CE: pick a real 4x model from upscale_models if you want actual pixel upscaling first, and don't expect magic from a bare NONE rescale.
  • Optimize_Upscale_Factor_For_Tile_Use - keeps your tile grid, trims the effective scale so only the needed overlap is used. Leave it on.
  • VLM_Model / VLM_Prompt / VLM_seed - per-tile prompt generation. The PRO version adds VLM_Process_Selected_Tiles_Only + VLM_Selected_Tiles_Index_Numbers (e.g. "1,2,3,6"), so you can regenerate prompts for just the tiles you edited.
  • Optional Segment_Mask lets you tile around a segmentation mask (objects get their own handling - useful with the per-tile Refiner workflow).

Outputs: TBG_Pipe and the Upscaled Image. Everything interesting happens downstream in the Refiner.

Install

Same as the whole pack - ComfyUI Manager ("TBG Enhanced Upscaler") 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. Heavy requirements (opencv-contrib-python, kornia, timm, triton, transformers/diffusers), needs the v3 API of a current ComfyUI, and you'll be downloading a lot of models per the README list - the "too many model downloads" complaint is the most common pushback you'll see in the community.

Common issues

  • Color bands at tile borders - lower Fusion Strength (the tooltip literally tells you to), check Color_Match in the Refiner, or raise Fusion Reference Margin for more context per tile.
  • OOM - raise Fragmentation to make smaller tiles rather than dropping your whole workflow.
  • API key pasted into the node - it ends up in your workflow and image metadata. Use the TBG_ETUR_API_KEY env var instead.
CategoryTBG/ETUR Tiled Upscaler and Refiner

Inputs (23)

NameTypeDefaultDescription
imageIMAGE
presetsCOMBONONE2 options: NONE, Full size Image no Tiles
FragmentationFLOAT1.000.5–4
tile_size_wINT1024320–8192
tile_size_hINT1024320–8192
upscale_modelCOMBONONE34 options: NONE, FAST/_area, FAST/_bicubic, FAST/_bilinear, FAST/_bislerp, FAST/_lanczos, +28
upscale_byFLOAT2.000.05–8
Optimize_Upscale_Factor_For_Tile_UseBOOLEANfalseKeeps the tile grid from the requested upscale factor, then lowers the effective scale to the largest size that uses only the required Soft Merge or NGTF overlap.
VLM_ModelCOMBONONECheck the license for all models. Apple’s model is for research use only and the files are not included in this custom node. It must be installed separately by the user. Use 'OpenAI-Compatible (Labs Server)' to route VLM requests to the server configured in the Labs Upscaler node.
VLM_QuantizationCOMBONone (FP16)Only for QWEN 3 models
VLM_PromptSTRINGProvide a highly detailed description of the image, emphasizing materials and textures. Enhance every visual detail, including accurate colors, lighting, and stylistic elements. Also describe the artistic or photographic style, such as film type, camera style, era, or overall aesthetic.
VLM_Process_Selected_Tiles_OnlyBOOLEANfalse
VLM_Selected_Tiles_Index_NumbersSTRINGYou can set a list of selected tiles for VLM prompt generation like 1,2,3,6 and activate VLM Process Selected Tiles Only
VLM_seedINT00–18446744073709550000
Fusion ModeCOMBONeuro_Generative_Tile_Fusion2 options: Soft Merge, Neuro_Generative_Tile_Fusion
Fusion Reference MarginINT00–256Reference border content kept around each NGTF tile and cropped out when stitching the image back together.
Fusion MarginINT640–128Fusion blur width used for NGTF tile blending.
Fusion StrengthFLOAT0.950–1Controls the fusion mask. If you see light color shifts on tile borders, lower this a little. Progressively reduces the fusion edge effect around tile borders: 0 = Off, 1 = Full.
Feather MaskINT160–128Feather mask is a gradient used only in final image compositing to smoothly blend tiles together using neuro-generative tile fusion.
Segment_MaskoptMASK
PRO_api_tokenoptSTRING
PRO_segsoptSEGS
labs_upscaleroptlabs_upscalerTBG ETUR experimental tools

Outputs (2)

NameTypeDescription
TBG_PipeTBG_Pipe
Upscaled ImageIMAGE