Skip to main content

Install ComfyUI (2026): The Setup Guide That Actually Works

How to install ComfyUI in 2026: Desktop, Windows portable or manual install, the requirements for each, and the fix for every common install error.

Founder of IImagined.ai

Published
Feb 12, 2026
Updated
Oct 7, 2026
Reading time
11 min read
Quick answer

To install ComfyUI, download Comfy Desktop from comfy.org/download, run the installer, confirm your GPU and pick a starter template; it bundles Python and ComfyUI-Manager. Use the Windows portable build if you want the newest commits in one folder, or a manual git install for Linux servers and unusual GPUs. Most failed installs come down to the wrong PyTorch build, an old NVIDIA driver, a missing model file or a broken custom node, and each has a quick fix.

To install ComfyUI, download Comfy Desktop from comfy.org/download, run the installer, confirm your GPU type, choose an install folder on an SSD and pick a starter template. Desktop bundles its own Python and ComfyUI-Manager, so on a supported Windows, Apple Silicon Mac or Linux machine there is nothing else to set up.

Checked October 2026 against Comfy's system requirements, Desktop for Windows, portable and manual install guides, the ComfyUI README and the latest release (v0.39.0, October 5, 2026).

This guide is built around what goes wrong. Each install path below lists its requirements, the steps, and the errors that path actually produces, with the fix. ComfyUI is the engine behind most of the workflows in our AI image generation for influencers guide; if you are not sure ComfyUI is the right tool yet, read what ComfyUI is first.

ComfyUI requirements: check these first

Pre-flight checklist
  • Windows 10 or later, macOS on Apple Silicon (M1 or newer), or Linux
  • NVIDIA, AMD, Intel Arc or Apple Silicon GPU (CPU-only works but is slow)
  • An up-to-date GPU driver; NVIDIA 20 series and newer need a CUDA 13.0 PyTorch build
  • An SSD with room for the app plus models, which often run 2 GB to 15 GB or more each
  • Google Chrome 143 or later (Comfy lists glitches in 142 and older)
  • For manual installs only: Git and Python 3.13 (3.12 as fallback)

Comfy publishes no fixed VRAM minimum. The README says ComfyUI can run even the biggest open models on as little as 4 GB of VRAM plus 8 GB of RAM by streaming weights; more VRAM still means faster runs. If your machine falls short, our ComfyUI cloud vs local comparison covers renting a GPU instead.

Which ComfyUI install should you use?

MethodPlatformsBest for
Comfy DesktopWindows 10+, macOS on Apple Silicon, Linux (AppImage, .deb)Beginners. Bundled Python, ComfyUI-Manager, one-click updates, tracks the stable release
Windows PortableWindows (NVIDIA, AMD, Intel builds)Newest commits in one self-contained folder; Comfy says not for regular users
Manual (git) installWindows, Linux, macOSFull control, Linux servers, less common GPUs; you manage Python and PyTorch
comfy-cliWindows, Linux, macOSScripted installs: pip install comfy-cli, then comfy install
Comfy CloudBrowserNo local GPU; paid hosted service
Desktop or portable?
Pick Desktop if
  • This is your first install
  • You want updates and snapshots handled for you
  • You use a Mac or Linux desktop
  • You want ComfyUI-Manager ready out of the box
Pick portable or manual if
  • You want every latest commit
  • You run several separate installs side by side
  • You are on a Linux server or unusual GPU
  • You are comfortable with a terminal and pip

How to install ComfyUI Desktop (recommended)

Comfy Desktop, start to first template
  1. 1
    Download

    From comfy.org/download: installer for Windows, .dmg for Apple Silicon Macs, AppImage or .deb for Linux.

  2. 2
    Run the installer

    It detects your GPU and asks you to confirm the type. Expected: your NVIDIA, AMD or Apple GPU is listed.

  3. 3
    Choose the location

    On Windows use an SSD and not the root of C:. Keep the Standalone option, which bundles Python.

  4. 4
    Bring old installs along (optional)

    Add Existing Instance tracks a portable or git install you already have.

  5. 5
    Pick a template

    Desktop opens the template library and downloads the models the workflow needs. Expected: the graph loads with no red nodes.

Desktop keeps shared models in %LOCALAPPDATA%\Comfy-Desktop\ComfyUI-Shared on Windows and ~/ComfyUI-Shared on macOS and Linux; add folders under Settings, Storage. To update ComfyUI, open Manage on the installation, then the Update tab (Stable is the default channel). See Comfy's instance management docs.

Desktop errors and fixes

  • GPU not detected: update the GPU driver and rerun the installer; Desktop checks for a recent NVIDIA driver.
  • Port busy: another ComfyUI is running. Close it, or use the If Port is Busy setting to pick the next free port.
  • A template shows missing models: let Desktop download them, or put each file in the matching folder with its exact original name.

ComfyUI install on Windows: the portable build

The portable build is a folder with its own embedded Python. Download the archive for your GPU from the latest release:

  • ComfyUI_windows_portable_nvidia.7z: GeForce 20 series and newer, with Python 3.13 and CUDA 13.0.
  • ComfyUI_windows_portable_nvidia_cu126.7z: GeForce 10 series and older only, with Python 3.12 and CUDA 12.6.
  • ComfyUI_windows_portable_amd.7z or ComfyUI_windows_portable_intel.7z for AMD and Intel GPUs.
Portable install
  1. 1
    Extract the archive

    With 7-Zip or Windows Explorer, to a short path on an SSD. If it fails, right-click the file, Properties, Unblock.

  2. 2
    Start it

    Run run_nvidia_gpu.bat, run_amd_gpu.bat or run_intel_gpu.bat. Expected: a console window, then ComfyUI at http://127.0.0.1:8188.

  3. 3
    Add models

    Into ComfyUI\models\checkpoints and the other model folders, then restart.

  4. 4
    Update

    update\update_comfyui_stable.bat for the stable release or update_comfyui.bat for the latest commit.

Keep update_comfyui_and_python_dependencies.bat for repairing broken dependencies only, because it reinstalls every Python package. To turn on ComfyUI-Manager in the portable build, run these from the portable folder (also covered in our ComfyUI-Manager guide):

.\python_embeded\python.exe -m pip install -r ComfyUI\manager_requirements.txt
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --enable-manager

Manual install on Windows, Linux or macOS

You need Git and Python 3.13. On Windows, install the Microsoft Visual C++ Redistributable first. Comfy's guide uses Conda; a standard venv works too:

git clone https://github.com/Comfy-Org/ComfyUI.git
cd ComfyUI
python -m venv venv
# Windows
venv\Scripts\activate
# Linux or macOS
source venv/bin/activate

Install the PyTorch build for your GPU before anything else, using the README commands:

# NVIDIA (CUDA 13.0)
pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu130
# AMD on Linux (ROCm 7.2)
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/rocm7.2
# Intel Arc (XPU)
pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/xpu

AMD on Windows uses AMD's ROCm 10.0 multi-architecture packages for RDNA 2 to RDNA 4; copy the exact command from the README, because its version pins change. On an Apple Silicon Mac, install the latest PyTorch nightly as the manual install guide describes. Then install ComfyUI's dependencies and start it:

pip install -r requirements.txt
python main.py

Expected result: the console prints the device it found and a local address; open http://127.0.0.1:8188. Check the GPU is in use with python -c "import torch; print(torch.cuda.is_available())" on NVIDIA. Prefer a single command? pip install comfy-cli followed by comfy install does the same job.

Every common ComfyUI install error and its fix

Find your message in the first column. The fixes come from Comfy's troubleshooting overview, model issues and custom node issues pages, and the README.

ErrorInstall typeFix
"Torch not compiled with CUDA enabled"ManualCPU-only PyTorch. pip uninstall torch, reinstall with the cu130 command
Portable will not start on NVIDIAPortableUpdate the NVIDIA driver; GeForce 10 series needs the cu126 package
c10.dll error on startPortable, manualInstall the Microsoft Visual C++ Redistributable (the launcher prints the link)
Archive will not extractPortableRight-click the .7z, Properties, Unblock; or use 7-Zip
"CUDA out of memory"AllLower resolution or batch, close GPU apps, use smaller files, add --reserve-vram 2, then --novram
"Value not in list: ckpt_name"AllModel missing or renamed; put it in the right folder with its original name and restart
"Error while deserializing header"AllCorrupted or partial download; download the model again
Custom node shows (IMPORT FAILED)AllStart with --disable-all-custom-nodes, then re-enable half at a time to find it
"unrecognized arguments: --normalvram"Portable, manualFlag removed in May 2026; delete it from your launch script
Port 8188 already in useAllAnother copy is running; close it or start with --port 8189

On memory errors: on NVIDIA GPUs with PyTorch 2.8 or newer, current ComfyUI turns on dynamic VRAM and logs "DynamicVRAM support detected and enabled". In that mode --lowvram does nothing, so go from --reserve-vram 2 straight to --novram, and use --cpu only as a last resort. Only use --listen on a network you trust, because it exposes ComfyUI to other devices.

Notes for Mac and Linux installs

Apple Silicon Macs. Desktop is the simplest route. ComfyUI does not use Apple's MLX framework; it runs PyTorch with the MPS (Metal) backend, according to Comfy's system requirements FAQ. Intel Macs are not a supported Desktop target, so they need a manual install and will be slow. Unified memory is shared between the system and the GPU, so close heavy apps before large generations.

Linux. Desktop ships as an AppImage or a .deb. On servers and headless machines, a manual install inside a venv is the usual choice: install the PyTorch build for your GPU, then requirements.txt, then start python main.py. To reach it from another machine, add --listen only on a private network, or tunnel the port over SSH instead of exposing it.

Reusing models from AUTOMATIC1111 or Forge

You do not need to copy gigabytes of models. In a portable or manual install, rename extra_model_paths.yaml.example in the ComfyUI folder to extra_model_paths.yaml, remove the # signs from its a1111 block, set base_path to your stable-diffusion-webui folder and restart. Desktop users add the same folders under Settings, Storage. Restart ComfyUI after adding any model file, because it scans folders at startup.

Updating, repairing and uninstalling

  • Desktop: the app updates itself; update ComfyUI from Manage, then Update. Snapshots let you roll back if an update breaks a custom node.
  • Portable: run the stable update script and keep the dependency script for repairs. To uninstall, delete the folder after copying out models and output.
  • Manual: pull the latest code in the ComfyUI folder, then run pip install -r requirements.txt inside the same environment. To uninstall, delete the folder and its venv.

Before any update, note which custom nodes you rely on. Most post-update breakages are a custom node that has not caught up, and the --disable-all-custom-nodes test from the error table tells you within a minute whether that is the cause.

Generate your first image (the install test)

Prove the install works
  1. 1
    Open the default workflow

    Or Workflow, Browse Workflow Templates.

  2. 2
    Get the model

    The default graph uses v1-5-pruned-emaonly-fp16.safetensors (about 2.1 GB). Save it to ComfyUI/models/checkpoints if ComfyUI does not.

  3. 3
    Check Load Checkpoint

    It should show that file name, with no red outline.

  4. 4
    Run

    Click Run or press Ctrl + Enter. Expected: a 512 x 512 image in Save Image, saved to ComfyUI/output.

If that works, the install is done. Put files in the right folders from here: checkpoints for all-in-one models such as SD 1.5 and SDXL, diffusion_models for Flux, Qwen-Image and Wan, text_encoders, vae and loras. Download .safetensors where you can, since older .ckpt and .pt files can run code when loaded. Our best ComfyUI models guide lists what to download next.

For an AI influencer, the next steps are a consistent face and then motion: our face LoRA training guide covers the first. The AI Influencers course includes the ComfyUI workflows we use for persona images and video, ready to load once your install passes the test above.

Installing ComfyUI: FAQ

What is the easiest way to install ComfyUI?

Comfy Desktop. Download it from comfy.org/download, run the installer, confirm your GPU type, choose an install folder on an SSD and pick a starter template. It bundles its own Python, includes ComfyUI-Manager and handles updates. Comfy's own README calls it the easiest and best way for new users, and recommends it over the portable build for regular users.

Is ComfyUI free to download?

Yes. ComfyUI is open source under the GPL-3.0 licence and free to download and run on your own hardware, from comfy.org/download for Desktop or the GitHub releases page for the Windows portable build. Comfy Cloud, the official hosted version, is a separate paid service. Avoid third-party download sites; use only comfy.org and the Comfy-Org GitHub repository.

Which Python version does ComfyUI need?

Only manual installs need you to install Python. Comfy's docs call Python 3.13 very well supported and recommended, 3.12 a good fallback when a custom node has dependency trouble, and 3.14 workable with some custom node issues. Comfy Desktop and the Windows portable build ship their own Python, so do not install another one for them.

Can I install ComfyUI without an NVIDIA GPU?

Yes. ComfyUI supports AMD GPUs through ROCm (7.2 on Linux, 10.0 on Windows for RDNA 2 to RDNA 4), Intel Arc through PyTorch XPU and Apple Silicon Macs through Metal. There are separate Windows portable builds for AMD and Intel. CPU-only mode works with the --cpu flag but is very slow for anything beyond tests.

How much VRAM do I need for ComfyUI?

Comfy publishes no fixed minimum. Its README says ComfyUI can run even the biggest open models on as little as 4 GB of VRAM plus 8 GB of RAM, relatively quickly, by streaming weights. More VRAM still means faster runs and fewer workarounds, and single model files often range from about 2 GB to more than 15 GB.

Why does ComfyUI say "Torch not compiled with CUDA enabled"?

PyTorch was installed without GPU support, which happens when pip pulls the default CPU build in a manual install. Uninstall torch, then reinstall with the CUDA 13.0 command from the ComfyUI README. Running python -c "import torch; print(torch.cuda.is_available())" should then print True. Desktop and portable builds avoid this by shipping the right PyTorch.

Does ComfyUI include ComfyUI-Manager?

Comfy Desktop installs and enables it for you. Portable and manual installs include it in the core but switched off: install manager_requirements.txt with the same Python that runs ComfyUI, then launch with the --enable-manager flag. After that, an Extensions button in the top bar opens it.

All Access · all four programs · $99/mo

ComfyUI installed. Now make something with it.

All Access includes the AI Influencers program, with ready-to-load ComfyUI workflows for consistent characters, LoRAs and video, plus the other three programs, live coaching and the private community.

Start All Access — $99/mo →30-day money-back guarantee
Free · no signup

Install still failing? Ask in the free Discord

Post your error message in the free Discord and compare fixes with other ComfyUI users.