Open Manager

An alternative package manager for ComfyUI. Browse and install custom nodes and custom themes.

By WASasquatch·Created 2 days ago·Updated about 15 hours ago· 5

WASasquatch/open-manager-comfyui

Nodes—

On cloudLocal install

Stars5

Updatedabout 15 hours ago

Readme

Open Manager for ComfyUI

https://github.com/user-attachments/assets/58e5d65e-ce23-464b-8c9a-2a249818a1d1

An alternative package manager for ComfyUI.

Browse the Comfy Registry with ease, install from registry or GitHub, and see what an install would do to your environment before it runs. It warns; it never blocks.

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

Why Open Manager?

ComfyUI Manager is a great package manager for ComfyUI, but it has some limitations:

It isn't transparent about the status of packages (e.g., flagged, withheld).
It quietly substitutes an approved version when the one you asked for is flagged, without telling you it did.
It installs without showing you the dependency changes an install would make to your environment.
It doesn't show each pack's licence, so there is no at-a-glance read on whether one fits your project.
It can install from a Git URL, but there is nowhere to keep those repositories: no list, no update path, no inspection.

Open Manager addresses these limitations by:

| | | | --- | --- | | Full registry | Every version and its status, flagged and withheld included | | Warn, never block (except the banned; shame!) | Risk changes the wording of the confirmation, not whether Install works | | Before you install | The findings against a version and the dependency changes it would make | | What's in the box | A GitHub install is read first. Compiled binaries, pickle-format data, bundled wheels and sourceless bytecode are named, with what each means. False positives possible | | Missing nodes | The packs for the node types a workflow is missing, matched against GitHub | | Your own list | A GitHub tab of repositories you add, kept in user/ so it outlives an uninstall | | Licences | Read from each pack and shown, sortable, most permissive first | | Trust the author | A pack from outside the registry asks who you are trusting before it installs, once per author or every time. Findings are shown either way | | Any ref | Read a pack's page at another branch or recent commit, README and gallery together, and install that ref to test a change | | Fast sync | The whole Comfy Registry in seconds, with the concurrency yours to set |

The only version that cannot be installed is one the registry has banned. Set OPEN_MANAGER_ALLOW_BANNED=1 to lift that too.

Installing

Two ways to load, one core. Pick either.

As a custom node, beside the official manager. Clone into custom_nodes and restart:

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

It coexists with ComfyUI-Manager and adds its own sidebar tab.

As a pip package, through --enable-manager:

pip uninstall comfyui-manager
pip install git+https://github.com/WASasquatch/open-manager-comfyui.git

# Launch ComfyUI with --enable-manager flag
python main.py --enable-manager

It takes the comfyui_manager name and replaces the official manager. A later install of comfyui-manager, or a desktop auto-update, puts the official one back.

Nothing is downloaded or built at load time.

Notes

Internet required. Open Manager reads the Comfy Registry live. It contacts these hosts, and only these:

| Host | When | |---|---| | api.comfy.org | browsing and installing | | cdn.comfy.org | downloading a registry version to install | | codeload.github.com | downloading a GitHub repository to install | | raw.githubusercontent.com | licences, READMEs, images | | api.github.com | a pack page's stats and gallery, branches and commits, starring, and the licence lookup when it is on | | wherever a pack points | a gallery entry given as an absolute URL. Turn galleries off to keep to the hosts above |

Where it appears. A sidebar tab on the current interface. On ComfyUI's legacy menu (Settings -> Comfy -> Use new menu -> Disabled) it adds an Open Manager button there instead. Where it replaces the manager, the top menu's Extensions button opens it too.

Classic Mode. On by default: Extensions opens a menu of destinations, the way ComfyUI-Manager did. Turn it off in settings to go straight to the panel. The sidebar tab is unaffected either way.

Trust. Incoporated a simple trust gate for certain actions with Open Manager. Make sure you trust the authors.

Settings. Under Settings -> Open Manager. Set open_manager.registry.BASE_URL to route the registry through a mirror or a private index. Set a GitHub token to raise the anonymous 60 calls an hour to 5,000; without one, pack pages still show their README, gallery and versions.

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" }

Trust. A pack from outside the registry asks who you are trusting before installing it, and again before loading a workflow of theirs. Answer once per author or every time, under Settings -> Open Manager. Trusted authors are written to user/open_manager/trusted_authors.json, and trust never hides a finding.

Your GitHub list. Add repositories by URL or as owner/repo. Each installs, updates and uninstalls like a registry pack. The list is written to user/open_manager/github_sources.json, outside the pack, so it survives an uninstall. Remove from list delists and uninstalls in one step.

For pack authors

Declare a [tool.open_manager] table in your pyproject.toml. Every field is optional and packs without the table are unaffected. For an installed pack these are read from the copy on disk, with the repository as the fallback.

[tool.open_manager]
incompatible = ["numpy>=2.0"]                   # declare known conflicts with other packages
source = "github"                               # prefer installing from the repository
branch = "main"                                 # default branch to install from
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
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` for clips
  "docs/*.png",                                 #   a path or glob in your repository
  "https://cdn.example.com/after.webp",         #   or a file hosted anywhere
]

Leave example_workflows out and workflows/, workflow/, examples/, example/ and example_workflows/ are read instead. An image named for a workflow beside it becomes its thumbnail. docs and funding fall back to [project.urls].

Theme format

A theme is a ComfyUI colour palette with an optional extras block. ComfyUI reads colors and ignores extras; Open Manager reads both. Themes listed in [tool.open_manager] themes appear on the pack page with an Add button. Copy one of the six in open_manager/themes/, change the id and the colours.

{
  "id": "my_theme",              // unique; the key it is stored under
  "name": "My Theme",            // shown in the theme picker
  "version": 1,                  // raise to publish a change
  "light_theme": true,           // light palettes must set this, or the interface stays dark

  "colors": {
    "node_slot":      { "IMAGE": "#64b5f6", "LATENT": "#ff9cf9" },   // wire colour per socket
    "litegraph_base": { "CLEAR_BACKGROUND_COLOR": "#211927",         // canvas
                        "NODE_DEFAULT_COLOR": "#f2ff59",             // node header
                        "NODE_DEFAULT_BGCOLOR": "#2e2438",           // node body
                        "BACKGROUND_IMAGE": "data:image/svg+xml;base64,..." },
    "comfy_base":     { "fg-color": "#f0efed", "bg-color": "#211927" }  // interface, incl. Open Manager
  },

  "extras": {
    "shape":      { "radius": 10, "titleHeight": 28, "slotHeight": 20 },
    "links":      { "mode": "spline", "border": false },   // spline | linear | straight
    "categories": { "loaders": "#352864", "sampling": "#4d3979" },  // header per node category
    "nodes":      { "KSampler": "#6b4fa8",                          // header per node class
                    "VAEDecode": { "color": "#71639a", "title": "Decode" } },
    "glow":       { "selected": "#f2ff59", "blur": 16 }             // static, on selection
  }
}

| | | | --- | --- | | Categories | Matched on the full lowercased category path, longest first, so was suite/image/masking wins over was suite/image. Core nodes also match the segment below model/ | | Precedence | A colour the user set on a node wins, then a nodes rule, then a categories tint | | Nothing is saved | Header, title and text colour are applied for the draw and undone after, so they never enter a saved workflow | | Bounded | Unknown keys are dropped and numbers are range-checked; there is no animation, and a theme cannot ask for one | | Scoped | Theme color palette extras apply only while your theme is active, and geometry is restored when the user switches away |

Licence

MIT, see LICENSE.