Install & Compatibility
Where this runs
tested against v4.2.1 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.920 runs
installs and imports cleanly · install 0.0s · import 0.000s · 288.6MB
glibcpy 3.10–3.920 runs
installs and imports cleanly · install 17.0s · import 0.000s · 268MB
295MB installed
● package 295MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
ComfyUI Manager
✓ ComfyUI Manager is primarily an extension integrated into ComfyUI. Direct programmatic imports for general end-user functionality are not its typical use case. Users interact with it via the ComfyUI GUI or its command-line interface (cm-cli).
ComfyUI Manager is designed as an extension/plugin for the ComfyUI application, not as a standalone Python library for direct import into arbitrary Python scripts. Its functionality is exposed through ComfyUI's user interface or a dedicated CLI tool.
After installing `comfyui-manager` via pip, launch your ComfyUI instance with the `--enable-manager` flag. This will enable the ComfyUI Manager interface within the ComfyUI application. For programmatic management outside the UI, the `cm-cli.py` tool located within the `ComfyUI/custom_nodes/ComfyUI-Manager` directory can be used to perform tasks like updating custom nodes.
# 1. Install ComfyUI-Manager via pip (recommended)
pip install comfyui-manager
# 2. Launch ComfyUI with the manager enabled
# (Ensure you are in your ComfyUI root directory or have activated its Python environment)
python main.py --enable-manager
# Optional: Use the command-line interface (cm-cli) for management tasks
# (Execute from your ComfyUI root directory)
# python custom_nodes/ComfyUI-Manager/cm-cli.py update all
# For portable Windows builds:
# .\python_embeded\python.exe ComfyUI\custom_nodes\ComfyUI-Manager\cm-cli.py update all
Debug
Known issues
breakingComfyUI Manager underwent significant integration changes with ComfyUI, particularly around ComfyUI v0.4.0. The Manager button might disappear, and it now requires the `--enable-manager` flag at ComfyUI launch. Older installations might break if ComfyUI is updated without enabling the manager or migrating configuration.fixEnsure ComfyUI is launched with `python main.py --enable-manager`. For users of portable ComfyUI, update `manager_requirements.txt` and launch with specific portable commands.
affects: ComfyUI versions around 0.4.0+
breakingIn ComfyUI-Manager v3.38, a security patch migrated manager data to a protected path. This change could break configurations relying on older, unprotected paths.fixReview the migration guide on the official GitHub page for details on adjusting paths, especially if upgrading from much older versions.
affects: 3.38+
gotchaIncorrect installation path for `git clone` can lead to the Manager not being recognized or updated properly. Common mistakes include double-nested folders (`ComfyUI/custom_nodes/ComfyUI-Manager/ComfyUI-Manager`) or incorrect folder names (`ComfyUI/custom_nodes/ComfyUI-Manager-main`).fixEnsure `comfyui-manager` files are located precisely in `ComfyUI/custom_nodes/comfyui-manager`. Remove any incorrectly installed versions and reinstall.
affects: All versions (for git-based installations)
gotchaUsers might encounter `KeyError: 'reference'` or 'Failed to get Custom Nodes' errors when opening the manager, indicating an outdated ComfyUI Manager installation.fixNavigate to the `ComfyUI/custom_nodes/ComfyUI-Manager` directory and run `git pull` to update the manager. Then, restart ComfyUI.
affects: Older versions prior to critical fixes
gotchaIf ComfyUI Manager does not appear after installation (especially for non-Desktop versions), ensure Git is installed and accessible in your system's PATH. Manager relies on Git for cloning and updating custom nodes.fixInstall Git for your operating system (e.g., Git for Windows) and ensure it's correctly added to your system's PATH environment variable. Restart ComfyUI.
affects: All versions
Upgrade
Version history
4.2.1latest on PyPI · released Apr 22, 2026
Audit
Dependencies
tomlrequiredConfiguration file parsing.
pygithubrequiredInteracting with GitHub API for node management.
typing-extensionsrequiredType hinting support.
richrequiredRich terminal output for CLI tools.
gitpythonrequiredProgrammatic interaction with Git repositories.
transformersrequiredPotentially for model-related functionalities or metadata.
typerrequiredBuilding command-line interfaces (cm-cli).
uvrequiredFast package installer and resolver, used for environment management.
huggingface-hubrequiredInteracting with Hugging Face Hub for models/datasets.
chardetrequiredCharacter encoding detection.