LogoWonderful Launcher
  • Home
  • Pricing
  • Docs
  • Download

ComfyUI Won't Update: Fix Git and Downgrade Issues

Needs verification

Fix ComfyUI update failures, "your ComfyUI isn't git repo", update_comfyui.bat confusion, pip dependency drift, and safe downgrade paths.

If ComfyUI will not update, or you need to downgrade after a bad update, first identify which install type you have.

Portable, manual Git installs, and Desktop builds update differently. Running the wrong command can leave you with new code, old dependencies, a broken frontend, or custom nodes that no longer import.

30-second decision

If the error says Your ComfyUI isn't git repo or fatal: not a git repository, stop running Git commands in that folder. Use the portable updater, Desktop updater, or a fresh Git clone based on your install type.

Quick Diagnosis

SymptomLikely CauseBest Next Step
fatal: not a git repositoryYou have a zip/portable copy, not a Git cloneDo not run more Git commands; use the portable updater or create a clean Git install
pip install --upgrade comfyui does nothing usefulComfyUI is not normally updated as a PyPI appUse the update method for your install type
New features missing after git pullCode updated, dependencies did notRun python -m pip install -r requirements.txt in the same environment
Frontend looks old, blank, or missing featuresCore frontend dependencies are outdatedReinstall requirements from the current ComfyUI checkout
Custom nodes fail after updatePlugin dependency or API compatibility driftDisable/update nodes one at a time
You searched comfyui downgradeThe new version broke a workflowPrefer restoring a backup or checking out a known commit in a separate test folder

Step 1: Identify the Install Type

Install TypeHow to Recognize ItUpdate MethodDowngrade Method
Portable WindowsHas python_embeded, run_nvidia_gpu.bat, and an update folderUse update batch filesRestore a copied backup folder
Manual GitHas a .git folder inside ComfyUIgit pull plus requirements updategit checkout <commit-hash> or a stable tag
DesktopInstalled as the ComfyUI Desktop appUse the app updaterUsually reinstall an older Desktop build if available
Zip copyNo .git, no portable update folderReinstall or move to Git/portableRestore backup only

Do not continue until you know which one you are using.

Portable Windows Update

In the portable package, use the scripts in the update folder:

ScriptWhat it doesWhen to use it
update_comfyui.batUpdates ComfyUI to the latest development versionNormal updates when you want new features
update_comfyui_stable.batUpdates ComfyUI to the latest stable versionProduction/stability-focused setups
update_comfyui_and_python_dependencies.batUpdates code and reinstalls Python dependenciesOnly when dependency repair is needed

The dependency-heavy script can reinstall many packages, including PyTorch-related packages, and may break custom nodes that depend on specific versions. Before running it:

  1. Back up the entire portable folder.
  2. Save important workflows.
  3. Record custom nodes.
  4. Keep models/ outside the test copy or make sure model paths are shared safely.

For normal daily updates, start with update_comfyui.bat, not the dependency reinstall script.

Manual Git Update

For a manual install, activate the same environment that runs ComfyUI, then update code and requirements together:

cd ComfyUI
git status
git pull
python main.py

Do not run pip install -r requirements.txt blindly.

  1. Confirm which Python environment is active (where python or which python)
  2. Inspect requirements.txt — check if it pins torch, numpy, or opencv versions
  3. Install only the missing package when possible: pip install <package-name>
  4. Run pip check after installation to verify no conflicts were introduced

If you use a virtual environment on Windows:

.\venv\Scripts\activate

If you use Conda:

conda activate comfyui

The dependency step matters. ComfyUI's official update guide calls out frontend, workflow template, embedded docs, and core utility packages as dependencies that may need to update with the code.

Fix "Your ComfyUI Isn't a Git Repo"

If you see:

fatal: not a git repository

or a launcher says Your ComfyUI isn't git repo, you are not inside a Git checkout, or the .git folder is missing.

Check:

cd ComfyUI
git status

If this fails, do not "fix" it by running git init inside the old folder. That creates a new empty Git history and does not turn the folder into the official ComfyUI repo.

Use one of these paths instead:

  • portable install: use the update folder scripts
  • zip copy: download a fresh portable package and move models/workflows carefully
  • manual install: clone ComfyUI into a new folder, then point it at your existing model folders
  • production machine: preserve the old environment before replacing it

How to Downgrade ComfyUI Safely

Downgrading is safer when you treat the current environment as something to preserve, not something to experiment on.

Best downgrade path: restore a backup

If you made a full folder backup before updating, restore that copy. This is the safest path for portable installs and machines with many custom nodes.

Manual Git downgrade

If your ComfyUI folder is a Git checkout:

cd ComfyUI
git status
git log --oneline -20
git checkout <commit-hash>
python main.py

Then test your workflow. If you want to return to the latest development version:

git checkout master
git pull

If you want the latest stable tag instead:

git fetch --tags
git tag --sort=-creatordate
git checkout <stable-tag>

Do not run pip install -r requirements.txt blindly.

  1. Confirm which Python environment is active (where python or which python)
  2. Inspect requirements.txt — check if it pins torch, numpy, or opencv versions
  3. Install only the missing package when possible: pip install <package-name>
  4. Run pip check after installation to verify no conflicts were introduced

Do not downgrade the only working production environment without a backup. Older ComfyUI code may need older versions of frontend or dependency packages, and pip install -r requirements.txt does not always undo every package that a newer version installed.

Fix Frontend Package Problems After Update

If the update finishes but the browser UI is missing, old, or broken, check:

python -m pip show comfyui-frontend-package

If the package is missing or outdated, install only what is needed rather than running all requirements blindly. See the safety checklist above.

For portable:

.\python_embeded\python.exe -s -m pip show comfyui-frontend-package
.\python_embeded\python.exe -s -m pip install -r ComfyUI\requirements.txt

See ComfyUI Frontend Package for the full diagnosis path.

Fix Custom Nodes After Update

If ComfyUI updates but custom nodes fail:

  1. Read the first IMPORT FAILED or traceback in the startup log.
  2. Disable the most recently changed node.
  3. Update one custom node at a time.
  4. Avoid running every custom node requirements.txt at once.
  5. Recheck ComfyUI after each change.

For deeper recovery, use Installed Custom Nodes and Broke ComfyUI.

When Not to Update

Do not update a production ComfyUI environment right before delivery if:

  • a client workflow is already working
  • you do not have a backup
  • custom nodes are pinned to old package versions
  • you only want to install one unrelated node
  • the machine has limited internet access and cannot recover dependencies

Create a second test environment instead. This is especially important when moving between development/nightly and stable builds.

How Wonderful Launcher Helps

Wonderful Launcher is useful when update risk is higher than the update itself:

  • preserve working ComfyUI folders before an update
  • keep stable and experimental environments separate
  • inspect startup logs after an update
  • avoid mixing dependencies from unrelated workflows
  • recover faster if a custom node update breaks the environment

If your main issue is missing models after updating, see Where to Put Safetensors in ComfyUI.

FAQ

How do I fix Your ComfyUI isn't git repo?

First confirm your install type. If it is a portable or zip copy without a .git folder, do not run git init. Use the portable update scripts or clone a fresh Git install and move models/workflows carefully.

Which portable update script should I use?

Use update_comfyui.bat for normal development updates and update_comfyui_stable.bat when stability matters more. Use update_comfyui_and_python_dependencies.bat only when dependency repair is needed, because it can reinstall many packages.

How do I downgrade ComfyUI safely?

Restore a backup when possible. For a manual Git install, check out a known commit or tag in a separate test folder first, then install that checkout's requirements in the same Python environment.

Related Guides

  • ComfyUI Frontend Package
  • ComfyUI Dependency Conflicts
  • Install Custom Nodes
  • ComfyUI Startup Failed
  • ComfyUI Portable
  • Manual Install

Source References

  • Official ComfyUI update guide
  • ComfyUI frontend management source
  • Git checkout documentation
Related guides:Fix frontend package driftRepair dependency conflictsUse the portable update path

Start with Wonderful Launcher if this issue touches your real ComfyUI environment. Use the docs to understand the fix, and use the app to inspect the machine you already have.

Download Wonderful Launcher

Did this fix your issue?

Your answer helps prioritize verified ComfyUI repairs.

Table of Contents

Quick Diagnosis
Step 1: Identify the Install Type
Portable Windows Update
Manual Git Update
Fix "Your ComfyUI Isn't a Git Repo"
How to Downgrade ComfyUI Safely
Best downgrade path: restore a backup
Manual Git downgrade
Fix Frontend Package Problems After Update
Fix Custom Nodes After Update
When Not to Update
How Wonderful Launcher Helps
FAQ
How do I fix Your ComfyUI isn't git repo?
Which portable update script should I use?
How do I downgrade ComfyUI safely?
Related Guides
Source References