How to Update ComfyUI

ComfyUI Portable provides convenient batch scripts for easy updates.

​

Update Script Location

In the update folder within your portable installation directory, you’ll find the following update scripts:

ComfyUI_windows_portable
└─ 📂update
   ├── update.py
   ├── update_comfyui.bat                           // Update to latest development version
   ├── update_comfyui_stable.bat                    // Update to latest stable version
   └── update_comfyui_and_python_dependencies.bat   // Update dependencies (for troubleshooting)

ComfyUI Desktop features automatic updates to ensure you’re always running the latest version. However, since the Desktop version is built on stable releases, feature updates may lag behind. You can also visit the download page to get the latest version.

​

Auto-Update Settings

Ensure automatic updates are enabled in your settings:

​

Manual Update Check

You can also manually check for available updates:

1. Click Menu in the menu bar
2. Select Help
3. Click Check for Updates

Manually installed ComfyUI requires Git commands to complete updates.

​

Pre-Update Requirements

Ensure your system has Git installed and ComfyUI was installed via Git clone.

​

Update Steps

# For conda environment
conda activate comfyui

# For venv environment
# Windows
venv\Scripts\activate
# macOS/Linux  
source venv/bin/activate

cd <ComfyUI-installation-path>
git pull

pip install -r requirements.txt

python main.py

​

Version Switching (Optional)

To switch to a specific version, use these commands:

# View commit history
git log --oneline

# Switch to specific commit
git checkout <commit-hash>

# Return to latest version
git checkout master

Users often only use the git pull command to update ComfyUI code but neglect core dependency updates, leading to the following issues:

• Missing or abnormal frontend functionality
• Cannot find newly added workflow templates
• Outdated or missing node help documentation
• New features lack corresponding frontend support

After using the git pull command, use the corresponding ComfyUI environment to use pip install -r requirements.txt to update dependencies.

If dependency updates fail, it’s commonly due to network or computer permission issues. When core dependency failures occur during updates, the system falls back to older versions. You’ll typically see logs like this during startup:

Falling back to the default frontend.
ComfyUI frontend version: xxx

Follow these troubleshooting steps:

1. Use pip list in the appropriate environment to view currently installed dependency packages. If you find version inconsistencies, use pip install -r requirements.txt in the ComfyUI environment to attempt dependency updates again.
2. If issues persist after updating, check your network connection. Users in mainland China may need to configure a proxy to reliably access GitHub repositories.
3. If problems continue, check computer permissions. If administrator privileges are required, run the command line with administrator rights.

Recommended Method: Use the ComfyUI_windows_portable\update\update_comfyui.bat batch script, which will update both ComfyUI code and all Python dependencies.

Manual Dependency Update: If you need to manually update dependencies, use the following command:

# Open command line in portable version directory
.\python_embeded\python.exe -m pip install -r ComfyUI\requirements.txt

Standard Update Process:

# 1. Activate virtual environment
conda activate comfyui  # or other environment name

# 2. Update code
cd <ComfyUI installation path>
git pull

# 3. Update dependencies (important step)
pip install -r requirements.txt

Force Reinstall Core Dependencies:

# Force reinstall all dependencies (according to requirements.txt versions)
pip install -r requirements.txt --force-reinstall

Desktop version usually handles dependency updates automatically. If you encounter issues:

1. Check if auto-update is enabled
2. Manually trigger update: Menu → Help → Check for Updates
3. Reinstall desktop version (in extreme cases)

• Characteristics: Contains the latest commit code
• Advantages: Experience the latest features and improvements first
• Risks: May contain undiscovered bugs or unstable factors
• Suitable for: Developers, testers, users wanting to experience the latest features

• Characteristics: Tested and verified stable code
• Advantages: High stability, suitable for production environments
• Disadvantages: Feature updates have delays, may lag behind development versions by weeks or months
• Suitable for: Users requiring stability, production environment users

Use update_comfyui.bat instead of update_comfyui_stable.bat:

# Development version (latest features)
double-click: update_comfyui.bat

# Stable version
double-click: update_comfyui_stable.bat

Desktop version is typically built on stable releases and doesn’t currently support version switching. If you need the latest features, we recommend:

1. Wait for desktop version updates
2. Or use portable/manual installation to experience the latest features