comfyQol
Quality-of-life tools: open model folders from nodes, one-click download of a workflow's missing models, and unpack subgraphs. Works with Nodes 1 and Nodes 2.
comfyQol
Quality-of-life tools for ComfyUI: open model folders from the node, find the models a workflow is missing and download them in one click, and flatten subgraphs.
Works with both node renderers: Nodes 1 (classic canvas) and Nodes 2 (Vue nodes). It adds no workflow nodes, so it never changes how a workflow runs or saves.
Features
- Missing models, one click. The
comfyQolbutton showscomfyQol · N missingwhen the open workflow needs models you don't have (including models inside subgraphs). The panel lists them with Download and Download all, and a green download button appears beside each missing model on the node. Links come from the workflow's own model metadata (properties.models, which the built-in templates include). Models without a link get Add URL, which fills in the folder and filename so you only paste the link. Each download shows a progress bar with size and speed. When the last one finishes, comfyQol runs ComfyUI's own Refresh Node Definitions (the same as pressing R), so model lists update and ComfyUI's missing-model errors clear without reloading the page. - Dashboard. One movable, resizable window with the workflow's main controls, grouped as Prompt (positive and negative, styles), Models (checkpoint, LoRAs and their strengths), Sampling (steps, CFG, sampler, scheduler), Generation (seed with a random button, width/height, batch), Refinement (denoise, upscale, detailer) and Output (filename prefix, format). Includes controls inside subgraphs and skips bypassed nodes. Edits go straight to the nodes and the other way round. It has its own Run button and stays open across reloads.
- Free VRAM. Unloads every model and clears ComfyUI's cache (the same as ComfyUI's
/freeAPI), so the GPU is free for other programs. The panel shows current VRAM use. If a run is in progress, memory is freed when it finishes. - Output manager (off by default; turn it on under Advanced). An Outputs gallery of your output folder: select several images and download them as separate files (no ZIP), or save them all into a folder you pick. Right-click any output image (node previews, the queue, the gallery) and choose Save As… to pick the filename and folder. Shift+right-click still opens the browser's own menu.
- Folder icons beside model pickers (
unet_name,clip_name,vae_name,ckpt_name,lora_name, ControlNet, upscale, CLIP vision, style) open the folder that holds that model, searching all of ComfyUI's configured model folders. On Windows the folder opens in front of the browser, on the same monitor. - Subgraph-aware. Icons and menu items work on promoted widgets on a subgraph node and on loaders nested inside it.
- Unpack Subgraphs flattens every subgraph (including nested ones) back into the workflow, keeping all nodes and links. Remove Subgraphs deletes them instead.
- Download any model from a URL into a chosen model folder, with progress. Partial files
are kept as
.partuntil complete, and model lists refresh when a download finishes. - The panel shows only missing models and downloads. Everything else (open the input, output, and custom_nodes folders, download from any URL, subgraph tools, copy selected model names) is under Advanced.
- The
comfyQolbutton and panel can be dragged anywhere and remember their position. Everything is also under Extensions → comfyQol in the top menu, including Reset Button Position. Right-click a node or the canvas for comfyQol menu items.
Install
With git, from your ComfyUI/custom_nodes folder:
git clone https://github.com/emperorofrome13/comfyQol
Or download the ZIP from GitHub, extract it, and place the folder at
ComfyUI/custom_nodes/comfyQol (for the Windows portable build:
ComfyUI_windows_portable/ComfyUI/custom_nodes/comfyQol).
With ComfyUI-Manager: Install via Git URL and paste the repository URL.
Restart ComfyUI. The comfyQol button appears at the bottom right, above the canvas toolbar.
No extra Python packages are needed.
Compatibility
Tested on ComfyUI 0.40 and 0.42 (frontend 1.55) in both Nodes 1 and Nodes 2 mode. Older ComfyUI versions load it too; subgraph features need a frontend that has subgraphs. Third-party loader nodes are covered when their model widgets use the standard names above, or when the selected value ends in a model file extension (for the menu items).
Security
comfyQol adds server routes that open folders on the machine running ComfyUI and download
files into its model folders. Anyone who can reach your ComfyUI server can use them, the same
as the rest of ComfyUI's API. If you run ComfyUI with --listen on a shared network, keep
that in mind. Downloads only accept http:///https:// URLs, and folder and file names are
checked so they stay inside ComfyUI's model folders.
Limitations
- comfyQol does not search the web for models whose workflow has no download link.
- Gated/login-only downloads (some Hugging Face and Civitai models), resume, and cancel are not supported yet. Download history is kept in server memory until restart.
- Folder windows open on the computer running ComfyUI, not the one with the browser.
- Save As and Save to Folder use the browser's file dialogs, which Chrome and Edge allow on
localhost. In other browsers, or over a LAN address, comfyQol asks for a filename and uses a normal browser download instead. - The Dashboard recognises common widget names (
seed,steps,cfg,text,lora_name, …). Custom nodes with unusual widget names may not appear there.
Development
From the comfyQol folder inside a ComfyUI install (or set COMFYUI_PATH to the ComfyUI folder):
python tests/test_paths.py
node tests/test_extension.cjs
License
MIT. See LICENSE.