Open Manager for ComfyUI

Download Manager	Model Library
Resource Monitor	Desktop Mode

The whole workspace at once: one screenshot.

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.

On Vast.ai

An image of Vast's own ComfyUI with Open Manager as its manager, ComfyUI-Manager kept out, and Desktop Mode and file writes on. The template and how to use it: VASTAI.md.

Updating and logs

Access keys (optional)

Keys come from environment variables only. Access keys in the Open Manager menu shows which are set and by which variable.

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.

Starring needs a GitHub token that may read and change stars: a fine-grained token with the Starring account permission set to read and write, or a classic token with public_repo. Without one, a pack page shows its star count only.

Packs

Findings reword the confirmation. A registry ban blocks Install until Install versions the registry has banned is on. A pack that asks for a ComfyUI major version above yours, such as the >=1.0.0 pyproject templates carry, is not reported as incompatible.

Beyond packs

Five 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. On Vast.ai, VASTAI.md has an image with it switched on.

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, and adds to, 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.

Link styles

Link style, under Settings -> Open Manager -> Links, draws the links between nodes on the classic canvas, Nodes 2.0 and OM Nodes. Links click, reroute, zip tie and carry their midpoint marker as with Solid.

Link path sets where links run, in any style. Clicks, the midpoint marker and zip ties follow the drawn path.

Ghost links fades each link along its own length a short way from the slots it joins, under a slowly drifting glow. A selected node's links show in full.

Link motion runs the moving styles, Physics swings and the ghost glow always, only while a workflow runs, or never. They redraw at up to 30 frames a second, less often when drawing takes longer, and not while the tab is hidden. Zoomed out, each style draws plainer.

Network

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

Settings

Under Settings -> Open Manager, and in Open Manager Settings from the Open Manager menu, the Start menu or the Open Manager: settings command. That window holds every Open Manager setting by section, and an overview: the version and updates, the system, the server switches, each patch's state, and which access keys are set. Installed as the manager, it also offers to uninstall the official ComfyUI-Manager where its package or a ComfyUI-Manager folder is still there, keeping the file that loads Open Manager.

A GitHub token, set 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. The check before an install reads the requirements.txt the install hands to pip. The install policy guards packages ComfyUI, an installed package or another pack uses: the default leaves them as they are, and the upgrade and downgrade choices let them move one way. A package only the pack itself uses changes as it asks under every choice. Anything held back is named in the check and in the install's issues, with what uses it.

A requirement whose PyPI release is NVIDIA's wheel stub installs from the index the stub names, pypi.nvidia.com or pypi.ngc.nvidia.com; a stub naming any other index is not followed. An install that has to replace a file the running ComfyUI holds open, as a loaded .dll is on Windows, can be queued for the next start, where it runs before any pack loads.

To substitute a package, map it in user/open_manager/pip_overrides.json:

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

Optional groups follow the same rules. The groups chosen for each pack are kept in user/open_manager/optional_requirements.json and forgotten when the pack is removed.

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.

Optional requirements

Optional dependencies need no field. Open Manager reads them from the files Python projects already use and offers each group once your pack installs, one at a time or all together, and again from the Optional tab on your page. Choosing groups shows what they would change before anything installs, as a pack install does, and they install under the same rules as requirements.txt: the install policy, the packages held back to protect ComfyUI, and the user's substitutions. When an update leaves a group the user chose short, it is offered again, ticked. requirements.txt stays the base install.

[project.optional-dependencies]
llm = ["llama-index-core>=0.14", "httpx"]   # the LLM nodes
pdf = ["xhtml2pdf"]                         # .pdf on Save DOC
all = ["my-pack[llm,pdf]"]                  # covered by All, not offered

# requirements/llm.txt
# The LLM nodes, on llama-index.
llama-index-core>=0.14   # documents, indexes and chat
httpx                    # the web tools agents call

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, a selection glow and a link style. For OM Nodes, tokens, named parts and scoped CSS restyle every part of a node. 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.