To set up ComfyUI, visit the official GitHub repository for detailed installation instructions. The setup involves choosing between command line installation and package installation.
Command Line Installation:
- Install Git and Python 3.10.6, then add Python to your environment path.
- Clone the ComfyUI repository using ‘git clone https://github.com/comfyanonymous/ComfyUI.git’.
- Navigate to the cloned directory and create a virtual environment with ‘python -m venv venv’.
- Activate the virtual environment using ‘\venv\Scripts\activate’ for Windows or ‘source venv/bin/activate’ for macOS and Linux.
- Install required packages with ‘pip install -r requirements.txt’.
Package Installation:
- Download and unzip the official or third-party integrated package.
- Unzip the package to a local directory.
- Run ‘run_cpu.bat’ for CPU or ‘run_nvidia_gpu.bat’ for NVIDIA GPU to start ComfyUI.
- Access the GUI via the provided URL, such as ‘http://0.0.0.0:8188’.
Troubleshooting and Optimization:
- Regularly update ComfyUI using ‘git pull’ and ‘pip install -r requirements.txt’.
- Ensure proper hardware configuration for optimal performance.
- Use third-party packages like Aaaki for additional functionalities and language support.
Key Takeaways
- Download Package: Visit ComfyUI’s GitHub repository and click the direct download link.
- Unzip Files: Extract contents using 7-Zip, ensuring the unzipped files match the ComfyUI structure.
- Start ComfyUI: Run ‘run_cpu.bat’ or ‘run_nvidia_gpu.bat’ based on GPU, and access the GUI via the provided URL.
Downloading the Official Installer

Downloading ComfyUI Official Installer
Visit the ComfyUI official GitHub repository to find detailed installation instructions for various systems, including Windows, Mac, Linux, and Jupyter Notebook.
The direct download link for the integrated package is located in the ReadMe section.
Navigate to the repository, and in the ReadMe section, click on the blue link to download the official integrated package. Use a reliable unzipping software, such as 7-Zip, to extract the contents to your desired installation directory.
Ensure the unzipped files match the ComfyUI File Directory structure.
For optimal extraction performance, it’s advisable to extract files to a folder close to the root of the drive to avoid path length issues.
Starting ComfyUI
After unzipping, run ‘run_cpu.bat’ or ‘run_nvidia_gpu.bat’ based on your GPU type to start ComfyUI.
Ensure a stable internet connection for the first run, which may involve downloading configuration files.
Check the official documentation for specific hardware requirements, such as an Nvidia GPU with at least 4GB VRAM and 8GB system RAM, to guarantee smooth installation and operation.
System Requirements
- Nvidia GPU: At least 4GB VRAM
- System RAM: 8GB or more
For smoother performance, using an SSD with at least 40GB hard disk space is highly recommended for loading and running model files.
Installing ComfyUI Locally

Installing ComfyUI Locally
Local installation of ComfyUI can be done through two primary methods: command line installation and package installation.
Command Line Installation
Command line installation is universally compatible but requires familiarity with command line operations. It begins with installing PyTorch and downloading ComfyUI, followed by installing dependencies as specified in the official installation guide. Users must start ComfyUI using specific command line instructions. Additionally, proper installation of Miniconda3 is essential for managing project dependencies effectively.
Package Installation
Package installation is simpler and supports Windows systems with Nvidia GPUs. Users download the official or third-party integrated package and unzip it to the desired local directory.
Key Considerations
ComfyUI requires at least 4GB VRAM, with NVIDIA RTX 2070 or newer recommended for peak performance.
Proper dependency management, including PyTorch installation, is crucial. Advanced configurations, such as downloading checkpoint models and running specific batch files, enhance the ComfyUI experience.
GPU Compatibility
NVIDIA GPUs are recommended, with at least 4GB VRAM essential for running ComfyUI. Lower VRAM GPUs can use the ‘–lowvram’ option, but performance may decrease.
Additional Configurations
Users can manage custom nodes and dependencies for additional functionality. Proper setup of ComfyUI ensures smooth operation and better performance. ComfyUI provides a user-friendly interface that integrates Stable Diffusion, making AI image generation more accessible and customizable for users.
Running ComfyUI for the First Time

Launching ComfyUI After Installation
To start ComfyUI, you have two primary options. You can use the Aaaki ComfyUI Launcher by double-clicking on its icon in the unzipped folder.
Alternatively, you can choose to run ComfyUI by executing either ‘run_cpu.bat’ for CPU or non-NVIDIA graphics cards or ‘run_nvidia_gpu.bat’ for NVIDIA graphics cards.
Accessing the GUI
Upon successful launch, the console will display “Starting server” followed by a URL (e.g., http://0.0.0.0:8188) to access the GUI.
If the browser does not open automatically, you can manually enter the provided URL to access the GUI.
Navigating the GUI
In the GUI, you can interact with the default workflow that includes nodes like “Load Checkpoint” and “Clip Text Encoder.” ComfyUI is designed as a node-based GUI, which allows for flexible and transparent image generation workflows.
Ensure that your network is stable, as the first run may involve downloading and loading some environment configuration files.
Understanding the different node functionalities, such as the CheckpointLoader node loading model checkpoints from the ‘ComfyUI_windows_portable\models\checkpoints’ folder, is crucial for effective workflow management.
Troubleshooting
If the interface is blank or the default workflow is not loaded, click on “Load default” in the lower right corner menu to load the default workflow.
This step ensures that ComfyUI is ready for use.
Launching ComfyUI with the Aaaki Launcher
To launch ComfyUI using the Aaaki ComfyUI Launcher, click on the blue icon “One-click Start” on the launcher’s homepage.
This action will automatically open the console and run the necessary scripts.
The launcher will then display the GUI link, allowing you to access and interact with ComfyUI.
System Requirements Overview

ComfyUI System Requirements Overview
For optimal performance, ComfyUI necessitates hardware that meets its specific requirements. This includes a GPU with at least 4GB VRAM, though 8GB+ is recommended for NVIDIA RTX 2070 or newer models.
The system memory should be at least 8GB, with 16GB+ recommended for professional setups. An SSD is recommended for faster model file loading and running, with at least 40GB of hard disk space.
NVIDIA RTX A4000/A5000 and NVIDIA A100 or higher GPUs are recommended for professional and high-end use. Tensor cores enhance AI acceleration in these GPUs. For larger storage capacities, consider professional setups to handle extensive data sets.
Compatible operating systems include Windows and Mac with Apple Silicon support. Ubuntu 22.04 is also suitable for professional setups.
Users with lower-end hardware can use the –cpu option to run on the CPU or the –lowvram option for GPUs with less than 3GB VRAM, though this comes with reduced performance. Ensuring these hardware requirements are met guarantees the best performance and functionality of ComfyUI.
For further performance optimization, consider using GPUs with Tensor cores for faster AI acceleration. Choosing a compatible GPU and adequate system memory ensures ComfyUI runs efficiently, especially for professional users who require high-end setups.
Specifically, NVIDIA RTX 2070 or newer GPUs with 8GB+ VRAM are recommended for optimal performance, while SSD storage is crucial for faster loading and running of model files.
In cases where hardware limitations are an issue, options like running on the CPU with the –cpu option or using the –lowvram mode for GPUs with less than 3GB VRAM can help, albeit at a lower performance level.
Ensuring compatibility with the system’s operating system, such as Windows or Mac with Apple Silicon support, is also vital for a smooth experience.
Professional and high-end setups benefit from NVIDIA RTX A4000/A5000 or NVIDIA A100 GPUs and larger storage capacities to handle extensive data sets efficiently.
One of ComfyUI’s notable features is its ability to integrate with various AI models including Stable Diffusion, which allows users to generate images that meet their specific needs.
Using Tensor cores in GPUs like NVIDIA RTX 2070 and higher models significantly enhances AI acceleration, which is critical for high-end applications.
For users with limited hardware capabilities, ComfyUI offers flexibility through options like the –cpu and –lowvram modes, ensuring accessibility even with lower-end hardware configurations.
Key recommendations include using NVIDIA RTX 2070 or newer GPUs, ensuring adequate system memory, and choosing an SSD for faster storage and loading of model files.
For professional users, NVIDIA RTX A4000/A5000 and NVIDIA A100 GPUs are preferred for high-end performance and handling extensive data sets.
This setup ensures ComfyUI operates smoothly and efficiently, meeting the demands of both casual and professional users.
Key System Requirements:
- GPU: 4GB VRAM minimum, 8GB+ recommended for NVIDIA RTX 2070 or newer.
- System Memory: 8GB minimum, 16GB+ recommended for professional use.
- Storage: SSD recommended with at least 40GB of hard disk space.
- Operating System: Windows, Mac with Apple Silicon support, or Ubuntu 22.04 for professional setups.
For optimal performance and functionality, it is essential to ensure that your system meets these hardware specifications and chooses the appropriate GPU and storage options.
Using Tensor cores in NVIDIA RTX 2070 and higher GPUs improves AI acceleration significantly, which is pivotal for high-end and professional use.
To optimize for lower-end hardware, consider the –cpu option for running on the CPU or the –lowvram option for GPUs with less than 3GB VRAM, although performance will be reduced.
Professional users should opt for NVIDIA RTX A4000/A5000 and NVIDIA A100 GPUs, along with larger storage capacities, to handle extensive data sets efficiently.
In summary, adhering to these hardware requirements ensures the best performance and functionality of ComfyUI, making it suitable for both casual and professional users.
System Requirements Summary:
- GPU: At least 4GB VRAM, with 8GB+ VRAM recommended for NVIDIA RTX 2070 or newer.
- System Memory: 8GB minimum, with 16GB+ recommended for professional setups.
- Storage: SSD is recommended for faster loading and running of model files, with at least 40GB of hard disk space.
- Operating System: Compatible with Windows, Mac with Apple Silicon support, and Ubuntu 22.04 for professional users.
Meeting these specifications is crucial for ensuring that ComfyUI runs smoothly and efficiently, catering to the needs of both general and professional users.
For users with lower-end hardware, options such as running on CPU with the –cpu option or using GPUs with less than 3GB VRAM with the –lowvram option are available, although these come with reduced performance.
Professional setups benefit from using NVIDIA RTX A4000/A5000 and NVIDIA A100 GPUs, along with larger storage capacities, to handle extensive data sets efficiently.
By adhering to these system requirements, ComfyUI operates effectively, serving both casual and professional users’ needs.
For further optimization, leveraging Tensor cores in GPUs like NVIDIA RTX 2070 and higher models significantly enhances AI acceleration, which is crucial for high-end applications.
Choosing the appropriate GPU and ensuring adequate system memory are key to achieving optimal performance in ComfyUI.
Moreover, using SSD storage for faster loading and running of model files is essential for a seamless experience.
Professional Setup Recommendations:
– NVIDIA RTX A4000/A5000 and NVIDIA A100 GPUs are recommended for professional and high-end use.
Troubleshooting Common Issues

Troubleshooting Common Issues in ComfyUI
Module Errors
Module errors, including ‘ModuleNotFoundError’ and ‘AttributeError’, often disrupt workflows in ComfyUI. To resolve these issues, updating ComfyUI using the update.py file is crucial.
This process ensures that all necessary modules are up-to-date and compatible with the current version of ComfyUI.
Node Issues
Missing nodes can be installed using the ComfyUI Manager. After installation, restarting ComfyUI is necessary to apply the changes.
If a node fails to load, checking the logs > CMFY.log for specific error messages provides insight into the problem. This systematic approach helps in quickly identifying and resolving node issues.
Preventing Errors
Regular updates and checks of custom nodes and preprocessor-controlnet model matches are vital for preventing errors.
Ensuring that all components are up-to-date and compatible minimizes the risk of encountering module and node issues, thus ensuring efficient workflow operation. Additionally, maintaining accurate node connections, such as ensuring all image inputs in the CR Multi-ControlNet Stack, is crucial for preventing execution errors.
Resolving Node Loading Issues
When a node fails to load, checking the log files for specific error messages is essential.
If the error message indicates a missing custom node, using the ComfyUI Manager to install the node and then restarting ComfyUI can resolve the issue.
This methodical approach to troubleshooting helps in identifying and fixing problems effectively.
Importance of Updates
Keeping ComfyUI updated is crucial for resolving module and node issues.
Updates often include fixes for known problems, ensuring that users have a stable and functional environment for their workflows.
Regular checks for updates and applying them promptly can prevent many common issues.
Custom nodes should be installed within the \custom_nodes directory to ensure they are recognized by ComfyUI.