Guide 1: How to Install ComfyUI Correctly

Platform support: Windows | Mac (M1/M2/M3) | Linux

#Overview

This guide provides step-by-step installation instructions for ComfyUI across all major platforms. Follow the instructions for your operating system exactly to avoid common setup errors.

Estimated time: 10-15 minutes

#🪟 Windows Installation (Recommended for Beginners)

Method 1: Portable Version (Easiest)

Best for: Beginners, plug-and-play users, anyone who wants zero setup

Step 1: Download ComfyUI Portable

1. →Go to ComfyUI GitHub Releases
2. →Look for the latest release
3. →Download: ComfyUI_windows_portable_nvidia_cu121.7z (or latest CUDA version)

Step 2: Extract the Archive

1. →Right-click the .7z file
2. →Extract to a simple path:
   comfyui-workflow.json

   C:/AI/ComfyUI

❌ Avoid paths with:

• →Spaces (C:\Program Files\ComfyUI)
• →Special characters
• →Very long folder names
• →OneDrive/Cloud synced folders

Step 3: Run ComfyUI

1. →Open the extracted folder
2. →Double-click: run_nvidia_gpu.bat
3. →Wait for the console window to finish loading
4. →Your browser will open automatically to: http://127.0.0.1:8188

✅ Success: You should see the ComfyUI interface with a default workflow

Method 2: Desktop Install (Advanced)

Best for: Developers, power users, those wanting Git integration

Prerequisites

• →Python 3.10 or 3.11 (Download here)
• →Git (Download here)
• →NVIDIA GPU drivers (latest)

Step 1: Clone the Repository

Open Command Prompt or PowerShell:

Step 2: Install Dependencies

Note: Replace cu121 with your CUDA version if different

Step 3: Run ComfyUI

Browser will open to http://127.0.0.1:8188

#🍎 Mac Installation (M1/M2/M3)

Step 1: Install Python

Download Python 3.10 or 3.11 from python.org

Verify installation:

Step 2: Clone ComfyUI

Open Terminal:

Step 3: Install Requirements

Step 4: Run ComfyUI

For M1/M2/M3 optimization:

Browser opens to http://127.0.0.1:8188

#🐧 Linux Installation

Step 1: Update System Packages

Step 2: Clone ComfyUI

Step 3: Install CUDA (NVIDIA GPUs)

Check CUDA version:

Install PyTorch with CUDA:

Step 4: Install Requirements

Step 5: Run ComfyUI

#🚨 Common Installation Errors

Error: "CUDA not available"

Cause: PyTorch installed without CUDA support

Fix:

Error: "ModuleNotFoundError: No module named 'torch'"

Cause: PyTorch not installed

Fix:

Error: "Access Denied" when running .bat file

Cause: Windows security blocking execution

Fix:

1. →Right-click run_nvidia_gpu.bat
2. →Properties → Unblock → Apply
3. →Run as Administrator

Error: Browser doesn't open automatically

Manual access: Open browser and go to: http://127.0.0.1:8188

Error: "Port 8188 already in use"

Cause: Another instance of ComfyUI is running

Fix:

Or specify a different port:

#✅ Verify Installation

After installation, verify ComfyUI is working:

1. →Load default workflow - Should load without errors
2. →Check GPU detection:
   • →Look at console output
   • →Should show: Device: cuda (NVIDIA) or Device: mps (Mac)
3. →Generate a test image:
   • →Use the default workflow
   • →Click "Queue Prompt"
   • →Image should generate successfully

#📁 Folder Structure After Installation

#🔄 Updating ComfyUI

Portable Version

1. →Download the latest portable release
2. →Extract to a new folder
3. →Copy your models/ folder to the new installation
4. →Copy your custom_nodes/ folder

Desktop Install

#🎯 Next Steps

1. →Download models → See Model Folders Guide
2. →Install custom nodes → See Custom Nodes Guide
3. →Optimize performance → See Performance Guide

#🆘 Still Having Issues?

→ See Fix Missing Dependencies
→ See GPU and CUDA Errors
→ Use Troubleshooting Assistant

Need to decide between Portable and Desktop? See: Installation Decision Guide