TBG ETUR Upscaler and Tile Generator PRO
Where neuro-generative tile fusion gets built
- image
- Segment_Mask
- PRO_segs
- labs_upscaler
- TBG_Pipe
- Upscaled Image
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_modelsif 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), checkColor_Matchin the Refiner, or raiseFusion Reference Marginfor more context per tile. - OOM - raise
Fragmentationto 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_KEYenv var instead.
Inputs (23)
| Name | Type | Default | Description |
|---|---|---|---|
| image | IMAGE | — | |
| presets | COMBO | NONE | 2 options: NONE, Full size Image no Tiles |
| Fragmentation | FLOAT | 1.000.5–4 | — |
| tile_size_w | INT | 1024320–8192 | — |
| tile_size_h | INT | 1024320–8192 | — |
| upscale_model | COMBO | NONE | 34 options: NONE, FAST/_area, FAST/_bicubic, FAST/_bilinear, FAST/_bislerp, FAST/_lanczos, +28 |
| upscale_by | FLOAT | 2.000.05–8 | — |
| Optimize_Upscale_Factor_For_Tile_Use | BOOLEAN | false | Keeps 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_Model | COMBO | NONE | Check 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_Quantization | COMBO | None (FP16) | Only for QWEN 3 models |
| VLM_Prompt | STRING | Provide 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_Only | BOOLEAN | false | — |
| VLM_Selected_Tiles_Index_Numbers | STRING | You can set a list of selected tiles for VLM prompt generation like 1,2,3,6 and activate VLM Process Selected Tiles Only | |
| VLM_seed | INT | 00–18446744073709550000 | — |
| Fusion Mode | COMBO | Neuro_Generative_Tile_Fusion | 2 options: Soft Merge, Neuro_Generative_Tile_Fusion |
| Fusion Reference Margin | INT | 00–256 | Reference border content kept around each NGTF tile and cropped out when stitching the image back together. |
| Fusion Margin | INT | 640–128 | Fusion blur width used for NGTF tile blending. |
| Fusion Strength | FLOAT | 0.950–1 | Controls 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 Mask | INT | 160–128 | Feather mask is a gradient used only in final image compositing to smoothly blend tiles together using neuro-generative tile fusion. |
| Segment_Maskopt | MASK | — | |
| PRO_api_tokenopt | STRING | — | |
| PRO_segsopt | SEGS | — | |
| labs_upscaleropt | labs_upscaler | TBG ETUR experimental tools |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| TBG_Pipe | TBG_Pipe | — |
| Upscaled Image | IMAGE | — |