ComfyUI-Practical-Tools Introduction
ComfyUI-Practical-Tools is a collection of nodes and workspace enhancements for ComfyUI. It helps you build workflows that are easier to connect, follow, and manage, especially when a project involves many images, masks, prompts, or processing steps.
You can use its nodes to organize connections, work with batches, repeat a sequence of steps, edit images and masks, and prepare text for prompts. Its interface features help you find important parts of a large workflow and see what is happening while it runs. The extension works alongside ComfyUI’s existing nodes; it is not a replacement for them.
How ComfyUI-Practical-Tools Works
A ComfyUI workflow passes information from one node to another. An image node might supply an image to a mask node, while a prompt node supplies text to another part of the workflow. Practical-Tools adds more ways to manage that flow:
- Route values: Choose which value or connection continues through a workflow.
- Group connections: Pack several values into a
Bus Innode, carry them together, and separate them withBus Out. Think of this as putting related supplies into one bag for a long trip across the canvas. - Work with changing data: The
Anynodes handle values that may differ from one part of a workflow to another, such as a list, a string, or another connected value. - Repeat steps: Loop nodes let a section of a workflow run repeatedly.
Batch Accumulatecan collect results produced during those repetitions. - Prepare visual inputs: Image and mask nodes can arrange batches, crop or pad images, and refine masks before later processing.
For example, a workflow that processes a folder of images might load the images, convert a batch into a list, repeat an editing step, and collect the results. The nodes you need depend on how you want to process those images.
ComfyUI-Practical-Tools Features
Workflow Routing and Organization
Any Compare, Any Convert, Any Index, Any Length, and Any Switch help inspect, convert, select, or route values. Any Passthrough and Any Rerouter help carry connections through a busy canvas. The Simple and Strong variants of some Any nodes provide alternative ways to access or switch values.
Link Switch selects between workflow connections. Create List gathers values into a list, while Random Integer and Random Path introduce random choices. Boolean Not reverses a true-or-false value, and Index Anything provides another way to select an item by position.
Bus In and Bus Out are particularly useful when the same group of values must travel across a large workflow. For example, you could group an image, mask, model, and prompt near the start of a section, then unpack them where they are needed. Audio Pass and Cond Pair Passthrough provide passthrough options for audio and conditioning.
Loops and Batch Results
While Loop Start and While Loop End surround a sequence that continues according to a condition. For Loop Start and For Loop End surround a sequence intended for repeated processing. Loop Step helps control the loop’s position and continuation, while Batch Accumulate gathers outputs from repeated steps.
These tools can help when you want to apply the same process to several items or build an iterative workflow. A simple arrangement is:
For Loop Start → processing nodes → Loop Step → For Loop End
The exact connections and stopping values depend on your workflow. When learning the loop nodes, start with a small number of repetitions so you can inspect the outputs before expanding the process.
Image Tools
The image nodes cover several common preparation and layout tasks:
- Load and arrange images:
Folder Image LoadandLoad Image Batch From Dirload images from directories.Image Batchcombines images;Image Batch To ListandImage List To Batchchange how a collection is represented.Reverse Image Batchchanges its order, andImage Batch Count XYZanalyzes batch image values. - Combine and compare batches:
Image Batch Interleavealternates images from two batches, whileImage Batch Interleave Splitseparates an interleaved batch.Image Grid Tablemakes a grid, which can help you view a set of results together. - Edit placement and appearance:
Image BlendandImage Blend Mask Centercombine images, including mask-based processing.Image Crop and Uncropcrops and restores image placement;Image Padadds space around an image; andImage Transform Rotaterotates or transforms it. - Work in tiles:
Image Tilesplits an image into overlapping pieces, andImage Untilereconstructs the tiled image. These nodes are useful when a later step is designed to work on smaller image areas. - Create visual elements:
Text Imagerenders text as an image.Blockify Maskturns a mask into blocks.
Choose the operation that matches your intended result: padding adds space, cropping selects an area, and tiling divides an image for separate processing.
Mask Tools
Masks identify areas for image-processing steps. Practical-Tools includes Mask Blur for softer edges, Mask Grow for expanding or shrinking a selected area, Mask Fill Holes for filling gaps, and Mask Brightness for adjusting mask brightness. For example, a blurred mask can produce a more gradual transition than a sharply edged one.
For collections of masks, Mask Batch combines them, Mask Batch To List separates a batch into a list, and Repeat Mask Batch repeats one. Mask From Batch extracts masks, while Mask Batch Replace Empty handles empty masks. Is Mask Black checks whether a mask is fully black.
Prompts, Text, and Calculations
Prompt Replace changes text within a prompt, and Text Line To List turns separate lines into a list. These can help you prepare multiple prompt variations without editing every downstream connection. Any To End appends text to a string, and String To Combo converts string data for a combo selection.
Math evaluates expressions using operations and functions such as addition, division, rounding, minimum and maximum values, and square roots. Math Dual evaluates two expressions. These nodes can help calculate dimensions, batch counts, loop conditions, or other numeric settings within a workflow.
Model-Related and External Tools
Lora Load With Trigger loads a LoRA and exposes its trigger words. Krea2 Cond Rebalance adjusts Krea2 conditioning, and Lying Sampler provides a custom sampling option. Max Resolution Filter filters by maximum resolution; Upscale Model Selector selects an upscale model; and RTX Super Resolution provides RTX-based super resolution. ModelScope API is a node for calling the ModelScope API.
These are workflow utilities, not a bundled catalog of image-generation models. The provided documentation does not specify included model files, supported model versions, or recommended settings, so check the node inputs and the models available in your own ComfyUI setup before using them.
Audio and Video
Audio Pass carries audio through a workflow, and Audio Duration reports its duration. Folder Video Concat joins videos from a folder. These are focused utilities rather than a complete audio or video editing suite.
Workspace Enhancements
The extension also changes parts of the ComfyUI interface:
- Runtime Indicator: Shows the currently executing node and execution progress. You can click it to locate a running node; it also supports subgraph and cross-workflow tracking.
- Running Waiting Room: Provides an empty workspace while a large workflow runs, reducing the need to render its full node graph during execution. Click the cup icon in the Runtime Indicator to enter or leave it. The waiting room is created automatically the first time you use it. Its text, font, colors, alignment, background, border radius, padding, and line spacing can be configured in
js/run_indicator_waiting_room_config.js. - Pin Icon: Replaces the default pin icon with a subtler indicator to reduce visual clutter.
- Text Label: Adds editable canvas text for titles, notes, section names, or parameter descriptions.
- Dark Better Theme: Adjusts node and title colors, contrast, and visual hierarchy for a dark workspace.
- Photopea integration: Lets you edit workflow images in Photopea from within the ComfyUI environment. It can help with image corrections, layers, masks, and preparing assets.
- Bookmark: Helps you jump between important nodes or areas in a large workflow.
- UI Performance Tweaks: Reduce unnecessary interface and canvas work, particularly in large workflows.
Troubleshooting ComfyUI-Practical-Tools
The nodes do not appear in ComfyUI
- Confirm that the extension is present in
ComfyUI/custom_nodes/ComfyUI-Practical-Tools/. - Restart ComfyUI after adding the extension.
- Check the ComfyUI startup console for import errors. An error there may explain why a node did not load.
The workspace enhancements do not appear
- Refresh the ComfyUI page. If necessary, try a hard refresh with
Ctrl + F5. - Check the browser console for JavaScript errors if the refresh does not help.
How do I enter or leave the Running Waiting Room?
While a workflow is running, click the cup icon in the Runtime Indicator. The waiting room is created on first use. Click the cup icon again to return to your workflow.
How do I begin using the loop nodes?
Start with a short sequence between the relevant loop-start and loop-end nodes. A while-style sequence uses While Loop Start and While Loop End; a for-style sequence uses For Loop Start, Loop Step, and For Loop End. The connections and continuation values depend on what you are processing, so inspect a small test run before using a larger batch.
Do I need to use every feature?
No. You can add the nodes that solve a particular workflow problem, such as mask cleanup or connection routing, without rebuilding the rest of your workflow around the extension.
Learn More about ComfyUI-Practical-Tools
- ComfyUI-Practical-Tools repository: Browse the extension’s documentation and project files.
- ComfyUI-Practical-Tools releases: Check published releases for version-specific changes. The supplied documentation does not include a version history, so no update timeline is reproduced here.
- ComfyUI: Learn more about the application in which these nodes and workspace features run.
