Plugin Guides

Install ComfyUI Manager

Install ComfyUI Manager for searching, installing, updating, and repairing custom nodes, including Git checks and common installation failure fixes.

Beginner10 minUpdated 2026-05-18
English diagram showing the ComfyUI installation verification flow
diagram English visual prepared for this guide family.
Reliable tutorial format: each page starts with the fastest working path, then adds checkpoints, common mistakes, success criteria, and related next steps.

Quick answer

ComfyUI Manager must live inside ComfyUI/custom_nodes, not beside the ComfyUI folder and not inside a nested zip folder. If the folder depth is wrong, ComfyUI will start normally but Manager will never appear in the interface.

Recommended workflow

  1. 01

    Install Manager in the correct custom_nodes folder: ComfyUI Manager must live inside ComfyUI/custom_nodes, not beside the ComfyUI folder and not inside a nested zip folder. If the folder depth is wrong, ComfyUI will start normally but Manager will never appear in the interface.

  2. 02

    Check Git and network errors first: Many Manager install failures are not ComfyUI problems. They are Git not found, blocked GitHub access, antivirus quarantine, proxy issues, or a partially downloaded folder. Read the terminal and install log before trying random Python commands.

  3. 03

    Verify with a small node install: After Manager appears, test it with one simple custom node package instead of updating everything. Install one package, restart ComfyUI, open a simple workflow that uses the node, and confirm the node loads without a red block.

Full tutorial notes

Install Manager in the correct custom_nodes folder

ComfyUI Manager must live inside ComfyUI/custom_nodes, not beside the ComfyUI folder and not inside a nested zip folder. If the folder depth is wrong, ComfyUI will start normally but Manager will never appear in the interface.

The safest install path is to stop ComfyUI, clone or extract Manager into custom_nodes, then start ComfyUI again and watch the terminal for import messages. A successful install normally adds a Manager button or menu entry after the page reloads.

  • Stop ComfyUI before installing.
  • Confirm the folder name is ComfyUI-Manager.
  • Restart after installation; browser refresh alone is not enough.

Check Git and network errors first

Many Manager install failures are not ComfyUI problems. They are Git not found, blocked GitHub access, antivirus quarantine, proxy issues, or a partially downloaded folder. Read the terminal and install log before trying random Python commands.

If Git is unavailable, install Git for Windows and reopen the terminal so PATH updates take effect. If network cloning fails, download the repository zip from a trusted source, extract it once, and place the actual Manager folder under custom_nodes.

Verify with a small node install

After Manager appears, test it with one simple custom node package instead of updating everything. Install one package, restart ComfyUI, open a simple workflow that uses the node, and confirm the node loads without a red block.

  • Manager appears in the UI.
  • The install list can load.
  • One small node package installs and survives restart.

Check before you run

  • Install one node pack first, then restart.
  • Check whether the plugin has a requirements.txt dependency step.
  • Open a small test workflow that actually uses the new node.

Common mistakes

  • Updating every plugin while trying to fix one missing node.
  • Installing into the wrong custom_nodes folder depth.
  • Skipping the restart after Manager finishes.

Success standard

  • ComfyUI restarts without a new terminal traceback.
  • The workflow can be queued once without missing nodes or empty model dropdowns.
  • The result can be reproduced after refreshing the browser page.

What to do next

  • Increase image size only after the small test workflow is stable.
  • Add one plugin or model family at a time.
  • Return to the English guide library if the next error belongs to another category.

Need more context?

This English guide gives the direct working path first. The paired Chinese reference can provide extra screenshots, local download notes, and longer troubleshooting branches for the same topic.

Open the paired reference