Install ComfyUI Custom Nodes Without Breaking ComfyUI

If you want to install ComfyUI custom nodes, use Manager for common nodes and manual Git clone only when you know the repo you need.

Custom nodes are community-built plugins that add new functionality to ComfyUI, from face restoration to video generation to advanced upscaling. They are also one of the fastest ways to break an otherwise working environment.

That usually happens because the install is treated like a simple copy operation, when in reality each custom node may bring new Python packages, binary dependencies, version conflicts, or imports that only fail after restart.

Fast Answer

If your search was specifically ComfyUI Manager failed to get custom node list, this page is background. The repair path is ComfyUI Failed to Get Custom Node List.

Installing Custom Nodes

Method 1: ComfyUI Manager (Recommended)

ComfyUI Manager is the official package-management layer for recent ComfyUI builds. On current Desktop builds it is already included. On recent portable or manual installs it is built into core, but may need its dependencies installed and the manager flag enabled.

Desktop users

ComfyUI Desktop already ships with Manager enabled by default. Restart the app and look for the Manager button in the toolbar.

Recent portable users

From the portable package root, install manager dependencies and launch ComfyUI with Manager enabled:

.\python_embeded\python.exe -m pip install -r .\ComfyUI\manager_requirements.txt
.\python_embeded\python.exe -s .\ComfyUI\main.py --windows-standalone-build --enable-manager

Recent manual-install users

Activate the same venv you use to launch ComfyUI, then run:

python -m pip install -r manager_requirements.txt
python main.py --enable-manager

Legacy fallback

If your build still expects the older plugin-style install, use the legacy clone method documented by the ComfyUI Manager team:

cd ComfyUI/custom_nodes
git clone https://github.com/ltdrdata/ComfyUI-Manager.git comfyui-manager

Once Manager is available, use the Manager button in the ComfyUI toolbar to:

• Browse available custom nodes
• Install nodes with one click
• Update installed nodes
• Install missing nodes from imported workflows

Method 2: Manual Git Clone

1. Open a terminal in ComfyUI/custom_nodes/
2. Clone the node repository:

cd ComfyUI/custom_nodes
git clone https://github.com/[author]/[node-name].git

3. Install dependencies only if the node has a requirements.txt, and use the same Python environment that starts ComfyUI:

4. Restart ComfyUI

Method 3: Copy Files

Some simple nodes are just a single .py file. Copy it directly into custom_nodes/:

ComfyUI/
+-- custom_nodes/
    +-- my_node.py

Restart ComfyUI to load it.

Popular Custom Nodes

Fixing "Red Nodes"

Red nodes in a workflow mean ComfyUI cannot find a backend node class required by that workflow. That is related to plugins, but it is not the same thing as a successful plugin install.

The practical chain is:

1. The workflow asks for a node class.
2. A custom node plugin must register that class during startup.
3. The plugin can only register if its Python imports succeed.
4. Those imports may depend on packages, native wheels, CUDA, PyTorch, or platform-specific binaries.

So a red node can mean "plugin not installed", but it can also mean "plugin folder exists, but the plugin failed to import".

With ComfyUI Manager:

1. Click the Manager button
2. Click Install Missing Custom Nodes
3. The manager will identify and install what's needed
4. Restart ComfyUI

Without Manager:

1. Read the node name shown on the red node
2. Search for it on GitHub
3. Install manually via git clone
4. Restart and check the startup log for IMPORT FAILED

Updating Custom Nodes

With ComfyUI Manager: Click Manager > Update All

Manually:

cd ComfyUI/custom_nodes/[node-name]
git pull
python -m pip install -r requirements.txt  # only if this is the Python that starts ComfyUI

For the official Windows portable package, run dependency installs from the portable package root with .\python_embeded\python.exe -s -m pip ... instead of relying on a random system pip.

Restart ComfyUI after updating.

Install custom nodes with less risk

If this machine matters, follow this order:

1. Install one node or one node family at a time
2. Restart ComfyUI after each change
3. Check the startup log for IMPORT FAILED
4. Avoid stacking multiple requirements.txt installs without testing
5. Stop as soon as you see dependency drift

That approach is slower at first, but much faster than repairing a broken environment later.

Troubleshooting

Going Deeper

For advanced plugin management, node mapping, repo migrations, batch installation, and Git LFS issues, see the Plugin Management guide. If you're setting up a complex multi-workflow environment, see Workflow Environment Setup.

For systematic error diagnosis, use the Troubleshooting Decision Tree.

If you want a more recovery-oriented path than repeated manual installs, start with Wonderful Launcher. If the setup is already unstable, use expert help.

FAQ

What is the safest way to install ComfyUI custom nodes?

Use ComfyUI Manager when it is available. For manual installs, clone the node into ComfyUI/custom_nodes/, install only that node's requirements in the same Python environment that starts ComfyUI, and restart before testing.

Why did installing a custom node break ComfyUI?

The node may have changed shared Python packages such as Torch, NumPy, OpenCV, Pillow, Transformers, or Diffusers. If ComfyUI fails after the install, read the first IMPORT FAILED or traceback before running more package commands.

What should I do if Manager cannot get the custom node list?

That is usually a Manager registry, network, cache, or GitHub access problem, not a normal custom-node installation step. Use ComfyUI Failed to Get Custom Node List.

Related Guides

• ComfyUI Failed to Get Custom Node List
• Installed Custom Nodes and Broke ComfyUI
• How to Fix ComfyUI Plugin Import Failed Errors
• ComfyUI Dependency Conflicts

Source References

• Official ComfyUI custom node installation guide
• Official ComfyUI Manager installation guide
• Official ComfyUI Manager overview
• ComfyUI-Manager GitHub repository