A first orientation to ComfyUI’s node canvas, workflow graph, model and node panels, execution queue, and saved outputs. Labels vary between versions; this guide uses the current official interface documentation and is not a live UI test.
Less searching.More creating.
Paste an error to find the matching fix, or explore workflows and the files behind them — all in one connected library.
Error logs open the Error Finder (nothing is stored or put in the URL). Anything else runs a search.

What’s new in ComfyUI
Releases, announcements and registry changes from the ComfyUI project.
- April 14, 2025: IPAdapter Plus enters maintenance-only mode
- August 3, 2026: native MiniMax H3 support changes how older API guides should be labeled
- ComfyUI v0.37.2 (opens in a new tab)
- Introducing Comfy Router: One API for Frontier Media Models (opens in a new tab)
- ComfyUI v0.37.1 (opens in a new tab)
- Making the MiniMax H3 Video VAE 2x Faster (opens in a new tab)
Most common first-time problems
The issues new ComfyUI users hit first, and how to get past them.
Identify the format and source of JSON, images or videos before installing nodes and weights. Static inspection helps planning but cannot replace execution in the target environment.
Log keyword: Missing Node Types
Use this guide when an imported workflow contains unresolved nodes or the backend cannot find a node type. Save a workflow copy and its original source first. An unresolved node does not prove that all of its files are missing from the computer.
Log keyword: Value not in list
A saved ckpt_name, lora_name or another selection is absent from the current allowed list. Check the input name first: this validation error can also concern non-file options such as samplers.
Log keyword: CUDA out of memory
Identify the stage that requested GPU memory before reducing the workload. Advertised VRAM, weight-file size and the memory available to this particular task are different quantities.
Log keyword: ModuleNotFoundError
A successful installation in a terminal does not show that ComfyUI uses the same Python. Separate the import name, distribution name and running interpreter before changing dependencies.
Choose how you run ComfyUI
Each route manages Python differently. Pick yours first, then follow the matching guide.
- Windows
- macOS
- Linux
Official Comfy Desktop
Use the official app on supported Windows, Apple silicon Macs or Linux systems; check the requirements for your platform.
- macOS
macOS setup
Choose Desktop or a separate manual Python environment, and match PyTorch to the Mac.
- Browser
- Remote GPU
Cloud or remote GPU
Compare official Comfy Cloud with a self-hosted GPU, container or notebook.
- Windows
Windows Portable
A package with its own Python and ComfyUI folders. Learn which interpreter it uses before installing any dependency.
- Windows
- Linux
- macOS
Manual install (git + venv)
Plan the supported interpreter, device backend and a separate working directory instead of one pip command for every machine.
- Windows
Third-party launcher
An independent reference for a Windows launcher: platform support and precautions before it changes your environment.
After installing
- 01Where to run ComfyUI commands: PowerShell, CMD and virtual environments
- 02ComfyUI interface basics: read the canvas, nodes and queue
- 03Record model downloads by repository, revision, path and integrity evidence
- 04Share ComfyUI model storage without mixing up instances or resource categories
- 05Back up before updating ComfyUI: a source rollback is not an environment rollback
Model families
Which files each family needs, where they go, and a first workflow to run.
Learn by technique
Core image techniques first, then memory, debugging and API integration.
- 01Image-to-image denoise: follow the input image into latent space
Use the official basic image-to-image path to understand how input pixels influence a result. Denoise and seed serve different purposes; there is no single best value for every image.
- 02Inpainting basics: align the mask, original image and model-specific encoding
A painted mask is only part of an inpainting workflow. Check the image, mask interpretation and supported model/encoding path together.
- 03Outpainting versus upscaling: extend the scene or increase its pixel resolution?
A larger image can mean new content beyond the frame or more pixels representing the existing composition. Choosing the wrong workflow may produce the requested dimensions but the wrong content.
- 04Start with ControlNet by inspecting the control image before the output
Identify the expected edge, pose or depth representation and trace how its conditioning reaches the sampler. Different control models are not one universal node.
- 05Add a LoRA to ComfyUI: verify the file and both model/CLIP branches
Start with one compatible LoRA and a controlled comparison. A populated selector does not establish that the sampling path uses the modified weights.
- 06Install a custom node in three stages: code, dependencies and registration
Downloading a repository is only one step. Identify the owning package, satisfy its dependencies and confirm that the running backend actually registers the required class.
- 01Tune a low-memory workflow one load factor at a time
Establish the runnable range of a particular setup, not a universal minimum-VRAM claim derived from a model name.
- 02Isolate custom-node conflicts with a reproducible baseline and binary search
Replace random uninstalling with controlled groups and repeatable input. The goal is the smallest triggering set, not a blanket verdict on all third-party nodes.
- 03Submit a ComfyUI workflow through its native API and track prompt_id
This guide concerns an instance you own or are authorized to use. ComfyUI's native HTTP API is distinct from this site's knowledge MCP and does not authorize access to third-party services.
- 04Retrieve ComfyUI API outputs from task history and /view
After execution, identify which nodes produced results and where those results reside. Node IDs, prompt IDs and filenames are different identifiers.
- 05Integrating ComfyUI into an app: prefer an explicit service boundary
Use an explicit task and result contract instead of assuming an application entry script is a reusable library.
- 06Two GPUs, one active device: distinguish selection, concurrency and memory pooling
Check visible devices and the actual execution path before assuming that multiple GPUs pool memory.
Tools that work in your browser
Diagnose, inspect and connect without installing anything.
- Error FinderPaste a full log and get the troubleshooting articles that match its signature. Nothing is stored.Open
- Workflow JSON InspectorRead a workflow’s nodes and model references locally. No upload, no execution, no automatic installation.Open
- Resource directoryBrowse model families, LoRAs, node packs, nodes and workflows as connected records.Open
- API & MCP accessSearch this library and your bookmarks from an AI client through a scoped MCP connection.Open
Explore the library
Pick a section by what you need to do right now.
Beginner questions
Short answers, each with the full article behind it.
What am I looking at when ComfyUI opens?
A node canvas holding the workflow graph, panels for models and nodes, an execution queue, and saved outputs. Labels vary between versions.
Read the full articleI installed a package, but ComfyUI still says “No module named …”. Why?
A successful install in a terminal does not show that ComfyUI runs the same Python. Check the import name, the package name and the running interpreter — Windows Portable has its own.
Read the full articleWhat should I do about “CUDA out of memory”?
First find the stage that failed — model loading, sampling or VAE decoding — then reduce that load. Advertised VRAM, file size and the memory available to the task are different numbers.
Read the full articleI downloaded a model, but it isn’t in the dropdown.
Check the scanned folder, the file name, which instance is running and any stale saved value. “Value not in list” can also concern non-file options such as samplers.
Read the full articleAn imported workflow shows red missing nodes.
Save a copy first, then tell apart an absent package, a failed import and an unregistered class. A missing node does not prove the files are absent from your computer.
Read the full articleWhy can’t I connect to 127.0.0.1:8188?
localhost means the device making the request. Confirm where ComfyUI actually runs — this machine, a container, a notebook or a remote server — before copying a URL.
Read the full articleShould I reinstall GPU drivers for “Torch not compiled with CUDA enabled”?
Not first. It can mean a CPU-only PyTorch build, or a node assuming CUDA on a non-NVIDIA machine such as a Mac; the fixes differ.
Read the full articleCan several ComfyUI installs share one models folder?
Yes, through the supported extra_model_paths configuration. It shares files only — not Python environments, installed nodes or workflow versions.
Read the full article