Open Manager for ComfyUI

Download Manager	Model Library
Resource Monitor	Desktop Mode

The whole workspace at once: one screenshot.

https://github.com/user-attachments/assets/5f264d2f-b11b-4ca9-9f69-73a553213e85

A manager for the whole ComfyUI workspace, not just its nodes.

Open Manager is not affiliated with ComfyUI-Manager or the Comfy Registry.

Install

Two ways. Only the first gives you ComfyUI's Extensions button: ComfyUI draws it when it finds a manager package in its own Python at startup, before any custom node loads.

As the manager

Windows portable build. In the ComfyUI_windows_portable folder, the one holding python_embeded and run_nvidia_gpu.bat, run:

python_embeded\python.exe -m pip uninstall -y comfyui-manager
python_embeded\python.exe -m pip install comfyui-open-manager

Then open run_nvidia_gpu.bat (or run_cpu.bat) in a text editor and add --enable-manager to the end of the line that starts .\python_embeded\python.exe -s ComfyUI\main.py, after the flags already on it:

.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --enable-manager

Save it, and start ComfyUI with that file. A whole launch file, with switches and keys, is under Launch files.

venv, conda or a manual install. With the environment ComfyUI runs in activated:

python -m pip uninstall -y comfyui-manager
python -m pip install comfyui-open-manager
python main.py --enable-manager

With uv, uv pip uninstall comfyui-manager and uv pip install comfyui-open-manager. Pack requirements then install through uv too.

Check. At startup the console shows [Open Manager] enabled in place of ComfyUI-Manager, and Extensions opens Open Manager.

As a custom node

cd ComfyUI/custom_nodes
git clone https://github.com/WASasquatch/open-manager-comfyui.git

Restart ComfyUI and open the Discovery tab in the sidebar. The console shows routes registered below /open_manager/v1/api.

Updating and logs

Access keys (optional)

Set under Access keys in the Open Manager menu. A variable, where set, is used instead.

The value is the key itself: set HF_TOKEN=hf_xxx on Windows, export HF_TOKEN=hf_xxx on Linux and macOS, in the file that starts ComfyUI. See Launch files.

Packs

Findings reword the confirmation. A registry ban blocks Install until Install versions the registry has banned is on.

Beyond packs

Four pieces. None of them adds a node to your graph.

Every panel opens as a movable window, or centred on the page. One setting each.

Remote installs

Desktop Mode is served by ComfyUI's own server: no second port, no second login.

Server switches

Environment variables, read once when ComfyUI starts. 1 turns a switch on. 0, or leaving it out, keeps the default. Set them in the file that starts ComfyUI, as in Launch files, and restart after changing one.

What ships on is closed with a NO_ switch:

What ships off is opened with its own:

The server refuses what a closed switch governs and names the variable. Desktop Mode and the file browser are hidden rather than refused, and their settings do nothing until the machine opens them.

Launch files

Each variable goes in the file that starts ComfyUI, above the line that runs it. These open Desktop Mode and the file browser, give a Hugging Face key, and start ComfyUI with Open Manager as its manager. As a custom node, leave out --enable-manager.

Windows portable. run_nvidia_gpu.bat, in the ComfyUI_windows_portable folder. No spaces around =.

@echo off
cd /d "%~dp0"
set OPEN_MANAGER_ENABLE_DESKTOP=1
set OPEN_MANAGER_ENABLE_FILES=1
set HF_TOKEN=hf_xxx
.\python_embeded\python.exe -s ComfyUI\main.py --windows-standalone-build --enable-manager
pause

Linux and macOS. run.sh, in the ComfyUI folder. venv is the folder your environment is in; drop that line if python already is ComfyUI's.

#!/usr/bin/env bash
cd "$(dirname "$0")"
source venv/bin/activate
export OPEN_MANAGER_ENABLE_DESKTOP=1
export OPEN_MANAGER_ENABLE_FILES=1
export HF_TOKEN=hf_xxx
python main.py --enable-manager

Run chmod +x run.sh once, then start ComfyUI with ./run.sh.

A list is one value, comma separated: set OPEN_MANAGER_MODEL_HOSTS=civitai.com,cdn.civitai.com. The lists are in DOWNLOADS.md.

Reference

Where it appears

Extensions follows ComfyUI: the panel on the modern interface, the classic menu of destinations under --enable-manager-legacy-ui. Override it under What the Extensions button opens. Both carry every destination, and the sidebar tab is unaffected.

ComfyUI's own manager links, such as the missing-nodes panel's, open the same place. Turn on Use ComfyUI's Nodes Manager to have them, and Extensions, open ComfyUI's Nodes Manager instead. Every install it starts is still run by Open Manager. So are the Install buttons ComfyUI shows for missing nodes, whichever is set.

Quality of Life Patches fixes faults in ComfyUI's own interface from Open Manager, each with its own switch and links to the issues it answers. A patch that finds ComfyUI changed, or already fixed, stands down and says so in the browser console.

Network

Open Manager reads the Comfy Registry live. What it contacts:

Settings

Under Settings -> Open Manager.

A GitHub token, set under Access keys in the Open Manager menu or as GITHUB_TOKEN, raises 60 anonymous calls an hour to 5,000. Without one, pack pages still show README, gallery and versions.

The registry address is BASE_URL in open_manager/registry.py, and BASE in open_manager/catalog.py for the offline copy. Both can point at a mirror or a private index.

Trust

Requirements

torch, torchaudio, torchsde and torchvision are never installed from a pack's requirements: they carry the build your ComfyUI was set up with. Anything held back is named in the install output. To substitute a package, map it in user/open_manager/pip_overrides.json:

{ "opencv-python": "opencv-python-headless>=4.9" }

Your GitHub list

For pack authors

Declare a [tool.open_manager] table in pyproject.toml and every Open Manager user sees it. Every field is optional. Packs without the table are unaffected.

[tool.open_manager]
incompatible = ["numpy>=2.0"]                   # declare known conflicts with other packages
source = "github"                               # prefer installing from the repository
branch = "main"                                 # named in the GitHub recommendation
docs = "https://example.com/docs"               # documentation URL
funding = "https://ko-fi.com/you"               # funding URL
release_note = "1.4.0 needs config regen."      # shown above the version list, 600 chars
capabilities = [                                # what your pack does, its own page panel
  "filesystem", "network", "subprocess",        #   from a fixed list, see below
]
example_workflows = ["workflows/*.json"]        # a path, a glob, or a directory
themes = ["themes/my-theme.json"]               # list themes to offer
gallery = [                                     # shown off on the pack page, up to 24, `png`,
                                                # `jpg`, `jpeg`, `gif`, `webp`, `avif`, and
                                                # `mp4`, `webm`, `mov`, `m4v` for clips
  "docs/*.png",                                 #   a path or glob in your repository
  "https://cdn.example.com/after.webp",         #   or a file hosted anywhere
]

Workflow thumbnails are not declared. An image beside a workflow and named for it is paired with it automatically, following ComfyUI's workflow templates convention: workflows/hdr.json picks up workflows/hdr.webp, .png, .jpg, .jpeg or .gif, and a numbered variant such as hdr-1.png counts too. Workflows without one show as a plain row.

Capabilities

Your own account of what your pack does, in fixed words so that two packs describe themselves the same way.

filesystem network subprocess binaries environment dynamic_code packages models credentials telemetry compilation hardware

Themes

A ComfyUI colour palette plus an optional extras block: gradient or flat headers per node category or class, a title icon, an image behind node bodies, see-through bodies, a graph backdrop, shadow colours and a selection glow. Packs ship them, users add them from the pack page.

[tool.open_manager]
themes = ["themes/my-theme/my-theme.json"]

Full reference in docs/THEMES.md. Examples in open_manager/themes/.

Licence

MIT, see LICENSE.

The GitHub mark shown on links to github.com is mark-github from Octicons, MIT licensed, Copyright (c) GitHub Inc. It is used only for links that go to GitHub.