π° McBoaty - v6 /m
One node to upscale and refine β but check the README before you trust it
- pipe
- model
- clip
- vae
- tiles
- McBoaty Pipe
- McPrompty Pipe
- tiles
- tiles - cannies
- info
McBoaty is the headline act of the MaraScott pack: a tiled upscaler that refines your image per-tile so you can push an image to print sizes without the VRAM blow-up or the patchwork seams that naive tiling gives you. The v6 generation restructured the whole thing - instead of the v5 three-node chain (Upscaler β TilePrompter β Refiner), you now build it from a Tiler, a Configurator, a TilePrompter and a Refiner, and this McBoaty node is the all-in-one that merges Configurator + Refiner into a single box.
Now the part you need before you get invested: the pack README literally says "McBoaty v6 is broken" and links to issue #187 asking for help. As of this writing that's the author's own framing. So read the rest of this as "how it's supposed to work," and if you hit nonsense, drop to the v5 set - which is the stable, battle-tested one. The v6 workflows in the repo (docs/wf/McBoaty_v6/) cover SD1.5, SDXL, SD3.5 and FLUX.1-dev if you want to see the intended graph.
What it does
Feed it the McBoaty pipe from a Tiler node (which slices your image into overlapping tiles, optionally after an upscale model pass), plus your model, clip, vae, and prompts as plain text. It merges the Configurator's inputs - scheduler, sampler, steps, seed, cfg, denoise, tiled VAE settings - with the Refiner's control-net settings, runs the whole tile-refine-and-rebuild pipeline, and hands you back:
McBoaty Pipe- for chaining more passes.McPrompty Pipe- for a TilePrompter pass.tilesandtiles - cannies- the refined tiles and their canny edge maps (handy for checking what the refiner actually did per tile).info- a string with timing and settings.
The settings that matter
denoise(default 0.27) - the sweet spot for McBoaty is 0.27β0.35. Higher = more change, and past ~0.5 you're inviting seams and hallucinations. The author's own advice: two x2 upscale passes beat one x4.sigmas_type+model_type- pick the scheduler family (Basic, SDTurbo, AlignYourSteps) and your model family (SD1/SDXL/SD3/FLUX1/SVD). AYS needs the right model type even when you're not using the AYS scheduler.strength/start_percent/end_percent- control-net strength, which is how McBoaty keeps each tile anchored to the source. Defaults (0.76, 0β0.76) are the "max denoise with control net" recipe from the README.vae_encode/tile_size_vae- tiled VAE encode keeps VRAM sane on big images.
Optional inputs also include the Ollama vision knobs (ollama_url, vlm_model, vlm_query) - if your positive prompt is empty and a vision model is configured, the Configurator will auto-caption the whole image and each tile so you get per-tile prompts for free. And color_match_method pulls the final image's colors back toward the input, which is the "minimal modification" promise McBoaty makes.
Install
cd ComfyUI/custom_nodes
git clone https://github.com/MaraScott/ComfyUI_MaraScott_Nodes
Restart, or ComfyUI Manager β search "MaraScott". You'll want an upscale model (4x-UltraSharp or similar in models/upscale_models/), and a canny-capable ControlNet if you want the tile anchoring. The pack vendors its own Ollama/Florence dependencies, so no separate installs for the captioning.
Bottom line: the v6 concept - split the pipeline into Tiler β Configurator β TilePrompter β Refiner with one-node shortcut - is genuinely cleaner. But with the author flagging v6 as broken, treat this as the "when it works" version and keep v5 in your back pocket.
Inputs (25)
| Name | Type | Default | Description |
|---|---|---|---|
| pipe | MC_BOATY_PIPE | β | |
| model | MODEL | β | |
| clip | CLIP | β | |
| vae | VAE | β | |
| positive | STRING | β | |
| negative | STRING | β | |
| sigmas_type | COMBO | 3 options: BasicScheduler, SDTurboScheduler, AlignYourStepsScheduler | |
| model_type | COMBO | SDXL | 5 options: SD1, SDXL, SD3, FLUX1, SVD |
| sampler_name | COMBO | 34 options: euler, euler_cfg_pp, euler_ancestral, euler_ancestral_cfg_pp, heun, heunpp2, +28 | |
| basic_scheduler | COMBO | 9 options: normal, karras, exponential, sgm_uniform, simple, ddim_uniform, +3 | |
| steps | INT | 101β10000 | β |
| seed | INT | 420β18446744073709550000 | β |
| cfg | FLOAT | 2.50β100 | β |
| denoise | FLOAT | 0.270β1 | β |
| vae_encode | BOOLEAN | true | β |
| tile_size_vae | INT | 512256β4096 | β |
| strengthopt | FLOAT | 0.760β10 | β |
| start_percentopt | FLOAT | 0.0000β1 | β |
| end_percentopt | FLOAT | 0.7600β1 | β |
| tilesopt | IMAGE | β | |
| vlm_queryopt | STRING | generate a single paragraph prompt of max 77 token to describe the image. do not comment. | β |
| ollama_urlopt | STRING | http://127.0.0.1:11434 | β |
| vlm_modelopt | COMBO | llama3.2-vision:latest | 0 options: |
| ollama_keep_aliveopt | INT | 5-1β60 | β |
| color_match_methodopt | COMBO | none | 7 options: none, mkl, hm, reinhard, mvgd, hm-mvgd-hm, +1 |
Outputs (5)
| Name | Type | Description |
|---|---|---|
| McBoaty Pipe | MC_BOATY_PIPE | β |
| McPrompty Pipe | MC_PROMPTY_PIPE | β |
| tiles | IMAGE | β |
| tiles - cannies | IMAGE | β |
| info | STRING | β |