{"id":5884,"library":"comfyui-manager","title":"ComfyUI Manager","description":"ComfyUI Manager is an extension designed to enhance the usability of ComfyUI by providing features to install, update, remove, disable, and enable custom nodes and models. It also offers various functionalities to assist with ComfyUI workflows, including snapshot management and missing node detection. The current version is 4.1, and it follows the release cadence of ComfyUI, with frequent updates.","status":"active","version":"4.1","language":"en","source_language":"en","source_url":"https://github.com/ltdrdata/ComfyUI-Manager","tags":["ComfyUI","AI","workflow","custom nodes","manager","machine learning"],"install":[{"cmd":"pip install comfyui-manager","lang":"bash","label":"PyPI installation (recommended for latest features)"},{"cmd":"cd ComfyUI/custom_nodes\ngit clone https://github.com/ltdrdata/ComfyUI-Manager.git comfyui-manager","lang":"bash","label":"Git clone installation (legacy, may not support all new features)"}],"dependencies":[{"reason":"Configuration file parsing.","package":"toml"},{"reason":"Interacting with GitHub API for node management.","package":"pygithub"},{"reason":"Type hinting support.","package":"typing-extensions"},{"reason":"Rich terminal output for CLI tools.","package":"rich"},{"reason":"Programmatic interaction with Git repositories.","package":"gitpython"},{"reason":"Potentially for model-related functionalities or metadata.","package":"transformers"},{"reason":"Building command-line interfaces (cm-cli).","package":"typer"},{"reason":"Fast package installer and resolver, used for environment management.","package":"uv"},{"reason":"Interacting with Hugging Face Hub for models/datasets.","package":"huggingface-hub"},{"reason":"Character encoding detection.","package":"chardet"}],"imports":[{"note":"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.","symbol":"ComfyUI Manager","correct":"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)."}],"quickstart":{"code":"# 1. Install ComfyUI-Manager via pip (recommended)\npip install comfyui-manager\n\n# 2. Launch ComfyUI with the manager enabled\n# (Ensure you are in your ComfyUI root directory or have activated its Python environment)\npython main.py --enable-manager\n\n# Optional: Use the command-line interface (cm-cli) for management tasks\n# (Execute from your ComfyUI root directory)\n# python custom_nodes/ComfyUI-Manager/cm-cli.py update all\n# For portable Windows builds:\n# .\\python_embeded\\python.exe ComfyUI\\custom_nodes\\ComfyUI-Manager\\cm-cli.py update all","lang":"bash","description":"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."},"warnings":[{"fix":"Ensure ComfyUI is launched with `python main.py --enable-manager`. For users of portable ComfyUI, update `manager_requirements.txt` and launch with specific portable commands.","message":"ComfyUI 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.","severity":"breaking","affected_versions":"ComfyUI versions around 0.4.0+"},{"fix":"Review the migration guide on the official GitHub page for details on adjusting paths, especially if upgrading from much older versions.","message":"In ComfyUI-Manager v3.38, a security patch migrated manager data to a protected path. This change could break configurations relying on older, unprotected paths.","severity":"breaking","affected_versions":"3.38+"},{"fix":"Ensure `comfyui-manager` files are located precisely in `ComfyUI/custom_nodes/comfyui-manager`. Remove any incorrectly installed versions and reinstall.","message":"Incorrect 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`).","severity":"gotcha","affected_versions":"All versions (for git-based installations)"},{"fix":"Navigate to the `ComfyUI/custom_nodes/ComfyUI-Manager` directory and run `git pull` to update the manager. Then, restart ComfyUI.","message":"Users might encounter `KeyError: 'reference'` or 'Failed to get Custom Nodes' errors when opening the manager, indicating an outdated ComfyUI Manager installation.","severity":"gotcha","affected_versions":"Older versions prior to critical fixes"},{"fix":"Install 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.","message":"If 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.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"last_verified":"2026-04-14T00:00:00.000Z","next_check":"2026-07-13T00:00:00.000Z","problems":[]}