How to Install Custom Nodes in ComfyUI (Manager, Git & Fixing Import Failed)

ComfyUI ships with a solid foundation of core nodes—enough to generate images from text prompts and run basic workflows. But the moment you want to work with GGUF quantized models, add ControlNet for pose guidance, detect faces, or run community workflows, you’ll hit a wall. Those capabilities live in separate repositories scattered across GitHub, and installing them manually means cloning repositories one by one, managing dependencies, and troubleshooting conflicts in the terminal.

ComfyUI Manager eliminates that friction. It’s the official package manager for ComfyUI, built and maintained by Comfy-Org, and it transforms node installation from a multi-step git and pip process into a search-and-click operation. This guide walks you through installing ComfyUI Manager, using it to add custom nodes, and fixing the most common errors that trip up new users.

At a Glance

What ComfyUI Manager Does

ComfyUI Manager adds a graphical interface to ComfyUI that centralizes node discovery, installation, updates, and troubleshooting. Instead of managing custom nodes through terminal commands, you access everything from a panel in the top menu bar.

Core Features

Search and Install: Browse thousands of community-contributed nodes by name, category, or status. Each listing shows a description, GitHub link, and installation status. A single click clones the repository and installs Python dependencies automatically.

One-Click Updates: Run Update All to pull the latest code for every installed node at once. This matters most before running community workflows downloaded from Discord, Reddit, or GitHub—many assume you’re running recent node versions.

Per-Node Management: View all installed nodes with individual controls to update, disable, or remove each one. The disable option is particularly useful—it deactivates a node without deleting it, letting you isolate conflicts without losing configuration.

💡 Tip: Disabling a node is much safer than deleting it when troubleshooting. You can always re-enable it later if the problem was elsewhere.

Core Updates: Update ComfyUI itself from the Manager interface rather than dropping into the terminal.

Direct URL Installation: Install nodes not listed in the official database by pasting a GitHub URL directly.

ComfyUI Desktop users get Manager pre-installed. Everyone else needs a manual setup that takes two minutes.

👉 Quick takeaway: ComfyUI Manager transforms node installation from a terminal-based workflow into a visual, one-click interface—saving time and reducing errors.

Installing ComfyUI Manager

Prerequisites: A working ComfyUI installation with Python and git available in your PATH.

Step 1: Close ComfyUI

Shut down the ComfyUI process entirely. If you’re running it in a terminal, press Ctrl+C. Don’t just close the browser tab—the Python process must stop.

Step 2: Clone ComfyUI Manager

Navigate to your ComfyUI installation directory, then into the custom_nodes folder:

cd /path/to/ComfyUI/custom_nodes

Clone the official repository:

git clone https://github.com/Comfy-Org/ComfyUI-Manager

This command works identically on Windows, macOS, and Linux. The repository migrated from the ltdrdata account to Comfy-Org in 2024, and version 3.38+ includes a critical security patch, so always clone from the official Comfy-Org URL.

Step 3: Restart ComfyUI

Launch ComfyUI normally:

python main.py

Wait for the terminal to show “Server started at http://127.0.0.1:8188”, then open the web interface in your browser.

Step 4: Verify Installation

Look at the top menu bar. You should see a Manager button next to “Queue Prompt”. If it’s missing, double-check that the ComfyUI-Manager folder exists inside custom_nodes/, fully close and restart ComfyUI, and refresh the browser page (F5).

👉 Quick takeaway: Installing ComfyUI Manager requires just a git clone into custom_nodes/ and a restart—no additional dependencies or configuration needed.

Using ComfyUI Manager: The Interface

When you click the Manager button, a panel opens with four main sections.

Install Custom Nodes

This section displays the community database of available nodes. Each entry shows:

• Node name and author
• Short description of what it does
• GitHub link to the repository
• Status badge: not-installed, installed, disabled, or has-update

Filter the list by typing in the search box. You can search by node name, category, or author. Once you find what you need, click the Install button. Manager clones the repository into custom_nodes/ and runs any pip install commands defined in the node’s dependencies. When the log finishes, you’ll see a prompt to restart ComfyUI. Always accept it—nodes only load at startup.

Install via Git URL

At the bottom of the Install Custom Nodes panel, there’s a text field for pasting direct GitHub URLs. Use this for nodes not in the official database. Paste the full repository URL (e.g., https://github.com/author/ComfyUI-CustomNode), click Install, and Manager handles the rest.

Node Manager

This panel shows every custom node currently installed, with three action buttons per node:

• Update: Pulls the latest code from the repository
• Disable: Deactivates the node without deleting it (invaluable for debugging conflicts)
• Remove: Deletes the node’s folder permanently

Update ComfyUI

A single button that updates the core ComfyUI installation (equivalent to git pull in the root folder). This doesn’t touch any custom nodes—use Update All in the Node Manager for those.

👉 Quick takeaway: The Manager interface has four main sections: Install Custom Nodes, Git URL installation, Node Manager for per-node control, and Core Updates.

Practical Example: Installing ComfyUI-GGUF

Let’s walk through a real installation. GGUF is a quantized model format that reduces file size by up to 5x with minimal quality loss, making it ideal for GPUs with 4–8GB VRAM. ComfyUI-GGUF adds nodes to load GGUF models directly.

1. Open Manager → Install Custom Nodes
2. Search for “GGUF”
3. Find ComfyUI-GGUF (author: city96)
4. Click Install
5. Wait for the log to complete
6. Click Restart when prompted
7. After restart, right-click in the node canvas → Add Node → loaders. You’ll see UnetLoaderGGUF and DualCLIPLoaderGGUF nodes

The entire process takes under a minute. Without Manager, you’d clone the repository manually, read the README for dependencies, run pip install commands in your virtual environment, and manually restart ComfyUI.

Updating Nodes and ComfyUI

A healthy workflow includes regular updates:

• Weekly or before running new workflows, open Manager → Node Manager → Update All
• Wait for all nodes to pull the latest code
• Restart ComfyUI if updates were found
• Optionally run Manager → Update ComfyUI and restart again

Keeping nodes current prevents compatibility issues with workflows downloaded from the community, since most assume recent versions.

Comparison: Manual Installation vs. ComfyUI Manager

Troubleshooting: Import Failed and Other Errors

Most problems fall into a few categories. Here’s how to fix them.

Node Doesn’t Appear After Installing

Symptom: You install a node, restart, but the new nodes don’t show up in the Add Node menu.

Cause: ComfyUI only loads nodes at startup. A browser refresh or soft reload isn’t enough.

Fix:

1. Fully close the ComfyUI process (Ctrl+C in the terminal)
2. Relaunch with python main.py
3. Wait for “Server started” to appear
4. Refresh the browser (F5)
5. Check the Add Node menu again

If still missing, check Manager → Node Manager. If the node shows a “Disabled” status, click Enable and restart. Some nodes fail to load initially and get auto-disabled; re-enabling often resolves this.

Import Failed or Startup Errors

Symptom: ComfyUI starts but the terminal shows errors like:

Cannot import module 'custom_nodes/ComfyUI-GGUF': No module named 'gguf'

Cause: A custom node has a missing or incompatible Python dependency. Manager attempts to install dependencies automatically, but some nodes have requirements it can’t detect.

Fix:

1. Read the error message carefully—it usually names the missing module directly
2. Activate your Python virtual environment (if using one)
3. Install the missing module: pip install <module_name>
4. Restart ComfyUI

For example, if the error says “No module named ‘gguf’”, run pip install gguf. If Manager’s auto-install didn’t catch it, check the node’s GitHub README under “Installation” or “Requirements”—it will list any special dependencies.

⚠️ Important: Always read the error message from top to bottom. The actual missing module is usually near the end of the traceback, not the beginning.

Node Conflicts

Symptom: After installing a node, you see “already registered” errors in the terminal, nodes disappear from the context menu, or workflows that worked suddenly fail.

Cause: Two nodes are trying to register the same operation or namespace.

Fix:

1. Go to Manager → Node Manager
2. Disable recently installed nodes one at a time
3. Restart after each disable
4. When the conflict resolves, you’ve found the culprit
5. Check that node’s GitHub issues—conflicts are often documented
6. Either wait for a fix, use the Disable option permanently, or uninstall the conflicting node

The Disable option is ideal here because it doesn’t delete the node or its configuration, so you can re-enable it later once a compatible version ships.

Manager Button Missing

Symptom: You installed Manager but the button doesn’t appear in the top menu bar.

Cause: The clone didn’t complete, the folder is corrupt, or ComfyUI didn’t fully restart.

Fix:

1. Close ComfyUI
2. Check that ComfyUI/custom_nodes/ComfyUI-Manager/ exists and contains files
3. If the folder is empty or missing files, delete it and re-clone:

   rm -rf ComfyUI-Manager
   git clone https://github.com/Comfy-Org/ComfyUI-Manager

4. Restart ComfyUI and refresh the browser

Frequently Asked Questions

Q: Does ComfyUI Manager come installed by default?

A: Yes in ComfyUI Desktop. In a manual git-clone install you have to add it yourself: clone the repository into custom_nodes/ and restart ComfyUI. The process takes under a minute.

Q: Do I need a GPU to install nodes with ComfyUI Manager?

A: No. Manager handles node installation, which is Python code, not image generation. You can install and update nodes on any machine running ComfyUI, even without a GPU—the GPU only comes into play when you actually run a workflow.

Q: What do I do if an installed node doesn’t show up in ComfyUI?

A: Almost always a missing restart. After installing any node from Manager, fully restart ComfyUI—close the terminal process and rerun main.py. If it still doesn’t appear, open Manager → Node Manager and check whether the node shows as ‘disabled’.

Q: Can I install nodes from GitHub that aren’t in Manager’s list?

A: Yes. In Manager → Install Custom Nodes there’s a field to paste a GitHub repository URL directly. Manager clones the repo into custom_nodes/ and manages dependencies the same way as nodes from the official list.

Keep Reading

Running into a dependency error right after installing a node? Our Import Failed troubleshooting guide covers the exact fixes. One of the most useful custom nodes to install first is ComfyUI-GGUF — see our GGUF models guide for running Flux on 8GB VRAM.

Getting Started

You now have the knowledge to install ComfyUI Manager, browse and install custom nodes, manage updates, and troubleshoot the most common errors. Start by installing Manager if you haven’t already, then explore the community database. A few essential nodes to consider: ComfyUI-GGUF for quantized models, ControlNet nodes for pose and depth guidance, and face detection nodes for character work. Keep your nodes updated, and when something breaks, use the Disable option to isolate conflicts before removing anything permanently.

🏆 Our recommendation

If you’re new to ComfyUI and want the simplest path forward → use ComfyUI Desktop, which comes with Manager pre-installed. If you’re managing a manual installation → clone ComfyUI Manager into custom_nodes/ and restart (takes 2 minutes). If you prioritize stability → keep nodes updated weekly and always disable before removing. If you’re troubleshooting conflicts → use the Disable toggle to test in isolation rather than deleting nodes permanently. The Manager interface transforms ComfyUI from a command-line dependency maze into an accessible, user-friendly system.