Skip to content
,

ComfyUI Guide for Beginners (2026): Install, Models, Nodes, Settings and Fixes

12–18 minutes
Woman at a PC desk with a node graph on the monitor holding a tablet with a ComfyUI card, hook ComfyUI from zero to pro

ComfyUI is the most powerful free way to run image, video and audio AI models on your own PC, and also the most confusing one to start with. You get a canvas of boxes and wires, a models folder with fifteen subfolders, and an error log that only makes sense once you know where to look. I have written a separate deep guide for each part of it. This page puts them in the order you need them, gives you the short answer for each step, and links to the full walkthrough when you want the details.

TL;DR

  • Install: Comfy Desktop from comfy.org for beginners, the Windows portable build for a self-contained folder, or git clone + pip install -r requirements.txt on Linux. Python 3.13, PyTorch cu130 on NVIDIA.
  • Open: http://127.0.0.1:8188, then Workflow > Browse Templates to start from a working graph.
  • Models: split models go in models/diffusion_models, models/text_encoders and models/vae; LoRAs in models/loras. Press R to refresh.
  • Manager: built in now. Portable/manual: pip install -r manager_requirements.txt, start with --enable-manager.
  • Low VRAM: use fp8 or GGUF files before you reach for flags.
  • Something broke: read the first red traceback in the terminal; start with --disable-all-custom-nodes to rule out a bad node.

What Is ComfyUI?

ComfyUI is a free, open-source app that runs diffusion and other generative models through a node graph. Each box (node) does one job: load a model, encode a prompt, sample, decode, save. You wire them together into a workflow and press Run. It runs in your browser, but everything happens locally on your GPU.

Why people put up with the learning curve:

  • New models land here first. FLUX, Qwen-Image, Wan, LTX, MOSS-Image and MiniMax H3 usually get native ComfyUI support on day one or within a week.
  • You see and control every step. Swap a loader, add a LoRA, upscale, inpaint or chain image-to-video in one graph.
  • Workflows are portable. A PNG made in ComfyUI carries its whole workflow, so you can drag someone’s image in and get their exact setup.
  • It is free and private. No credits, no uploads, and it works offline once the models are downloaded.

What it is not: a one-button app. If you want a simple chat-style image generator, the cloud tools are easier. If you want control and the newest open models, ComfyUI is worth an afternoon.

The ComfyUI Roadmap: Which Guide Do You Need?

I want to… Read this guide Short answer
Install ComfyUI How to Install ComfyUI on Windows, Mac and Linux Desktop for beginners, portable for a folder, git for Linux
Set up an RTX 50 card ComfyUI on RTX 50 Series Current portable works as is; R580+ driver, no xformers
Use an AMD GPU AMD GPU for AI: ROCm, Ollama and ComfyUI ROCm on Windows or Linux
Rent a GPU instead How to Run ComfyUI on RunPod Official template + network volume for models
Know where model files go ComfyUI Model Folder Cheat Sheet diffusion_models, text_encoders, vae, loras
Install the Manager How to Install ComfyUI Manager Built in; enable with --enable-manager
Pick custom nodes Must-Have ComfyUI Custom Nodes rgthree, VideoHelperSuite, KJNodes, Crystools, GGUF
Choose a sampler Samplers and Schedulers Explained Flow models: euler + simple; SDXL: dpmpp_2m + karras
Use launch flags ComfyUI Command Line Arguments --use-sage-attention, --reserve-vram, --listen
Go faster Install SageAttention on Windows Prebuilt 2.2 wheel, about 30% faster
Run GGUF models How to Use GGUF Models in ComfyUI ComfyUI-GGUF + Unet Loader (GGUF)
Compare fp8 and GGUF ComfyUI-GGUF Guide: fp8 vs GGUF fp8 if it fits on RTX 40/50, GGUF if not
Use two GPUs ComfyUI Multi-GPU Guide Split models or run two instances
Know how much RAM I need How Much RAM Do You Need for Local AI? 32 GB minimum, 64 GB for video
Save and share workflows Save, Export and Share ComfyUI Workflows Ctrl+S, Export (.json), or the PNG itself
Run workflows from code ComfyUI API Guide (Python) Export (API) JSON, POST /prompt, WebSocket
Update safely How to Update ComfyUI Safely Snapshot first; git pull + pip install
Fix an error ComfyUI Errors and Fixes (22 errors) Read the first red traceback
Fix “Reconnecting” ComfyUI Stuck on Reconnecting Usually RAM, VRAM or a broken node
Fix out of memory CUDA Out of Memory Fix Smaller files, lower resolution, tiled VAE

Step 1: Install ComfyUI

Option Best for How
Comfy Desktop Beginners on Windows and macOS Download from comfy.org, choose Local, let it set up Python. Manager included.
Windows portable A self-contained folder you can move or copy Extract ComfyUI_windows_portable_nvidia.7z with 7-Zip, run run_nvidia_gpu.bat
Manual (git) Linux, developers, servers git clone, install PyTorch for your GPU, pip install -r requirements.txt, python main.py
Cloud (RunPod) No GPU, or you need 48-80 GB for a day Official template with a network volume. RunPod guide

Use Python 3.13 and, on NVIDIA, PyTorch built for CUDA 13.0 (cu130) with a current driver. Full steps for every option are in my ComfyUI install guide. RTX 50 owners should also read the RTX 50 setup guide, mainly to avoid installing xformers, which can pull in the wrong PyTorch.

Step 2: Check Your GPU and RAM

VRAM What runs well Tips
6-8 GB SD 1.5, SDXL, small FLUX/Qwen GGUF quants (Q4), short low-res video GGUF model + GGUF text encoder, about 1 MP
12 GB FLUX, Qwen-Image, MOSS-Image in fp8/INT8 or Q5-Q6 GGUF The RTX 3060 12 GB is still the budget pick
16 GB Most image models comfortably, Wan and LTX video with fp8 or GGUF Q8_0 GGUF or fp8; SageAttention for video
24-32 GB Full-precision image models, longer and higher-res video RTX 3090/4090/5090; NVFP4 on RTX 50

System RAM matters more than people expect, because ComfyUI parks models in RAM when it swaps them out of VRAM. Treat 32 GB as the minimum and 64 GB as the comfortable size for video. If the terminal closes or prints Killed while a model loads, you ran out of RAM, not VRAM. See how much RAM you need and, for two cards, the multi-GPU guide.

Step 3: Put Models in the Right Folders

Most “model not found” problems are a file in the wrong folder. Modern models are split into three parts, each with its own folder and loader.

File type Folder Loader node
All-in-one checkpoint (SD 1.5, SDXL) ComfyUI/models/checkpoints/ Load Checkpoint
Diffusion model (FLUX, Qwen-Image, Wan, MOSS, H3) ComfyUI/models/diffusion_models/ Load Diffusion Model
Text encoder (T5, Qwen, Gemma) ComfyUI/models/text_encoders/ Load CLIP / DualCLIPLoader
VAE ComfyUI/models/vae/ Load VAE
LoRA ComfyUI/models/loras/ LoraLoaderModelOnly / Load LoRA
GGUF model ComfyUI/models/unet/ or diffusion_models/ Unet Loader (GGUF)
Upscaler ComfyUI/models/upscale_models/ Load Upscale Model
ControlNet ComfyUI/models/controlnet/ Load ControlNet Model

After copying a file, press R in ComfyUI to refresh the dropdowns. Subfolders are fine; they show up as a path in the menu. If you run several installs, share one models folder with extra_model_paths.yaml instead of copying 200 GB around. The full list is in the model folder cheat sheet.

Step 4: Make Your First Image

  1. Open http://127.0.0.1:8188 in your browser.
  2. Go to Workflow > Browse Templates and pick a text-to-image template for a model you have (or that the template offers to download).
  3. Check each loader points at a file you actually have. A red outline or “Value not in list” means a missing file.
  4. Type a prompt in the positive text box. Keep the template’s steps, CFG and sampler for your first run.
  5. Click Run and watch the terminal: it shows each model loading and the sampling progress.
  6. Find the result in ComfyUI/output/ or the queue sidebar.

The key nodes you will see in almost every image workflow are: a model loader, a text encoder (CLIP Text Encode), an empty latent (your image size), KSampler, VAE Decode and Save Image. Once you know those six, most workflows stop looking scary.

Step 5: Add the Manager and Custom Nodes

Custom nodes add features ComfyUI does not ship with: video loading, GGUF support, face detailers, live VRAM monitors and more. The Manager installs and updates them.

  • Desktop: the Manager is already on.
  • Portable: .\python_embeded\python.exe -m pip install -r ComfyUI\manager_requirements.txt, then add --enable-manager to run_nvidia_gpu.bat.
  • Manual: pip install -r manager_requirements.txt, then python main.py --enable-manager.

When you load a workflow with red nodes, click Install All in the missing-nodes prompt, then restart ComfyUI fully. My first five installs on any new setup are rgthree-comfy, ComfyUI-VideoHelperSuite, ComfyUI-KJNodes, ComfyUI-Crystools and ComfyUI-GGUF.

Safety: custom nodes are Python code that runs on your PC. Keep the Manager security level on normal, prefer popular maintained packs, and never set it to weak on a server reachable from the internet. Details: Manager guide and must-have custom nodes.

Step 6: Samplers, Flags and Speed

Model type Sampler / scheduler Steps and CFG
Flow models (FLUX, Qwen-Image, MOSS, Krea, Wan, H3) euler + simple (or beta) Use the template’s values
SD 1.5 and SDXL dpmpp_2m + karras 20-30 steps, CFG 5-7
Turbo, Lightning, LCM, distill LoRAs euler or lcm (per model card) LoRA’s step count, CFG 1

CFG above 1 doubles the work per step, which is why distilled 4-8 step models use CFG 1. “Ancestral” and “SDE” samplers add noise every step, so the image keeps changing as you change the step count. More in samplers and schedulers explained.

Launch flags go at the end of the python main.py line or in run_nvidia_gpu.bat. The useful ones:

  • --use-sage-attention: faster attention once SageAttention is installed (about 30-35% on video). Install guide; never use plain pip install sageattention on Windows.
  • --reserve-vram 1.5: leaves room for your browser and other apps, which stops many random OOMs.
  • --listen: open ComfyUI from another device on your network.
  • --preview-method auto: live previews while sampling.
  • --disable-all-custom-nodes: the fastest way to test whether a node broke ComfyUI.

Modern ComfyUI manages VRAM on its own, so --lowvram does little on most NVIDIA cards now. The full list is in the command line arguments cheat sheet.

Step 7: Run Big Models on Small GPUs

Smaller files beat any flag. In order of what helps most:

  1. Use fp8 or INT8 files where the model offers them. They load with the normal nodes and run fast on RTX 40/50.
  2. Use GGUF when even fp8 does not fit: install ComfyUI-GGUF, swap Load Diffusion Model for Unet Loader (GGUF). Q8_0 is close to full quality, Q5_K_S or Q4_K_S for 8-12 GB. GGUF guide
  3. Shrink the text encoder too. A GGUF T5 or Qwen encoder saves several GB with almost no visible change.
  4. Lower resolution or frame count, and use VAE Decode (Tiled) for big images and video.
  5. On RTX 50, try NVFP4 models: one published FLUX.1 Dev test showed 7.73 it/s vs 4.21 it/s for FP8 on an RTX 5090.

For MiniMax H3, Krea 2, Ideogram 4 and Qwen-Image 2.1 GGUFs, use the leejet/ComfyUI-GGUF fork rather than city96’s original, and never install both. If you still hit OOM, the CUDA out of memory fix walks through the rest.

Step 8: Save, Share and Automate Workflows

  • Save (Ctrl+S) keeps the workflow inside ComfyUI, in ComfyUI/user/default/workflows/.
  • Export downloads a .json you can back up or share.
  • The PNG is the workflow. Images from Save Image carry the full graph in their metadata; drag one onto the canvas to load it. Discord, X and most chat apps strip that metadata, so share the JSON instead.
  • Export (API) gives the compact format for scripts. Send it to POST /prompt and listen on the WebSocket for progress and images.

Guides: save, export and share workflows and the ComfyUI API from Python.

Step 9: Update Without Breaking Things

Install How to update
Desktop Manage > Update tab > Update Now (or Copy & Update to test on a copy)
Portable update\update_comfyui.bat (latest) or update_comfyui_stable.bat; skip the dependencies script unless something is broken
Manual Activate the venv, git pull, then pip install -r requirements.txt (skipping pip is the top cause of “update did not work”)

Take a Manager snapshot first, update custom nodes after ComfyUI, and restart fully. If an update breaks something, restore the snapshot. New models usually need the latest build, so if a template will not load or a model says “unknown architecture”, updating is the first fix. Full steps, rollback and uninstall: how to update ComfyUI safely.

What to Build Next

Once the basics work, these hubs and guides take you further:

Common Problems and Fixes

Problem Fix
Red nodes when loading a workflow Manager > Install Missing Custom Nodes, then restart fully
“Value not in list” The model file is missing or in the wrong folder; move it and press R
“CUDA out of memory” Smaller file (fp8/GGUF), lower size, VAE Decode (Tiled), --reserve-vram 1.5
“mat1 and mat2 shapes cannot be multiplied” or “expected 4 channels, got 16” Mismatched text encoder, VAE, LoRA or ControlNet for that model
“Error while deserializing header” Broken download; download the file again
Stuck on “Reconnecting” Backend crashed: check the terminal for RAM (Killed), VRAM or a custom node traceback
Terminal closes while loading a model Out of system RAM; raise the Windows page file to 32-64 GB or add RAM
“No module named …” after installing a node Installed into the wrong Python; use python_embeded\python.exe -m pip on portable
“Unexpected architecture type in GGUF file” Update ComfyUI-GGUF, or use the leejet fork for newer models
New template or node missing after update Run pip install -r requirements.txt; the frontend ships as a separate package
Everything broke after installing a node Start with --disable-all-custom-nodes, then re-enable packs one at a time

The full list of 22 errors with causes is in ComfyUI errors and fixes, and the browser-side issues are in the reconnecting fix.

Frequently Asked Questions

Is ComfyUI free?

Yes. ComfyUI is free and open source, and running models locally costs nothing beyond electricity. Comfy also sells optional cloud and API features, which you do not need.

Is ComfyUI hard to learn?

The first hour is the hardest. Start from the built-in templates instead of an empty canvas, learn the six core nodes, and it gets much easier quickly.

What GPU do I need for ComfyUI?

An NVIDIA card with 8 GB of VRAM runs SDXL and small GGUF quants of modern models. 12-16 GB is the sweet spot for FLUX, Qwen-Image and video with fp8 or GGUF. AMD works through ROCm, and Macs work but are slower.

Can I run ComfyUI without a GPU?

It runs on CPU with --cpu, but it is very slow. A rented cloud GPU such as RunPod is a better option if you have no graphics card.

Where does ComfyUI save images?

In ComfyUI/output/ by default. Saved workflows go in ComfyUI/user/default/workflows/.

Is ComfyUI safe?

ComfyUI itself is safe. The risk is custom nodes, which run code on your PC, so install popular maintained packs and keep the Manager security level on normal.

ComfyUI Desktop or portable?

Desktop is easier and updates itself. Portable is a single folder you fully control and can copy as a backup. Both run the same ComfyUI.

Final Thoughts

Install it, put three model files in the right folders, run a template and get one good image. Then add the Manager, a GGUF loader and SageAttention, and you can run almost any new open model the week it comes out. When something breaks, the terminal almost always tells you why. I keep this page updated as I add ComfyUI guides, so bookmark it.

Sources

Free weekly email

Get new AI guides every week

One short weekly email with our newest local AI, ComfyUI and AI tool guides. No spam, no pop-ups, just the good stuff.

Free. Unsubscribe anytime in one click. We only use your email to send this newsletter. See our privacy policy.

Woman at a PC desk with a node graph on the monitor holding a tablet with a ComfyUI card, hook ComfyUI from zero to pro