Skip to main content
ComfyUI Manager is an extension that allows you to easily install, update, and manage custom nodes for ComfyUI.

​
What is ComfyUI Manager?

ComfyUI Manager provides a convenient interface for:
  • Installing custom nodes from repositories
  • Updating existing custom nodes
  • Managing node dependencies
  • Browsing available extensions
  • Installing missing nodes from workflows
ComfyUI Manager is integrated into ComfyUI but must be explicitly enabled.

​
Installation

​
Install Dependencies

First, install the manager dependencies: 
pip install -r manager_requirements.txt

​
Enable the Manager

Start ComfyUI with the --enable-manager flag: 
python main.py --enable-manager
Add this flag to your startup script to always run with the manager enabled.

​
Command Line Options

ComfyUI Manager supports several command line flags:
​
--enable-manager
flag
Enable ComfyUI-Manager functionality
​
--enable-manager-legacy-ui
flag
Use the legacy manager UI instead of the new UI (requires --enable-manager)
​
--disable-manager-ui
flag
Disable the manager UI and endpoints while keeping background features like security checks (requires --enable-manager)

​
Examples

python main.py --enable-manager

​
Using the Manager UI

​
Accessing the Manager

Once enabled, you can access the manager through the ComfyUI interface:
  1. Open ComfyUI in your browser
  2. Click the Manager button in the menu
  3. Browse available custom nodes and extensions

​
Installing Custom Nodes

To install a custom node:
1

Open the Manager

Click the Manager button in the ComfyUI interface
2

Browse Extensions

Browse or search for the extension you want to install
3

Install

Click the Install button next to the extension
4

Restart

Restart ComfyUI to load the new nodes

​
Updating Custom Nodes

Keep your custom nodes up to date:
  1. Open the Manager
  2. Navigate to the Update section
  3. Select nodes to update
  4. Click Update and restart ComfyUI

​
Installing Missing Nodes

When you load a workflow that uses custom nodes you don’t have installed, the manager can help:
1

Load Workflow

Load a workflow with missing nodes
2

Automatic Detection

The manager detects missing nodes
3

Install Prompt

Click the prompt to install missing nodes
4

Restart

Restart ComfyUI to use the workflow
Always review what you’re installing before proceeding. Only install custom nodes from trusted sources.

​
Custom Node Translations

ComfyUI Manager supports internationalization through custom node translations.

​
Translation Structure

Custom nodes can provide translations in a locales/ folder: 
custom_nodes/
└── my_custom_node/
    └── locales/
        ├── en/
        │   ├── main.json
        │   ├── commands.json
        │   └── settings.json
        ├── zh/
        │   └── main.json
        └── ja/
            └── main.json

​
Translation Files

Main node translations including node names and descriptions:
{
  "nodeDefs": {
    "MyNode": {
      "name": "My Node",
      "description": "Does something cool"
    }
  }
}
Command and menu translations:
{
  "commands": {
    "myCommand": "My Command"
  }
}
Settings panel translations:
{
  "settings": {
    "mySetting": "My Setting"
  }
}

​
Workflow Templates

Custom nodes can provide example workflows that appear in the manager.

​
Providing Templates

Place example workflows in an example_workflows/ folder: 
custom_nodes/
└── my_custom_node/
    ├── __init__.py
    └── example_workflows/
        ├── basic_usage.json
        ├── advanced_example.json
        └── creative_workflow.json
The manager also recognizes folders named example, examples, workflow, or workflows, but example_workflows is recommended.

​
Accessing Templates

Workflow templates are available through the manager API: 
// Fetch available templates
fetch('/workflow_templates')
  .then(res => res.json())
  .then(templates => {
    // templates = {"my_custom_node": ["basic_usage", "advanced_example"]}
    console.log(templates);
  });

// Load a specific template
fetch('/api/workflow_templates/my_custom_node/basic_usage.json')
  .then(res => res.json())
  .then(workflow => {
    // Load workflow into ComfyUI
  });

​
Manager API Endpoints

The manager exposes several HTTP endpoints:

​
GET /workflow_templates

Returns a map of custom node names to their available workflow templates: 
{
  "custom_node_1": ["example1", "example2"],
  "custom_node_2": ["demo"]
}

​
GET /api/workflow_templates//.json

Returns the workflow JSON for a specific template: 
curl http://localhost:8188/api/workflow_templates/my_node/example.json

​
GET /i18n

Returns all translations from custom nodes: 
{
  "en": {
    "nodeDefs": {...},
    "commands": {...},
    "settings": {...}
  },
  "zh": {...}
}

​
Security Features

The manager includes security features even when the UI is disabled:

​
Background Security Checks

With --enable-manager --disable-manager-ui, you get:
  • Dependency verification
  • Security checks for custom nodes
  • Installation validation
  • Update notifications
Even with the manager disabled, ComfyUI loads all custom nodes from the custom_nodes/ directory. Only install extensions you trust.

​
Troubleshooting

​
Manager Not Appearing

If the manager UI doesn’t appear:
1

Check Startup

Ensure you’re using --enable-manager flag
2

Verify Dependencies

Run pip install -r manager_requirements.txt
3

Check Console

Look for error messages in the terminal
4

Clear Cache

Clear your browser cache and reload

​
Installation Failures

If custom node installation fails:
  1. Check dependencies: Some nodes require specific Python packages
  2. Review logs: Check the console output for error messages
  3. Manual installation: Try installing manually via git clone
  4. Compatibility: Ensure the node is compatible with your ComfyUI version

​
Update Issues

If updates aren’t working:
  • Ensure you have write permissions in the custom_nodes/ directory
  • Check if git is installed and accessible
  • Try updating manually with git pull in the node’s directory

​
Best Practices

Regular Updates

Keep your custom nodes updated for bug fixes and new features

Review Before Installing

Always review what you’re installing from the community

Backup Workflows

Save your workflows before major updates

Test After Updates

Test your workflows after updating nodes

​
Next Steps

Installing Extensions

Learn how to install and manage extensions

Creating Nodes

Create your own custom nodes

Build docs developers (and LLMs) love

Get started for freeTalk to us