Gigapixel CLI

Topaz Gigapixel AI has a reputation as one of the best texture upscalers in the business, and it's also completely separate from the ComfyUI ecosystem. Gigapixel CLI is the bridge: it calls Gigapixel's command-line interface from inside a workflow, so you get Topaz's models without leaving the graph. If you already own Gigapixel, this is the node that saves you from exporting to the standalone app, upscaling, and importing back.

The catch up front: it requires a licensed install of Gigapixel AI Pro - the CLI is a Pro feature, and this node is a wrapper, not a crack. No license, no CLI, no node.

How it works

The node writes your batch of images to temp files, shells out to gigapixel.exe, and reads the upscaled results back in. It maps the friendly model names to Topaz's CLI aliases (Art & CG → art, Lines → lines, Very Compressed → vc, High Fidelity → hf, Low Resolution → lowres, Standard → std, Text & Shapes → text, Redefine → redefine).

The inputs that matter:

• image - a batch of images.
• model - the 8-model dropdown (Art & CG is the usual pick for game textures).
• scale - 1.0–6.0, default 2.
• autopilot (default on) - lets Gigapixel pick the model/settings itself. Turn it off if you want to control denoise, sharpen, and compression (each 0–100).
• creativity, texture (1–6), and prompt - only relevant for the Redefine model, which is Topaz's generative/reimagine mode.

Output: upscaled_images, a single IMAGE batch ready for saving.

Install and setup

The node is part of ComfyUI-Leputen-Utils:

cd ComfyUI/custom_nodes
git clone https://github.com/lilquail/ComfyUI-Leputen-Utils

Then the one-time config that trips everyone up: you must point the pack at your gigapixel.exe via Settings (⚙️) → Leputen Utils → Upscaling → Gigapixel CLI Path. There's no auto-discovery; leave it empty and the node has nothing to call.

Troubleshooting

• "Gigapixel CLI errors" / nothing happens - the path is wrong or empty. Set it in Settings → Leputen Utils → Upscaling.
• "CLI requires Gigapixel AI Pro" - not a bug. The CLI doesn't ship with the standard edition; check your license.
• Slow on big batches - every image round-trips through disk to the standalone app and back. Batch sizes you'd feed to a local upscaler will feel sluggish; it's worth chunking.
• Redefine ignores your settings - denoise/sharpen/compression apply to the traditional models; Redefine uses creativity, texture, and prompt instead. Don't fight the wrong knobs.

Where it fits

If you're choosing between this and the pack's DeepBump Upscale for game textures: DeepBump is free, self-contained, and great for PBR maps. Gigapixel is (in most people's eyes) the better looking upscaler for diffuse/albedo, and you already paid for it - this node just makes it reachable from a workflow. For normal/height maps specifically, you probably want DeepBump or no upscaler at all, because Topaz is trained on photos and can invent details that break PBR data.