Troubleshooting & FAQ | ComfyUIManager.com
This page lists typical issues and commonly asked questions about ComfyUI Manager. Whether you're experiencing an installation difficulty or are unclear about compatibility, this tutorial has you covered.
Troubleshooting Common Issues
Manager Tab Not Appearing
- Make sure ComfyUI Manager is cloned into the correct folder: ComfyUI/custom_nodes/ComfyUI-Manager
- Restart ComfyUI after installation
- Check for init.py in the node directory
Manager Interface Loads But Nothing Works
- Run pip install -r requirements.txt in ComfyUI root
- Ensure Python 3.10+ is installed
- Look for errors in the terminal during ComfyUI launch
Models Not Showing Up
- Check if the model is placed in the correct folder (see Model Guide)
- Click “Refresh Model List” in Manager tab
- Ensure the model file ends in .safetensors or .ckpt
Node Not Found or Red Blocks in Workflow
- This signifies that the required custom node is not installed.
- Check the node name in error, then install it using the Manager’s GitHub installation option.
Update Pull Fails (git error)
- Navigate into the folder manually and run:
cd ComfyUI/custom_nodes/ComfyUI-Manager
git pull
Or delete the folder and re-clone:
rm -rf ComfyUI/custom_nodes/ComfyUI-Manager
git clone https://github.com/ltdrdata/ComfyUI-Manager.git
Frequently Asked Questions (FAQ)
Is ComfyUI Manager free?
Yes, it is totally free and open-source under the MIT license. You may use, share, or contribute to it.
Does this work on Mac or Linux?
Yes! ComfyUI Manager is platform neutral. It’s compatible with Windows, macOS, and most recent Linux distributions.
Will this slow down my ComfyUI setup?
Not at all. The Manager is lightweight. You can also turn off unused nodes to speed up startup.
How do I uninstall a node?
Go to the Manager tab → find the node → click Remove. Then restart ComfyUI.
What’s the difference between comfy-cli and ComfyUI Manager?
- comfy-cli is a terminal-based tool for power users
- ComfyUI Manager has a GUI inside ComfyUI for easier control
Do I need Git to use this?
Only if you plan to use the clone/pull feature. You can also download and manually extract ZIP files.
Can I backup my nodes or models?
Yes. ComfyUI Manager is currently developing a backup/restore tab. Now, manually copy the custom_nodes and models folders.
How do I know if a model or node is corrupted?
Check for red errors in the terminal or UI. Try removing and reinstalling the item.
Where can I ask for help or report bugs?
Join the Discord or submit issues directly on GitHub.
Still Need Help?
Check out these additional guides: