While we’ve covered ComfyUI updates across different installation methods in various sections, this comprehensive guide consolidates all update procedures to help users clearly understand how to update ComfyUI.

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)
Ensure a stable internet connection during updates. Users in mainland China may need to configure a proxy to access GitHub repositories reliably.

ComfyUI Version Types

Depending on your installation method, ComfyUI offers several installation versions. The links below contain update instructions for each version.

What Needs to Be Updated When Updating ComfyUI?

ComfyUI updates primarily consist of two components:

  1. Update ComfyUI’s core code
  2. Update ComfyUI’s core dependencies, including necessary Python dependencies and ComfyUI functional dependency packages

Core Code: New nodes, new model support, new features, etc. Core Dependencies: Mainly includes ComfyUI’s frontend functionality, workflow templates, node help documentation, etc.

comfyui-frontend-package   # ComfyUI frontend functionality
comfyui-workflow-templates # ComfyUI workflow templates  
comfyui-embedded-docs      # ComfyUI node help documentation

These three core dependencies are maintained in separate repositories:

It’s important to understand the difference between development (nightly) and stable (release) versions:

  • Development version (nightly): Latest commit code, giving you access to the newest features, but may contain potential issues
  • Stable version (release): Built on stable releases, usually lags behind development versions but offers higher stability. We support stable versions after features are tested and stabilized

Many users often find themselves on release versions or desktop versions during updates, but discover that needed features are only available in development versions. In such cases, check if your local ComfyUI/requirements.txt matches the nightly version dependencies to determine if all dependencies support the latest features.

Common Update Issues

Missing or Outdated Frontend, Workflow Templates, Node After Updates

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 pip install -r requirements.txt to update dependencies.

How to Properly Update Core Dependencies

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

Core Dependency Update Troubleshooting

If core dependency updates fail, follow these troubleshooting steps:

1

Check Network Connection

If located in mainland China, ensure you can access PyPI or configure a domestic mirror:

# Using Tsinghua University mirror
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
2

Install Core Packages Individually

If batch installation fails, try installing packages individually. First check version requirements in ComfyUI/requirements.txt:

Then install according to specified versions:

pip install comfyui-frontend-package==1.17.11 
pip install comfyui-workflow-templates==1.0.0
pip install comfyui-embedded-docs==1.0.0

It’s recommended to use the exact version numbers specified in ComfyUI/requirements.txt. Don’t upgrade to the latest versions independently, as this may cause compatibility issues.

Why Can’t I Find New Features After Updating?

This is one of the most common issues:

  • If you’re using the Desktop version, features may lag behind because the desktop version is built on stable releases
  • Ensure you’re using the development version (nightly), not the stable version (release)

Additionally, ensure that corresponding dependencies have been successfully updated during the update process. If issues persist after updating, refer to the Dependency Update Troubleshooting section to diagnose problems.

How to Switch Between Development (Nightly) and Stable (Release) Versions?

Differences between versions:

  • 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

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

What to Do When Errors Occur After Updates?

  1. Check Dependencies: Run pip install -r requirements.txt to ensure all dependencies are updated
  2. Check Custom Nodes: Some custom nodes may be incompatible with new versions
  3. Roll Back Version: If issues are severe, you can roll back to a previous stable version

If problems occur, refer to our troubleshooting page for solutions.

Troubleshooting

Learn how to troubleshoot ComfyUI issues

How to Stay Updated on New Features?

  • GitHub Releases: Check ComfyUI Releases for stable version updates
  • GitHub Commits: View latest commits to understand development progress
  • Community Discussion: Follow our blog and Twitter for the latest updates