update DB

* Add ComfyUI-ArchAi3d-Qwen custom nodes

* Add new node entry for ComfyUI-GRAG-ArchAi3D

Adding GRAG (Guided Region-Adaptive Guidance) custom node with:
- Simple and Unified controllers
- Advanced sampler
- 54 presets
- Per-layer and adaptive control

* Update custom-node-list.json

* Update custom-node-list.json

---------

Co-authored-by: Dr.Lt.Data <128333288+ltdrdata@users.noreply.github.com>

.env.example

@@ -1 +0,0 @@
-PYPI_TOKEN=your-pypi-token

.github/workflows/ci.yml

@@ -1,70 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [ main, feat/*, fix/* ]
-  pull_request:
-    branches: [ main ]
-
-jobs:
-  validate-openapi:
-    name: Validate OpenAPI Specification
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v4
-    
-    - name: Check if OpenAPI changed
-      id: openapi-changed
-      uses: tj-actions/changed-files@v44
-      with:
-        files: openapi.yaml
-    
-    - name: Setup Node.js
-      if: steps.openapi-changed.outputs.any_changed == 'true'
-      uses: actions/setup-node@v4
-      with:
-        node-version: '18'
-    
-    - name: Install Redoc CLI
-      if: steps.openapi-changed.outputs.any_changed == 'true'
-      run: |
-        npm install -g @redocly/cli
-    
-    - name: Validate OpenAPI specification
-      if: steps.openapi-changed.outputs.any_changed == 'true'
-      run: |
-        redocly lint openapi.yaml
-
-  code-quality:
-    name: Code Quality Checks
-    runs-on: ubuntu-latest
-    steps:
-    - uses: actions/checkout@v4
-      with:
-        fetch-depth: 0  # Fetch all history for proper diff
-    
-    - name: Get changed Python files
-      id: changed-py-files
-      uses: tj-actions/changed-files@v44
-      with:
-        files: |
-          **/*.py
-        files_ignore: |
-          comfyui_manager/legacy/**
-          
-    - name: Setup Python
-      if: steps.changed-py-files.outputs.any_changed == 'true'
-      uses: actions/setup-python@v5
-      with:
-        python-version: '3.9'
-    
-    - name: Install dependencies
-      if: steps.changed-py-files.outputs.any_changed == 'true'
-      run: |
-        pip install ruff
-    
-    - name: Run ruff linting on changed files
-      if: steps.changed-py-files.outputs.any_changed == 'true'
-      run: |
-        echo "Changed files: ${{ steps.changed-py-files.outputs.all_changed_files }}"
-        echo "${{ steps.changed-py-files.outputs.all_changed_files }}" | xargs -r ruff check

.github/workflows/publish-to-pypi.yml

@@ -4,7 +4,7 @@ on:
   workflow_dispatch:
   push:
     branches:
-      - manager-v4
+      - draft-v4
     paths:
       - "pyproject.toml"
 
@@ -21,7 +21,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
-          python-version: '3.x'
+          python-version: '3.9'
 
       - name: Install build dependencies
         run: |
@@ -31,28 +31,28 @@ jobs:
       - name: Get current version
         id: current_version
         run: |
-          CURRENT_VERSION=$(grep -oP '^version = "\K[^"]+' pyproject.toml)
+          CURRENT_VERSION=$(grep -oP 'version = "\K[^"]+' pyproject.toml)
           echo "version=$CURRENT_VERSION" >> $GITHUB_OUTPUT
           echo "Current version: $CURRENT_VERSION"
 
       - name: Build package
         run: python -m build
 
-      # - name: Create GitHub Release
-      #   id: create_release
-      #   uses: softprops/action-gh-release@v2
-      #   env:
-      #     GITHUB_TOKEN: ${{ github.token }}
-      #   with:
-      #     files: dist/*
-      #     tag_name: v${{ steps.current_version.outputs.version }}
-      #     draft: false
-      #     prerelease: false
-      #     generate_release_notes: true
+      - name: Create GitHub Release
+        id: create_release
+        uses: softprops/action-gh-release@v2
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          files: dist/*
+          tag_name: v${{ steps.current_version.outputs.version }}
+          draft: false
+          prerelease: false
+          generate_release_notes: true
 
       - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@76f52bc884231f62b9a034ebfe128415bbaabdfc
+        uses: pypa/gh-action-pypi-publish@release/v1
         with:
           password: ${{ secrets.PYPI_TOKEN }}
           skip-existing: true
-          verbose: true
+          verbose: true 

.github/workflows/publish.yml

@@ -0,0 +1,25 @@
+name: Publish to Comfy registry
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main-blocked
+    paths:
+      - "pyproject.toml"
+
+permissions:
+  issues: write
+
+jobs:
+  publish-node:
+    name: Publish Custom Node to registry
+    runs-on: ubuntu-latest
+    if: ${{ github.repository_owner == 'ltdrdata' }}
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+      - name: Publish Custom Node
+        uses: Comfy-Org/publish-node-action@v1
+        with:
+          ## Add your own personal access token to your Github Repository secrets and reference it here.
+          personal_access_token: ${{ secrets.REGISTRY_ACCESS_TOKEN }}

.gitignore

@@ -17,8 +17,4 @@ github-stats-cache.json
 pip_overrides.json
 *.json
 check2.sh
-/venv/
-build
-dist
-*.egg-info
-.env
+/venv/

CONTRIBUTING.md

@@ -1,47 +0,0 @@
-## Testing Changes
-
-1. Activate the ComfyUI environment.
-
-2. Build package locally after making changes.
-
-```bash
-# from inside the ComfyUI-Manager directory, with the ComfyUI environment activated
-python -m build
-```
-
-3. Install the package locally in the ComfyUI environment.
-
-```bash
-# Uninstall existing package
-pip uninstall comfyui-manager
-
-# Install the locale package
-pip install dist/comfyui-manager-*.whl
-```
-
-4. Start ComfyUI.
-
-```bash
-# after navigating to the ComfyUI directory
-python main.py
-```
-
-## Manually Publish Test Version to PyPi
-
-1. Set the `PYPI_TOKEN` environment variable in env file.
-
-2. If manually publishing, you likely want to use a release candidate version, so set the version in [pyproject.toml](pyproject.toml) to something like `0.0.1rc1`.
-
-3. Build the package.
-
-```bash
-python -m build
-```
-
-4. Upload the package to PyPi.
-
-```bash
-python -m twine upload dist/* --username __token__ --password $PYPI_TOKEN
-```
-
-5. View at https://pypi.org/project/comfyui-manager/

MANIFEST.in

@@ -1,15 +0,0 @@
-include comfyui_manager/js/*
-include comfyui_manager/*.json
-include comfyui_manager/glob/*
-include LICENSE.txt
-include README.md
-include requirements.txt
-include pyproject.toml
-include custom-node-list.json
-include extension-node-list.json
-include extras.json
-include github-stats.json
-include model-list.json
-include alter-list.json
-include comfyui_manager/channels.list.template
-include comfyui_manager/pip-policy.json

README.md

@@ -5,7 +5,6 @@
 ![menu](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/refs/heads/Main/ComfyUI-Manager/images/dialog.jpg)
 
 ## NOTICE
-* V4.0: Modify the structure to be installable via pip instead of using git clone.
 * V3.16: Support for `uv` has been added. Set `use_uv` in `config.ini`.
 * V3.10: `double-click feature` is removed
   * This feature has been moved to https://github.com/ltdrdata/comfyui-connection-helper
@@ -14,26 +13,78 @@
 
 ## Installation
 
-* When installing the latest ComfyUI, it will be automatically installed as a dependency, so manual installation is no longer necessary.
+### Installation[method1] (General installation method: ComfyUI-Manager only)
 
-* Manual installation of the nightly version:
-    * Clone to a temporary directory (**Note:** Do **not** clone into `ComfyUI/custom_nodes`.)
-      ```  
-      git clone https://github.com/Comfy-Org/ComfyUI-Manager  
-      ```  
-    * Install via pip
-      ```  
-      cd ComfyUI-Manager  
-      pip install .  
-      ```
+To install ComfyUI-Manager in addition to an existing installation of ComfyUI, you can follow the following steps:
 
+1. Go to `ComfyUI/custom_nodes` dir in terminal (cmd)
+2. `git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager`
+3. Restart ComfyUI
+
+
+### Installation[method2] (Installation for portable ComfyUI version: ComfyUI-Manager only)
+1. install git 
+- https://git-scm.com/download/win
+- standalone version  
+- select option: use windows default console window
+2. Download [scripts/install-manager-for-portable-version.bat](https://github.com/ltdrdata/ComfyUI-Manager/raw/main/scripts/install-manager-for-portable-version.bat) into installed `"ComfyUI_windows_portable"` directory
+- Don't click. Right-click the link and choose 'Save As...'
+3. Double-click `install-manager-for-portable-version.bat` batch file
+
+![portable-install](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/Main/ComfyUI-Manager/images/portable-install.jpg)
+
+
+### Installation[method3] (Installation through comfy-cli: install ComfyUI and ComfyUI-Manager at once.)  
+> RECOMMENDED: comfy-cli provides various features to manage ComfyUI from the CLI.
+
+* **prerequisite: python 3, git**
+
+Windows:
+```commandline
+python -m venv venv
+venv\Scripts\activate
+pip install comfy-cli
+comfy install
+```
+
+Linux/macOS:
+```commandline
+python -m venv venv
+. venv/bin/activate
+pip install comfy-cli
+comfy install
+```
 * See also: https://github.com/Comfy-Org/comfy-cli
 
 
-## Front-end
+### Installation[method4] (Installation for Linux+venv: ComfyUI + ComfyUI-Manager)
 
-* The built-in front-end of ComfyUI-Manager is the legacy front-end. The front-end for ComfyUI-Manager is now provided via [ComfyUI Frontend](https://github.com/Comfy-Org/ComfyUI_frontend).
-* To enable the legacy front-end, set the environment variable `ENABLE_LEGACY_COMFYUI_MANAGER_FRONT` to `true` before running.
+To install ComfyUI with ComfyUI-Manager on Linux using a venv environment, you can follow these steps:
+* **prerequisite: python-is-python3, python3-venv, git**
+
+1. Download [scripts/install-comfyui-venv-linux.sh](https://github.com/ltdrdata/ComfyUI-Manager/raw/main/scripts/install-comfyui-venv-linux.sh) into empty install directory
+- Don't click. Right-click the link and choose 'Save As...'
+- ComfyUI will be installed in the subdirectory of the specified directory, and the directory will contain the generated executable script.
+2. `chmod +x install-comfyui-venv-linux.sh`
+3. `./install-comfyui-venv-linux.sh`
+
+### Installation Precautions
+* **DO**: `ComfyUI-Manager` files must be accurately located in the path `ComfyUI/custom_nodes/comfyui-manager`
+  * Installing in a compressed file format is not recommended.
+* **DON'T**: Decompress directly into the `ComfyUI/custom_nodes` location, resulting in the Manager contents like `__init__.py` being placed directly in that directory.
+  * You have to remove all ComfyUI-Manager files from `ComfyUI/custom_nodes`
+* **DON'T**: In a form where decompression occurs in a path such as `ComfyUI/custom_nodes/ComfyUI-Manager/ComfyUI-Manager`.
+* **DON'T**: In a form where decompression occurs in a path such as `ComfyUI/custom_nodes/ComfyUI-Manager-main`.
+  * In such cases, `ComfyUI-Manager` may operate, but it won't be recognized within `ComfyUI-Manager`, and updates cannot be performed. It also poses the risk of duplicate installations. Remove it and install properly via `git clone` method.
+
+
+You can execute ComfyUI by running either `./run_gpu.sh` or `./run_cpu.sh` depending on your system configuration.
+
+## Colab Notebook
+This repository provides Colab notebooks that allow you to install and use ComfyUI, including ComfyUI-Manager. To use ComfyUI, [click on this link](https://colab.research.google.com/github/ltdrdata/ComfyUI-Manager/blob/main/notebooks/comfyui_colab_with_manager.ipynb).
+* Support for installing ComfyUI
+* Support for basic installation of ComfyUI-Manager
+* Support for automatically installing dependencies of custom nodes upon restarting Colab notebooks.
 
 
 ## How To Use
@@ -125,7 +176,7 @@ The following settings are applied based on the section marked as `is_default`.
 ![model-install-dialog](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/Main/ComfyUI-Manager/images/snapshot.jpg)
 
 
-## cm-cli: command line tools for power user
+## cm-cli: command line tools for power users
 * A tool is provided that allows you to use the features of ComfyUI-Manager without running ComfyUI.
 * For more details, please refer to the [cm-cli documentation](docs/en/cm-cli.md).
 
@@ -171,7 +222,7 @@ The following settings are applied based on the section marked as `is_default`.
   * `<current timestamp>` Ensure that the timestamp is always unique.
     * "components" should have the same structure as the content of the file stored in `<USER_DIRECTORY>/default/ComfyUI-Manager/components`.
       * `<component name>`: The name should be in the format `<prefix>::<node name>`.
-        * `<compnent nodeata>`: In the nodedata of the group node.
+        * `<component node data>`: In the node data of the group node.
           * `<version>`: Only two formats are allowed: `major.minor.patch` or `major.minor`. (e.g. `1.0`, `2.2.1`)
           * `<datetime>`: Saved time
           * `<packname>`: If the packname is not empty, the category becomes packname/workflow, and it is saved in the <packname>.pack file in `<USER_DIRECTORY>/default/ComfyUI-Manager/components`.
@@ -189,7 +240,7 @@ The following settings are applied based on the section marked as `is_default`.
 * Dragging and dropping or pasting a single component will add a node. However, when adding multiple components, nodes will not be added.
 
 
-## Support of missing nodes installation
+## Support for installing missing nodes
 
 ![missing-menu](https://raw.githubusercontent.com/ltdrdata/ComfyUI-extension-tutorials/Main/ComfyUI-Manager/images/missing-menu.jpg)
 
@@ -215,24 +266,23 @@ The following settings are applied based on the section marked as `is_default`.
     downgrade_blacklist = <Set a list of packages to prevent downgrades. List them separated by commas.>
     security_level = <Set the security level => strong|normal|normal-|weak>
     always_lazy_install = <Whether to perform dependency installation on restart even in environments other than Windows.>
-    network_mode = <Set the network mode => public|private|offline|personal_cloud>
+    network_mode = <Set the network mode => public|private|offline>
     ```
 
     * network_mode:
       - public: An environment that uses a typical public network.
       - private: An environment that uses a closed network, where a private node DB is configured via `channel_url`. (Uses cache if available)
       - offline: An environment that does not use any external connections when using an offline network. (Uses cache if available)
-      - personal_cloud: Applies relaxed security features in cloud environments such as Google Colab or Runpod, where strong security is not required. 
 
 
 ## Additional Feature
 * Logging to file feature
   * This feature is enabled by default and can be disabled by setting `file_logging = False` in the `config.ini`.
 
-* Fix node(recreate): When right-clicking on a node and selecting `Fix node (recreate)`, you can recreate the node. The widget's values are reset, while the connections maintain those with the same names.
+* Fix node (recreate): When right-clicking on a node and selecting `Fix node (recreate)`, you can recreate the node. The widget's values are reset, while the connections maintain those with the same names.
   * It is used to correct errors in nodes of old workflows created before, which are incompatible with the version changes of custom nodes.
 
-* Double-Click Node Title: You can set the double click behavior of nodes in the ComfyUI-Manager menu.
+* Double-Click Node Title: You can set the double-click behavior of nodes in the ComfyUI-Manager menu.
   * `Copy All Connections`, `Copy Input Connections`: Double-clicking a node copies the connections of the nearest node.
     * This action targets the nearest node within a straight-line distance of 1000 pixels from the center of the node.
     * In the case of `Copy All Connections`, it duplicates existing outputs, but since it does not allow duplicate connections, the existing output connections of the original node are disconnected.
@@ -298,7 +348,7 @@ When you run the `scan.sh` script:
 
 * It updates the `github-stats.json`.
   * This uses the GitHub API, so set your token with `export GITHUB_TOKEN=your_token_here` to avoid quickly reaching the rate limit and malfunctioning.
-  * To skip this step, add the `--skip-update-stat` option.
+  * To skip this step, add the `--skip-stat-update` option.
 
 * The `--skip-all` option applies both `--skip-update` and `--skip-stat-update`.
 
@@ -306,40 +356,38 @@ When you run the `scan.sh` script:
 ## Troubleshooting
 * If your `git.exe` is installed in a specific location other than system git, please install ComfyUI-Manager and run ComfyUI. Then, specify the path including the file name in `git_exe = ` in the `<USER_DIRECTORY>/default/ComfyUI-Manager/config.ini` file that is generated.
 * If updating ComfyUI-Manager itself fails, please go to the **ComfyUI-Manager** directory and execute the command `git update-ref refs/remotes/origin/main a361cc1 && git fetch --all && git pull`.
-* If you encounter the error message `Overlapped Object has pending operation at deallocation on Comfyui Manager load` under Windows
+* If you encounter the error message `Overlapped Object has pending operation at deallocation on ComfyUI Manager load` under Windows
   * Edit `config.ini` file: add `windows_selector_event_loop_policy = True`
-* if `SSL: CERTIFICATE_VERIFY_FAILED` error is occured.
+* If the `SSL: CERTIFICATE_VERIFY_FAILED` error occurs.
   * Edit `config.ini` file: add `bypass_ssl = True`
 
 
 ## Security policy
-
-The security settings are applied based on whether the ComfyUI server's listener is non-local and whether the network mode is set to `personal_cloud`.
-
-* **non-local**: When the server is launched with `--listen` and is bound to a network range other than the local `127.` range, allowing remote IP access.
-* **personal\_cloud**: When the `network_mode` is set to `personal_cloud`.
-
-
-### Risky Level Table
-
-| Risky Level | features                                                                                                                              |
-|-------------|---------------------------------------------------------------------------------------------------------------------------------------|
-| high+       | * `Install via git url`, `pip install`<BR>* Installation of nodepack registered not in the `default channel`.                         |
-| high        | * Fix nodepack                                                                                                                        |
-| middle+     | * Uninstall/Update<BR>* Installation of nodepack registered in the `default channel`.<BR>* Restore/Remove Snapshot<BR>* Install model |
-| middle      | * Restart                                                                                                                             |
-| low         | * Update ComfyUI                                                                                                                      |
-
-
-### Security Level Table
-
-| Security Level | local                                                                                                                    | non-local (personal_cloud)                                                                                               | non-local (not personal_cloud) |
-|----------------|--------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------|--------------------------------|
-| strong         | * Only `weak` level risky features are allowed                                                                           | * Only `weak` level risky features are allowed                                                                           | * Only `weak` level risky features are allowed                               |
-| normal         | * `high+` and `high` level risky features are not allowed<BR>* `middle+` and `middle` level risky features are available | * `high+` and `high` level risky features are not allowed<BR>* `middle+` and `middle` level risky features are available | * `high+`, `high` and `middle+` level risky features are not allowed<BR>* `middle` level risky features are available
-| normal-        | * All features are available                                                                                             | * `high+` and `high` level risky features are not allowed<BR>* `middle+` and `middle` level risky features are available | * `high+`, `high` and `middle+` level risky features are not allowed<BR>* `middle` level risky features are available 
-| weak           | * All features are available                                                                                             | * All features are available                                                                                             | * `high+` and `middle+` level risky features are not allowed<BR>* `high`, `middle` and `low` level risky features are available
-
+  * Edit `config.ini` file: add `security_level = <LEVEL>`
+    * `strong`
+      * doesn't allow `high` and `middle` level risky feature
+    * `normal`
+      * doesn't allow `high` level risky feature
+      * `middle` level risky feature is available
+    * `normal-`
+      * doesn't allow `high` level risky feature if `--listen` is specified and not starts with `127.`
+      * `middle` level risky feature is available
+    * `weak`
+      * all feature is available
+    
+  * `high` level risky features
+    * `Install via git url`, `pip install`
+    * Installation of custom nodes registered not in the `default channel`.
+    * Fix custom nodes
+  
+  * `middle` level risky features
+    * Uninstall/Update
+    * Installation of custom nodes registered in the `default channel`.
+    * Restore/Remove Snapshot
+    * Restart
+  
+  * `low` level risky features
+    * Update ComfyUI
 
 
 # Disclaimer

__init__.py

@@ -0,0 +1,25 @@
+"""
+This file is the entry point for the ComfyUI-Manager package, handling CLI-only mode and initial setup.
+"""
+
+import os
+import sys
+
+cli_mode_flag = os.path.join(os.path.dirname(__file__), '.enable-cli-only-mode')
+
+if not os.path.exists(cli_mode_flag):
+    sys.path.append(os.path.join(os.path.dirname(__file__), "glob"))
+    import manager_server  # noqa: F401
+    import share_3rdparty  # noqa: F401
+    import cm_global
+
+    if not cm_global.disable_front and not 'DISABLE_COMFYUI_MANAGER_FRONT' in os.environ:
+        WEB_DIRECTORY = "js"
+else:
+    print("\n[ComfyUI-Manager] !! cli-only-mode is enabled !!\n")
+
+NODE_CLASS_MAPPINGS = {}
+__all__ = ['NODE_CLASS_MAPPINGS']
+
+
+

channels.list.template

@@ -0,0 +1,6 @@
+default::https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main
+recent::https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main/node_db/new
+legacy::https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main/node_db/legacy
+forked::https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main/node_db/forked
+dev::https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main/node_db/dev
+tutorial::https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main/node_db/tutorial

check.sh

@@ -37,7 +37,7 @@ find ~/.tmp/default -name "*.py" -print0 | xargs -0 grep -E "crypto|^_A="
 
 echo
 echo CHECK3
-find ~/.tmp/default -name "requirements.txt" | xargs grep "^\s*https\\?:"
-find ~/.tmp/default -name "requirements.txt" | xargs grep "\.whl"
+find ~/.tmp/default -name "requirements.txt" | xargs grep "^\s*[^#]*https\?:"
+find ~/.tmp/default -name "requirements.txt" | xargs grep "^\s*[^#].*\.whl"
 
 echo

cm-cli.py

@@ -15,31 +15,31 @@ import git
 import importlib
 
 
-from ..common import manager_util
+sys.path.append(os.path.dirname(__file__))
+sys.path.append(os.path.join(os.path.dirname(__file__), "glob"))
+
+import manager_util
 
 # read env vars
 # COMFYUI_FOLDERS_BASE_PATH is not required in cm-cli.py
 # `comfy_path` should be resolved before importing manager_core
-
 comfy_path = os.environ.get('COMFYUI_PATH')
-
 if comfy_path is None:
-    print("[bold red]cm-cli: environment variable 'COMFYUI_PATH' is not specified.[/bold red]")
-    exit(-1)
+    try:
+        import folder_paths
+        comfy_path = os.path.join(os.path.dirname(folder_paths.__file__))
+    except:
+        print("\n[bold yellow]WARN: The `COMFYUI_PATH` environment variable is not set. Assuming `custom_nodes/ComfyUI-Manager/../../` as the ComfyUI path.[/bold yellow]", file=sys.stderr)
+        comfy_path = os.path.abspath(os.path.join(manager_util.comfyui_manager_path, '..', '..'))
 
+# This should be placed here
 sys.path.append(comfy_path)
 
-if not os.path.exists(os.path.join(comfy_path, 'folder_paths.py')):
-    print("[bold red]cm-cli: '{comfy_path}' is not a valid 'COMFYUI_PATH' location.[/bold red]")
-    exit(-1)
-
-
 import utils.extra_config
-from ..common import cm_global
-from ..legacy import manager_core as core
-from ..common import context
-from ..legacy.manager_core import unified_manager
-from ..common import cnr_utils
+import cm_global
+import manager_core as core
+from manager_core import unified_manager
+import cnr_utils
 
 comfyui_manager_path = os.path.abspath(os.path.dirname(__file__))
 
@@ -66,7 +66,7 @@ def check_comfyui_hash():
         repo = git.Repo(comfy_path)
         core.comfy_ui_revision = len(list(repo.iter_commits('HEAD')))
         core.comfy_ui_commit_datetime = repo.head.commit.committed_datetime
-    except Exception:
+    except:
         print('[bold yellow]INFO: Frozen ComfyUI mode.[/bold yellow]')
         core.comfy_ui_revision = 0
         core.comfy_ui_commit_datetime = 0
@@ -82,7 +82,7 @@ def read_downgrade_blacklist():
     try:
         import configparser
         config = configparser.ConfigParser(strict=False)
-        config.read(context.manager_config_path)
+        config.read(core.manager_config.path)
         default_conf = config['default']
 
         if 'downgrade_blacklist' in default_conf:
@@ -90,7 +90,7 @@ def read_downgrade_blacklist():
             items = [x.strip() for x in items if x != '']
             cm_global.pip_downgrade_blacklist += items
             cm_global.pip_downgrade_blacklist = list(set(cm_global.pip_downgrade_blacklist))
-    except Exception:
+    except:
         pass
 
 
@@ -105,7 +105,7 @@ class Ctx:
         self.no_deps = False
         self.mode = 'cache'
         self.user_directory = None
-        self.custom_nodes_paths = [os.path.join(context.comfy_base_path, 'custom_nodes')]
+        self.custom_nodes_paths = [os.path.join(core.comfy_base_path, 'custom_nodes')]
         self.manager_files_directory = os.path.dirname(__file__)
         
         if Ctx.folder_paths is None:
@@ -143,14 +143,14 @@ class Ctx:
         if os.path.exists(extra_model_paths_yaml):
             utils.extra_config.load_extra_path_config(extra_model_paths_yaml)
 
-        context.update_user_directory(user_directory)
+        core.update_user_directory(user_directory)
 
-        if os.path.exists(context.manager_pip_overrides_path):
-            with open(context.manager_pip_overrides_path, 'r', encoding="UTF-8", errors="ignore") as json_file:
+        if os.path.exists(core.manager_pip_overrides_path):
+            with open(core.manager_pip_overrides_path, 'r', encoding="UTF-8", errors="ignore") as json_file:
                 cm_global.pip_overrides = json.load(json_file)
 
-        if os.path.exists(context.manager_pip_blacklist_path):
-            with open(context.manager_pip_blacklist_path, 'r', encoding="UTF-8", errors="ignore") as f:
+        if os.path.exists(core.manager_pip_blacklist_path):
+            with open(core.manager_pip_blacklist_path, 'r', encoding="UTF-8", errors="ignore") as f:
                 for x in f.readlines():
                     y = x.strip()
                     if y != '':
@@ -163,15 +163,15 @@ class Ctx:
 
     @staticmethod
     def get_startup_scripts_path():
-        return os.path.join(context.manager_startup_script_path, "install-scripts.txt")
+        return os.path.join(core.manager_startup_script_path, "install-scripts.txt")
 
     @staticmethod
     def get_restore_snapshot_path():
-        return os.path.join(context.manager_startup_script_path, "restore-snapshot.json")
+        return os.path.join(core.manager_startup_script_path, "restore-snapshot.json")
 
     @staticmethod
     def get_snapshot_path():
-        return context.manager_snapshot_path
+        return core.manager_snapshot_path
 
     @staticmethod
     def get_custom_nodes_paths():
@@ -438,11 +438,8 @@ def show_list(kind, simple=False):
     flag = kind in ['all', 'cnr', 'installed', 'enabled']
     for k, v in unified_manager.active_nodes.items():
         if flag:
-            cnr = unified_manager.cnr_map.get(k)
-            if cnr:
-                processed[k] = "[    ENABLED    ] ", cnr['name'], k, cnr['publisher']['name'], v[0]
-            else:
-                processed[k] = None
+            cnr = unified_manager.cnr_map[k]
+            processed[k] = "[    ENABLED    ] ", cnr['name'], k, cnr['publisher']['name'], v[0]
         else:
             processed[k] = None
 
@@ -462,11 +459,8 @@ def show_list(kind, simple=False):
             continue
 
         if flag:
-            cnr = unified_manager.cnr_map.get(k)  # NOTE: can this be None if removed from CNR after installed
-            if cnr:
-                processed[k] = "[    DISABLED   ] ", cnr['name'], k, cnr['publisher']['name'], ", ".join(list(v.keys()))
-            else:
-                processed[k] = None
+            cnr = unified_manager.cnr_map[k]
+            processed[k] = "[    DISABLED   ] ", cnr['name'], k, cnr['publisher']['name'], ", ".join(list(v.keys()))
         else:
             processed[k] = None
 
@@ -475,11 +469,8 @@ def show_list(kind, simple=False):
             continue
 
         if flag:
-            cnr = unified_manager.cnr_map.get(k)
-            if cnr:
-                processed[k] = "[    DISABLED   ] ", cnr['name'], k, cnr['publisher']['name'], 'nightly'
-            else:
-                processed[k] = None
+            cnr = unified_manager.cnr_map[k]
+            processed[k] = "[    DISABLED   ] ", cnr['name'], k, cnr['publisher']['name'], 'nightly'
         else:
             processed[k] = None
 
@@ -499,12 +490,9 @@ def show_list(kind, simple=False):
             continue
 
         if flag:
-            cnr = unified_manager.cnr_map.get(k)
-            if cnr:
-                ver_spec = v['latest_version']['version'] if 'latest_version' in v else '0.0.0'
-                processed[k] = "[ NOT INSTALLED ] ", cnr['name'], k, cnr['publisher']['name'], ver_spec
-            else:
-                processed[k] = None
+            cnr = unified_manager.cnr_map[k]
+            ver_spec = v['latest_version']['version'] if 'latest_version' in v else '0.0.0'
+            processed[k] = "[ NOT INSTALLED ] ", cnr['name'], k, cnr['publisher']['name'], ver_spec
         else:
             processed[k] = None
 
@@ -670,7 +658,7 @@ def install(
     cmd_ctx.set_channel_mode(channel, mode)
     cmd_ctx.set_no_deps(no_deps)
 
-    pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, context.manager_files_path)
+    pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, core.manager_files_path)
     for_each_nodes(nodes, act=install_node, exit_on_fail=exit_on_fail)
     pip_fixer.fix_broken()
 
@@ -708,7 +696,7 @@ def reinstall(
     cmd_ctx.set_channel_mode(channel, mode)
     cmd_ctx.set_no_deps(no_deps)
 
-    pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, context.manager_files_path)
+    pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, core.manager_files_path)
     for_each_nodes(nodes, act=reinstall_node)
     pip_fixer.fix_broken()
 
@@ -762,7 +750,7 @@ def update(
     if 'all' in nodes:
         asyncio.run(auto_save_snapshot())
 
-    pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, context.manager_files_path)
+    pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, core.manager_files_path)
 
     for x in nodes:
         if x.lower() in ['comfyui', 'comfy', 'all']:
@@ -863,7 +851,7 @@ def fix(
     if 'all' in nodes:
         asyncio.run(auto_save_snapshot())
 
-    pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, context.manager_files_path)
+    pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, core.manager_files_path)
     for_each_nodes(nodes, fix_node, allow_all=True)
     pip_fixer.fix_broken()
 
@@ -1140,7 +1128,7 @@ def restore_snapshot(
             print(f"[bold red]ERROR: `{snapshot_path}` is not exists.[/bold red]")
             exit(1)
 
-    pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, context.manager_files_path)
+    pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, core.manager_files_path)
     try:
         asyncio.run(core.restore_snapshot(snapshot_path, extras))
     except Exception:
@@ -1172,7 +1160,7 @@ def restore_dependencies(
     total = len(node_paths)
     i = 1
 
-    pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, context.manager_files_path)
+    pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, core.manager_files_path)
     for x in node_paths:
         print("----------------------------------------------------------------------------------------------------")
         print(f"Restoring [{i}/{total}]: {x}")
@@ -1191,7 +1179,7 @@ def post_install(
 ):
     path = os.path.expanduser(path)
 
-    pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, context.manager_files_path)
+    pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, core.manager_files_path)
     unified_manager.execute_install_script('', path, instant_execution=True)
     pip_fixer.fix_broken()
 
@@ -1231,11 +1219,11 @@ def install_deps(
         with open(deps, 'r', encoding="UTF-8", errors="ignore") as json_file:
             try:
                 json_obj = json.load(json_file)
-            except Exception:
+            except:
                 print(f"[bold red]Invalid json file: {deps}[/bold red]")
                 exit(1)
 
-            pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, context.manager_files_path)
+            pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, core.manager_files_path)
             for k in json_obj['custom_nodes'].keys():
                 state = core.simple_check_custom_node(k)
                 if state == 'installed':
@@ -1292,10 +1280,6 @@ def export_custom_node_ids(
                     print(f"{x['id']}@unknown", file=output_file)
 
 
-def main():
-    app()
-
-
 if __name__ == '__main__':
     sys.argv[0] = re.sub(r'(-script\.pyw|\.exe)?$', '', sys.argv[0])
     sys.exit(app())

cm-cli.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+python cm-cli.py $*

comfyui_manager/__init__.py

@@ -1,104 +0,0 @@
-import os
-import logging
-from aiohttp import web
-from .common.manager_security import HANDLER_POLICY
-from .common import manager_security
-from comfy.cli_args import args
-
-
-def prestartup():
-    from . import prestartup_script  # noqa: F401
-    logging.info('[PRE] ComfyUI-Manager')
-
-
-def start():
-    logging.info('[START] ComfyUI-Manager')
-    from .common import cm_global     # noqa: F401
-
-    if args.enable_manager:
-        if args.enable_manager_legacy_ui:
-            try:
-                from .legacy import manager_server  # noqa: F401
-                from .legacy import share_3rdparty  # noqa: F401
-                from .legacy import manager_core as core
-                import nodes
-
-                logging.info("[ComfyUI-Manager] Legacy UI is enabled.")
-                nodes.EXTENSION_WEB_DIRS['comfyui-manager-legacy'] = os.path.join(os.path.dirname(__file__), 'js')
-            except Exception as e:
-                print("Error enabling legacy ComfyUI Manager frontend:", e)
-                core = None
-        else:
-            from .glob import manager_server  # noqa: F401
-            from .glob import share_3rdparty  # noqa: F401
-            from .glob import manager_core as core
-
-        if core is not None:
-            manager_security.is_personal_cloud_mode = core.get_config()['network_mode'].lower() == 'personal_cloud'
-
-
-def should_be_disabled(fullpath:str) -> bool:
-    """
-    1. Disables the legacy ComfyUI-Manager.
-    2. The blocklist can be expanded later based on policies.
-    """
-    if args.enable_manager:
-        # In cases where installation is done via a zip archive, the directory name may not be comfyui-manager, and it may not contain a git repository.
-        # It is assumed that any installed legacy ComfyUI-Manager will have at least 'comfyui-manager' in its directory name.
-        dir_name = os.path.basename(fullpath).lower()
-        if 'comfyui-manager' in dir_name:
-            return True
-
-    return False
-
-
-def get_client_ip(request):
-    peername = request.transport.get_extra_info("peername")
-    if peername is not None:
-        host, port = peername
-        return host
-    
-    return "unknown"
-
-
-def create_middleware():
-    connected_clients = set()
-    is_local_mode = manager_security.is_loopback(args.listen)
-
-    @web.middleware
-    async def manager_middleware(request: web.Request, handler):
-        nonlocal connected_clients
-
-        # security policy for remote environments
-        prev_client_count = len(connected_clients)
-        client_ip = get_client_ip(request)
-        connected_clients.add(client_ip)
-        next_client_count = len(connected_clients)
-
-        if prev_client_count == 1 and next_client_count > 1:
-            manager_security.multiple_remote_alert()
-
-        policy = manager_security.get_handler_policy(handler)
-        is_banned = False
-
-        # policy check
-        if len(connected_clients) > 1:
-            if is_local_mode:
-                if HANDLER_POLICY.MULTIPLE_REMOTE_BAN_NON_LOCAL in policy:
-                    is_banned = True
-                if HANDLER_POLICY.MULTIPLE_REMOTE_BAN_NOT_PERSONAL_CLOUD in policy:
-                    is_banned = not manager_security.is_personal_cloud_mode
-
-        if HANDLER_POLICY.BANNED in policy:
-            is_banned = True
-
-        if is_banned:
-            logging.warning(f"[Manager] Banning request from {client_ip}: {request.path}")
-            response = web.Response(text="[Manager] This request is banned.", status=403)
-        else:
-            response: web.Response = await handler(request)
-
-        return response
-
-    return manager_middleware
-    

comfyui_manager/channels.list.template

@@ -1,6 +0,0 @@
-default::https://raw.githubusercontent.com/Comfy-Org/ComfyUI-Manager/main
-recent::https://raw.githubusercontent.com/Comfy-Org/ComfyUI-Manager/main/node_db/new
-legacy::https://raw.githubusercontent.com/Comfy-Org/ComfyUI-Manager/main/node_db/legacy
-forked::https://raw.githubusercontent.com/Comfy-Org/ComfyUI-Manager/main/node_db/forked
-dev::https://raw.githubusercontent.com/Comfy-Org/ComfyUI-Manager/main/node_db/dev
-tutorial::https://raw.githubusercontent.com/Comfy-Org/ComfyUI-Manager/main/node_db/tutorial

comfyui_manager/common/README.md

@@ -1,16 +0,0 @@
-# ComfyUI-Manager: Core Backend (glob)
-
-This directory contains the Python backend modules that power ComfyUI-Manager, handling the core functionality of node management, downloading, security, and server operations.
-
-## Core Modules
-
-- **manager_downloader.py**: Handles downloading operations for models, extensions, and other resources.
-- **manager_util.py**: Provides utility functions used throughout the system.
-
-## Specialized Modules
-
-- **cm_global.py**: Maintains global variables and state management across the system.
-- **cnr_utils.py**: Helper utilities for interacting with the custom node registry (CNR).
-- **git_utils.py**: Git-specific utilities for repository operations.
-- **node_package.py**: Handles the packaging and installation of node extensions.
-- **security_check.py**: Implements the multi-level security system for installation safety.

comfyui_manager/common/context.py

@@ -1,108 +0,0 @@
-import sys
-import os
-import logging
-from . import manager_util
-import toml
-import git
-
-
-# read env vars
-comfy_path: str = os.environ.get('COMFYUI_PATH')
-comfy_base_path = os.environ.get('COMFYUI_FOLDERS_BASE_PATH')
-
-if comfy_path is None:
-    try:
-        comfy_path = os.path.abspath(os.path.dirname(sys.modules['__main__'].__file__))
-        os.environ['COMFYUI_PATH'] = comfy_path
-    except Exception:
-        logging.error("[ComfyUI-Manager] environment variable 'COMFYUI_PATH' is not specified.")
-        exit(-1)
-
-if comfy_base_path is None:
-    comfy_base_path = comfy_path
-
-channel_list_template_path = os.path.join(manager_util.comfyui_manager_path, 'channels.list.template')
-git_script_path = os.path.join(manager_util.comfyui_manager_path, "git_helper.py")
-
-manager_files_path = None
-manager_config_path = None
-manager_channel_list_path = None
-manager_startup_script_path:str = None
-manager_snapshot_path = None
-manager_pip_overrides_path = None
-manager_pip_blacklist_path = None
-manager_components_path = None
-manager_batch_history_path = None
-
-def update_user_directory(user_dir):
-    global manager_files_path
-    global manager_config_path
-    global manager_channel_list_path
-    global manager_startup_script_path
-    global manager_snapshot_path
-    global manager_pip_overrides_path
-    global manager_pip_blacklist_path
-    global manager_components_path
-    global manager_batch_history_path
-
-    manager_files_path = os.path.abspath(os.path.join(user_dir, 'default', 'ComfyUI-Manager'))
-    if not os.path.exists(manager_files_path):
-        os.makedirs(manager_files_path)
-
-    manager_snapshot_path = os.path.join(manager_files_path, "snapshots")
-    if not os.path.exists(manager_snapshot_path):
-        os.makedirs(manager_snapshot_path)
-
-    manager_startup_script_path = os.path.join(manager_files_path, "startup-scripts")
-    if not os.path.exists(manager_startup_script_path):
-        os.makedirs(manager_startup_script_path)
-
-    manager_config_path = os.path.join(manager_files_path, 'config.ini')
-    manager_channel_list_path = os.path.join(manager_files_path, 'channels.list')
-    manager_pip_overrides_path = os.path.join(manager_files_path, "pip_overrides.json")
-    manager_pip_blacklist_path = os.path.join(manager_files_path, "pip_blacklist.list")
-    manager_components_path = os.path.join(manager_files_path, "components")
-    manager_util.cache_dir = os.path.join(manager_files_path, "cache")
-    manager_batch_history_path = os.path.join(manager_files_path, "batch_history")
-
-    if not os.path.exists(manager_util.cache_dir):
-        os.makedirs(manager_util.cache_dir)
-
-    if not os.path.exists(manager_batch_history_path):
-        os.makedirs(manager_batch_history_path)
-
-try:
-    import folder_paths
-    update_user_directory(folder_paths.get_user_directory())
-
-except Exception:
-    # fallback:
-    # This case is only possible when running with cm-cli, and in practice, this case is not actually used.
-    update_user_directory(os.path.abspath(manager_util.comfyui_manager_path))
-
-
-def get_current_comfyui_ver():
-    """
-    Extract version from pyproject.toml
-    """
-    toml_path = os.path.join(comfy_path, 'pyproject.toml')
-    if not os.path.exists(toml_path):
-        return None
-    else:
-        try:
-            with open(toml_path, "r", encoding="utf-8") as f:
-                data = toml.load(f)
-
-                project = data.get('project', {})
-                return project.get('version')
-        except Exception:
-            return None
-
-
-def get_comfyui_tag():
-    try:
-        with git.Repo(comfy_path) as repo:
-            return repo.git.describe('--tags')
-    except Exception:
-        return None
-

comfyui_manager/common/enums.py

@@ -1,18 +0,0 @@
-import enum
-
-class NetworkMode(enum.Enum):
-    PUBLIC = "public"
-    PRIVATE = "private"
-    OFFLINE = "offline"
-    PERSONAL_CLOUD = "personal_cloud"
-
-class SecurityLevel(enum.Enum):
-    STRONG = "strong"
-    NORMAL = "normal"
-    NORMAL_MINUS = "normal-minus"
-    WEAK = "weak"
-
-class DBMode(enum.Enum):
-    LOCAL = "local"
-    CACHE = "cache"
-    REMOTE = "remote"

comfyui_manager/common/manager_security.py

@@ -1,36 +0,0 @@
-from enum import Enum
-
-is_personal_cloud_mode = False
-handler_policy = {}
-
-class HANDLER_POLICY(Enum):
-    MULTIPLE_REMOTE_BAN_NON_LOCAL = 1
-    MULTIPLE_REMOTE_BAN_NOT_PERSONAL_CLOUD = 2
-    BANNED = 3
-
-
-def is_loopback(address):
-    import ipaddress
-    try:
-        return ipaddress.ip_address(address).is_loopback
-    except ValueError:
-        return False
-
-
-def do_nothing():
-    pass
-
-
-def get_handler_policy(x):
-    return handler_policy.get(x) or set()
-
-def add_handler_policy(x, policy):
-    s = handler_policy.get(x)
-    if s is None:
-        s = set()
-        handler_policy[x] = s
-    
-    s.add(policy)
-    
-    
-multiple_remote_alert = do_nothing

comfyui_manager/common/pip_util.design.en.md

@@ -1,713 +0,0 @@
-# Design Document for pip_util.py Implementation
-
-This is designed to minimize breaking existing installed dependencies.
-
-## List of Functions to Implement
-
-## Global Policy Management
-
-### Global Variables
-```python
-_pip_policy_cache = None  # Policy cache (program-wide, loaded once)
-```
-
-### Global Functions
-
-* get_pip_policy(): Returns policy for resolving pip dependency conflicts (lazy loading)
-  - **Call timing**: Called whenever needed (automatically loads only once on first call)
-  - **Purpose**: Returns policy cache, automatically loads if cache is empty
-  - **Execution flow**:
-    1. Declare global _pip_policy_cache
-    2. If _pip_policy_cache is already loaded, return immediately (prevent duplicate loading)
-    3. Read base policy file:
-       - Path: {manager_util.comfyui_manager_path}/pip-policy.json
-       - Use empty dictionary if file doesn't exist
-       - Log error and use empty dictionary if JSON parsing fails
-    4. Read user policy file:
-       - Path: {context.manager_files_path}/pip-policy.user.json
-       - Create empty JSON file if doesn't exist ({"_comment": "User-specific pip policy overrides"})
-       - Log warning and use empty dictionary if JSON parsing fails
-    5. Apply merge rules (merge by package name):
-       - Start with base policy as base
-       - For each package in user policy:
-         * Package only in user policy: add to base
-         * Package only in base policy: keep in base
-         * Package in both: completely replace with user policy (entire package replacement, not section-level)
-    6. Store merged policy in _pip_policy_cache
-    7. Log policy load success (include number of loaded package policies)
-    8. Return _pip_policy_cache
-  - **Return value**: Dict (merged policy dictionary)
-  - **Exception handling**:
-    - File read failure: Log warning and treat file as empty dictionary
-    - JSON parsing failure: Log error and treat file as empty dictionary
-  - **Notes**:
-    - Lazy loading pattern automatically loads on first call
-    - Not thread-safe, caution needed in multi-threaded environments
-
-- Policy file structure should support the following scenarios:
-    - Dictionary structure of {dependency name -> policy object}
-    - Policy object has four policy sections:
-        - **uninstall**: Package removal policy (pre-processing, condition optional)
-        - **apply_first_match**: Evaluate top-to-bottom and execute only the first policy that satisfies condition (exclusive)
-        - **apply_all_matches**: Execute all policies that satisfy conditions (cumulative)
-        - **restore**: Package restoration policy (post-processing, condition optional)
-
-    - Condition types:
-        - installed: Check version condition of already installed dependencies
-            - spec is optional
-            - package field: Specify package to check (optional, defaults to self)
-                - Explicit: Reference another package (e.g., numba checks numpy version)
-                - Omitted: Check own version (e.g., critical-package checks its own version)
-        - platform: Platform conditions (os, has_gpu, comfyui_version, etc.)
-        - If condition is absent, always considered satisfied
-
-    - uninstall policy (pre-removal policy):
-        - Removal policy list (condition is optional, evaluate top-to-bottom and execute only first match)
-        - When condition satisfied (or always if no condition): remove target package and abort installation
-        - If this policy is applied, all subsequent steps are ignored
-        - target field specifies package to remove
-        - Example: Unconditionally remove if specific package is installed
-
-    - Actions available in apply_first_match (determine installation method, exclusive):
-        - skip: Block installation of specific dependency
-        - force_version: Force change to specific version during installation
-            - extra_index_url field can specify custom package repository (optional)
-        - replace: Replace with different dependency
-            - extra_index_url field can specify custom package repository (optional)
-
-    - Actions available in apply_all_matches (installation options, cumulative):
-        - pin_dependencies: Pin currently installed versions of other dependencies
-            - pinned_packages field specifies package list
-            - Example: `pip install requests urllib3==1.26.15 certifi==2023.7.22 charset-normalizer==3.2.0`
-            - Real use case: Prevent urllib3 from upgrading to 2.x when installing requests
-            - on_failure: "fail" or "retry_without_pin"
-        - install_with: Specify additional dependencies to install together
-        - warn: Record warning message in log
-
-    - restore policy (post-restoration policy):
-        - Restoration policy list (condition is optional, evaluate top-to-bottom and execute only first match)
-        - Executed after package installation completes (post-processing)
-        - When condition satisfied (or always if no condition): force install target package to specific version
-        - target field specifies package to restore (can be different package)
-        - version field specifies version to install
-        - extra_index_url field can specify custom package repository (optional)
-        - Example: Reinstall/change version if specific package is deleted or wrong version
-
-    - Execution order:
-        1. uninstall evaluation: If condition satisfied, remove package and **terminate** (ignore subsequent steps)
-        2. apply_first_match evaluation:
-            - Execute first policy that satisfies condition among skip/force_version/replace
-            - If no matching policy, proceed with default installation of originally requested package
-        3. apply_all_matches evaluation: Apply all pin_dependencies, install_with, warn that satisfy conditions
-        4. Execute actual package installation (pip install or uv pip install)
-        5. restore evaluation: If condition satisfied, restore target package (post-processing)
-
-## Batch Unit Class (PipBatch)
-
-### Class Structure
-```python
-class PipBatch:
-    """
-    pip package installation batch unit manager
-    Maintains pip freeze cache during batch operations for performance optimization
-
-    Usage pattern:
-        # Batch operations (policy auto-loaded)
-        with PipBatch() as batch:
-            batch.ensure_not_installed()
-            batch.install("numpy>=1.20")
-            batch.install("pandas>=2.0")
-            batch.install("scipy>=1.7")
-            batch.ensure_installed()
-    """
-
-    def __init__(self):
-        self._installed_cache = None   # Installed packages cache (batch-level)
-
-    def __enter__(self):
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        self._installed_cache = None
-```
-
-### Private Methods
-
-* PipBatch._refresh_installed_cache():
-  - **Purpose**: Read currently installed package information and refresh cache
-  - **Execution flow**:
-    1. Generate command using manager_util.make_pip_cmd(["freeze"])
-    2. Execute pip freeze via subprocess
-    3. Parse output:
-       - Each line is in "package_name==version" format
-       - Parse "package_name==version" to create dictionary
-       - Ignore editable packages (starting with -e)
-       - Ignore comments (starting with #)
-    4. Store parsed dictionary in self._installed_cache
-  - **Return value**: None
-  - **Exception handling**:
-    - pip freeze failure: Set cache to empty dictionary and log warning
-    - Parse failure: Ignore line and continue
-
-* PipBatch._get_installed_packages():
-  - **Purpose**: Return cached installed package information (refresh if cache is None)
-  - **Execution flow**:
-    1. If self._installed_cache is None, call _refresh_installed_cache()
-    2. Return self._installed_cache
-  - **Return value**: {package_name: version} dictionary
-
-* PipBatch._invalidate_cache():
-  - **Purpose**: Invalidate cache after package install/uninstall
-  - **Execution flow**:
-    1. Set self._installed_cache = None
-  - **Return value**: None
-  - **Call timing**: After install(), ensure_not_installed(), ensure_installed()
-
-* PipBatch._parse_package_spec(package_info):
-  - **Purpose**: Split package spec string into package name and version spec
-  - **Parameters**:
-    - package_info: "numpy", "numpy==1.26.0", "numpy>=1.20.0", "numpy~=1.20", etc.
-  - **Execution flow**:
-    1. Use regex to split package name and version spec
-    2. Pattern: `^([a-zA-Z0-9_-]+)([><=!~]+.*)?$`
-  - **Return value**: (package_name, version_spec) tuple
-    - Examples: ("numpy", "==1.26.0"), ("pandas", ">=2.0.0"), ("scipy", None)
-  - **Exception handling**:
-    - Parse failure: Raise ValueError
-
-* PipBatch._evaluate_condition(condition, package_name, installed_packages):
-  - **Purpose**: Evaluate policy condition and return whether satisfied
-  - **Parameters**:
-    - condition: Policy condition object (dictionary)
-    - package_name: Name of package currently being processed
-    - installed_packages: {package_name: version} dictionary
-  - **Execution flow**:
-    1. If condition is None, return True (always satisfied)
-    2. Branch based on condition["type"]:
-       a. "installed" type:
-          - target_package = condition.get("package", package_name)
-          - Check current version with installed_packages.get(target_package)
-          - If not installed (None), return False
-          - If spec exists, compare version using packaging.specifiers.SpecifierSet
-          - If no spec, only check installation status (True)
-       b. "platform" type:
-          - If condition["os"] exists, compare with platform.system()
-          - If condition["has_gpu"] exists, check GPU presence (torch.cuda.is_available(), etc.)
-          - If condition["comfyui_version"] exists, compare ComfyUI version
-          - Return True if all conditions satisfied
-    3. Return True if all conditions satisfied, False if any unsatisfied
-  - **Return value**: bool
-  - **Exception handling**:
-    - Version comparison failure: Log warning and return False
-    - Unknown condition type: Log warning and return False
-
-
-### Public Methods
-
-* PipBatch.install(package_info, extra_index_url=None, override_policy=False):
-  - **Purpose**: Perform policy-based pip package installation (individual package basis)
-  - **Parameters**:
-    - package_info: Package name and version spec (e.g., "numpy", "numpy==1.26.0", "numpy>=1.20.0")
-    - extra_index_url: Additional package repository URL (optional)
-    - override_policy: If True, skip policy application and install directly (default: False)
-  - **Execution flow**:
-    1. Call get_pip_policy() to get policy (lazy loading)
-    2. Use self._parse_package_spec() to split package_info into package name and version spec
-    3. Call self._get_installed_packages() to get cached installed package information
-    4. If override_policy=True → Jump directly to step 10 (skip policy)
-    5. Get policy for package name from policy dictionary
-    6. If no policy → Jump to step 10 (default installation)
-    7. **apply_first_match policy evaluation** (exclusive - only first match):
-       - Iterate through policy list top-to-bottom
-       - Evaluate each policy's condition with self._evaluate_condition()
-       - When first condition-satisfying policy found:
-         * type="skip": Log reason and return False (don't install)
-         * type="force_version": Change package_info version to policy's version
-         * type="replace": Completely replace package_info with policy's replacement package
-       - If no matching policy, keep original package_info
-    8. **apply_all_matches policy evaluation** (cumulative - all matches):
-       - Iterate through policy list top-to-bottom
-       - Evaluate each policy's condition with self._evaluate_condition()
-       - For all condition-satisfying policies:
-         * type="pin_dependencies":
-           - For each package in pinned_packages, query current version with self._installed_cache.get(pkg)
-           - Pin to installed version in "package==version" format
-           - Add to installation package list
-         * type="install_with":
-           - Add additional_packages to installation package list
-         * type="warn":
-           - Output message as warning log
-           - If allow_continue=false, wait for user confirmation (optional)
-    9. Compose final installation package list:
-       - Main package (modified/replaced package_info)
-       - Packages pinned by pin_dependencies
-       - Packages added by install_with
-    10. Handle extra_index_url:
-       - Parameter-passed extra_index_url takes priority
-       - Otherwise use extra_index_url defined in policy
-    11. Generate pip/uv command using manager_util.make_pip_cmd():
-       - Basic format: ["pip", "install"] + package list
-       - If extra_index_url exists: add ["--extra-index-url", url]
-    12. Execute command via subprocess
-    13. Handle installation failure:
-       - If pin_dependencies's on_failure="retry_without_pin":
-         * Retry with only main package excluding pinned packages
-       - If on_failure="fail":
-         * Raise exception and abort installation
-       - Otherwise: Log warning and continue
-    14. On successful installation:
-       - Call self._invalidate_cache() (invalidate cache)
-       - Log info if reason exists
-       - Return True
-  - **Return value**: Installation success status (bool)
-  - **Exception handling**:
-    - Policy parsing failure: Log warning and proceed with default installation
-    - Installation failure: Log error and raise exception (depends on on_failure setting)
-  - **Notes**:
-    - restore policy not handled in this method (batch-processed in ensure_installed())
-    - uninstall policy not handled in this method (batch-processed in ensure_not_installed())
-
-* PipBatch.ensure_not_installed():
-  - **Purpose**: Iterate through all policies and remove all packages satisfying uninstall conditions (batch processing)
-  - **Parameters**: None
-  - **Execution flow**:
-    1. Call get_pip_policy() to get policy (lazy loading)
-    2. Call self._get_installed_packages() to get cached installed package information
-    3. Iterate through all package policies in policy dictionary:
-       a. Check if each package has uninstall policy
-       b. If uninstall policy exists:
-          - Iterate through uninstall policy list top-to-bottom
-          - Evaluate each policy's condition with self._evaluate_condition()
-          - When first condition-satisfying policy found:
-            * Check if target package exists in self._installed_cache
-            * If installed:
-              - Generate command with manager_util.make_pip_cmd(["uninstall", "-y", target])
-              - Execute pip uninstall via subprocess
-              - Log reason in info log
-              - Add to removed package list
-              - Remove package from self._installed_cache
-            * Move to next package (only first match per package)
-    4. Complete iteration through all package policies
-  - **Return value**: List of removed package names (list of str)
-  - **Exception handling**:
-    - Individual package removal failure: Log warning only and continue to next package
-  - **Call timing**:
-    - Called at batch operation start to pre-remove conflicting packages
-    - Called before multiple package installations to clean installation environment
-
-* PipBatch.ensure_installed():
-  - **Purpose**: Iterate through all policies and restore all packages satisfying restore conditions (batch processing)
-  - **Parameters**: None
-  - **Execution flow**:
-    1. Call get_pip_policy() to get policy (lazy loading)
-    2. Call self._get_installed_packages() to get cached installed package information
-    3. Iterate through all package policies in policy dictionary:
-       a. Check if each package has restore policy
-       b. If restore policy exists:
-          - Iterate through restore policy list top-to-bottom
-          - Evaluate each policy's condition with self._evaluate_condition()
-          - When first condition-satisfying policy found:
-            * Get target package name (policy's "target" field)
-            * Get version specified in version field
-            * Check current version with self._installed_cache.get(target)
-            * If current version is None or different from specified version:
-              - Compose as package_spec = f"{target}=={version}" format
-              - Generate command with manager_util.make_pip_cmd(["install", package_spec])
-              - If extra_index_url exists, add ["--extra-index-url", url]
-              - Execute pip install via subprocess
-              - Log reason in info log
-              - Add to restored package list
-              - Update cache: self._installed_cache[target] = version
-            * Move to next package (only first match per package)
-    4. Complete iteration through all package policies
-  - **Return value**: List of restored package names (list of str)
-  - **Exception handling**:
-    - Individual package installation failure: Log warning only and continue to next package
-  - **Call timing**:
-    - Called at batch operation end to restore essential package versions
-    - Called for environment verification after multiple package installations
-
-
-## pip-policy.json Examples
-
-### Base Policy File ({manager_util.comfyui_manager_path}/pip-policy.json)
-```json
-{
-  "torch": {
-    "apply_first_match": [
-      {
-        "type": "skip",
-        "reason": "PyTorch installation should be managed manually due to CUDA compatibility"
-      }
-    ]
-  },
-
-  "opencv-python": {
-    "apply_first_match": [
-      {
-        "type": "replace",
-        "replacement": "opencv-contrib-python",
-        "version": ">=4.8.0",
-        "reason": "opencv-contrib-python includes all opencv-python features plus extras"
-      }
-    ]
-  },
-
-  "PIL": {
-    "apply_first_match": [
-      {
-        "type": "replace",
-        "replacement": "Pillow",
-        "reason": "PIL is deprecated, use Pillow instead"
-      }
-    ]
-  },
-
-  "click": {
-    "apply_first_match": [
-      {
-        "condition": {
-          "type": "installed",
-          "package": "colorama",
-          "spec": "<0.5.0"
-        },
-        "type": "force_version",
-        "version": "8.1.3",
-        "reason": "click 8.1.3 compatible with colorama <0.5"
-      }
-    ],
-    "apply_all_matches": [
-      {
-        "type": "pin_dependencies",
-        "pinned_packages": ["colorama"],
-        "reason": "Prevent colorama upgrade that may break compatibility"
-      }
-    ]
-  },
-
-  "requests": {
-    "apply_all_matches": [
-      {
-        "type": "pin_dependencies",
-        "pinned_packages": ["urllib3", "certifi", "charset-normalizer"],
-        "on_failure": "retry_without_pin",
-        "reason": "Prevent urllib3 from upgrading to 2.x which has breaking changes"
-      }
-    ]
-  },
-
-  "six": {
-    "restore": [
-      {
-        "target": "six",
-        "version": "1.16.0",
-        "reason": "six must be maintained at 1.16.0 for compatibility"
-      }
-    ]
-  },
-
-  "urllib3": {
-    "restore": [
-      {
-        "condition": {
-          "type": "installed",
-          "spec": "!=1.26.15"
-        },
-        "target": "urllib3",
-        "version": "1.26.15",
-        "reason": "urllib3 must be 1.26.15 for compatibility with legacy code"
-      }
-    ]
-  },
-
-  "onnxruntime": {
-    "apply_first_match": [
-      {
-        "condition": {
-          "type": "platform",
-          "os": "linux",
-          "has_gpu": true
-        },
-        "type": "replace",
-        "replacement": "onnxruntime-gpu",
-        "reason": "Use GPU version on Linux with CUDA"
-      }
-    ]
-  },
-
-  "legacy-custom-node-package": {
-    "apply_first_match": [
-      {
-        "condition": {
-          "type": "platform",
-          "comfyui_version": "<1.0.0"
-        },
-        "type": "force_version",
-        "version": "0.9.0",
-        "reason": "legacy-custom-node-package 0.9.0 is compatible with ComfyUI <1.0.0"
-      },
-      {
-        "condition": {
-          "type": "platform",
-          "comfyui_version": ">=1.0.0"
-        },
-        "type": "force_version",
-        "version": "1.5.0",
-        "reason": "legacy-custom-node-package 1.5.0 is required for ComfyUI >=1.0.0"
-      }
-    ]
-  },
-
-  "tensorflow": {
-    "apply_all_matches": [
-      {
-        "condition": {
-          "type": "installed",
-          "package": "torch"
-        },
-        "type": "warn",
-        "message": "Installing TensorFlow alongside PyTorch may cause CUDA conflicts",
-        "allow_continue": true
-      }
-    ]
-  },
-
-  "some-package": {
-    "uninstall": [
-      {
-        "condition": {
-          "type": "installed",
-          "package": "conflicting-package",
-          "spec": ">=2.0.0"
-        },
-        "target": "conflicting-package",
-        "reason": "conflicting-package >=2.0.0 conflicts with some-package"
-      }
-    ]
-  },
-
-  "banned-malicious-package": {
-    "uninstall": [
-      {
-        "target": "banned-malicious-package",
-        "reason": "Security vulnerability CVE-2024-XXXXX, always remove if attempting to install"
-      }
-    ]
-  },
-
-  "critical-package": {
-    "restore": [
-      {
-        "condition": {
-          "type": "installed",
-          "package": "critical-package",
-          "spec": "!=1.2.3"
-        },
-        "target": "critical-package",
-        "version": "1.2.3",
-        "extra_index_url": "https://custom-repo.example.com/simple",
-        "reason": "critical-package must be version 1.2.3, restore if different or missing"
-      }
-    ]
-  },
-
-  "stable-package": {
-    "apply_first_match": [
-      {
-        "condition": {
-          "type": "installed",
-          "package": "critical-dependency",
-          "spec": ">=2.0.0"
-        },
-        "type": "force_version",
-        "version": "1.5.0",
-        "extra_index_url": "https://custom-repo.example.com/simple",
-        "reason": "stable-package 1.5.0 is required when critical-dependency >=2.0.0 is installed"
-      }
-    ]
-  },
-
-  "new-experimental-package": {
-    "apply_all_matches": [
-      {
-        "type": "pin_dependencies",
-        "pinned_packages": ["numpy", "pandas", "scipy"],
-        "on_failure": "retry_without_pin",
-        "reason": "new-experimental-package may upgrade numpy/pandas/scipy, pin them to prevent breakage"
-      }
-    ]
-  },
-
-  "pytorch-addon": {
-    "apply_all_matches": [
-      {
-        "condition": {
-          "type": "installed",
-          "package": "torch",
-          "spec": ">=2.0.0"
-        },
-        "type": "pin_dependencies",
-        "pinned_packages": ["torch", "torchvision", "torchaudio"],
-        "on_failure": "fail",
-        "reason": "pytorch-addon must not change PyTorch ecosystem versions"
-      }
-    ]
-  }
-}
-```
-
-### Policy Structure Schema
-```json
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "type": "object",
-  "patternProperties": {
-    "^.*$": {
-      "type": "object",
-      "properties": {
-        "uninstall": {
-          "type": "array",
-          "description": "When condition satisfied (or always if no condition), remove package and terminate",
-          "items": {
-            "type": "object",
-            "required": ["target"],
-            "properties": {
-              "condition": {
-                "type": "object",
-                "description": "Optional: always remove if absent",
-                "required": ["type"],
-                "properties": {
-                  "type": {"enum": ["installed", "platform"]},
-                  "package": {"type": "string", "description": "Optional: defaults to self"},
-                  "spec": {"type": "string", "description": "Optional: version condition"},
-                  "os": {"type": "string"},
-                  "has_gpu": {"type": "boolean"},
-                  "comfyui_version": {"type": "string"}
-                }
-              },
-              "target": {
-                "type": "string",
-                "description": "Package name to remove"
-              },
-              "reason": {"type": "string"}
-            }
-          }
-        },
-        "restore": {
-          "type": "array",
-          "description": "When condition satisfied (or always if no condition), restore package and terminate",
-          "items": {
-            "type": "object",
-            "required": ["target", "version"],
-            "properties": {
-              "condition": {
-                "type": "object",
-                "description": "Optional: always restore if absent",
-                "required": ["type"],
-                "properties": {
-                  "type": {"enum": ["installed", "platform"]},
-                  "package": {"type": "string", "description": "Optional: defaults to self"},
-                  "spec": {"type": "string", "description": "Optional: version condition"},
-                  "os": {"type": "string"},
-                  "has_gpu": {"type": "boolean"},
-                  "comfyui_version": {"type": "string"}
-                }
-              },
-              "target": {
-                "type": "string",
-                "description": "Package name to restore"
-              },
-              "version": {
-                "type": "string",
-                "description": "Version to restore"
-              },
-              "extra_index_url": {"type": "string"},
-              "reason": {"type": "string"}
-            }
-          }
-        },
-        "apply_first_match": {
-          "type": "array",
-          "description": "Execute only first condition-satisfying policy (exclusive)",
-          "items": {
-            "type": "object",
-            "required": ["type"],
-            "properties": {
-              "condition": {
-                "type": "object",
-                "description": "Optional: always apply if absent",
-                "required": ["type"],
-                "properties": {
-                  "type": {"enum": ["installed", "platform"]},
-                  "package": {"type": "string", "description": "Optional: defaults to self"},
-                  "spec": {"type": "string", "description": "Optional: version condition"},
-                  "os": {"type": "string"},
-                  "has_gpu": {"type": "boolean"},
-                  "comfyui_version": {"type": "string"}
-                }
-              },
-              "type": {
-                "enum": ["skip", "force_version", "replace"],
-                "description": "Exclusive action: determines installation method"
-              },
-              "version": {"type": "string"},
-              "replacement": {"type": "string"},
-              "extra_index_url": {"type": "string"},
-              "reason": {"type": "string"}
-            }
-          }
-        },
-        "apply_all_matches": {
-          "type": "array",
-          "description": "Execute all condition-satisfying policies (cumulative)",
-          "items": {
-            "type": "object",
-            "required": ["type"],
-            "properties": {
-              "condition": {
-                "type": "object",
-                "description": "Optional: always apply if absent",
-                "required": ["type"],
-                "properties": {
-                  "type": {"enum": ["installed", "platform"]},
-                  "package": {"type": "string", "description": "Optional: defaults to self"},
-                  "spec": {"type": "string", "description": "Optional: version condition"},
-                  "os": {"type": "string"},
-                  "has_gpu": {"type": "boolean"},
-                  "comfyui_version": {"type": "string"}
-                }
-              },
-              "type": {
-                "enum": ["pin_dependencies", "install_with", "warn"],
-                "description": "Cumulative action: adds installation options"
-              },
-              "pinned_packages": {
-                "type": "array",
-                "items": {"type": "string"}
-              },
-              "on_failure": {"enum": ["fail", "retry_without_pin"]},
-              "additional_packages": {"type": "array"},
-              "message": {"type": "string"},
-              "allow_continue": {"type": "boolean"},
-              "reason": {"type": "string"}
-            }
-          }
-        }
-      }
-    }
-  }
-}
-```
-
-
-## Error Handling
-
-* Default behavior when errors occur during policy execution:
-    - Log error and continue
-    - Only treat as installation failure when pin_dependencies's on_failure="fail"
-    - For other cases, leave warning and attempt originally requested installation
-
-
-* pip_install: Performs pip package installation
-- Use manager_util.make_pip_cmd to generate commands for selective application of uv and pip
-- Provide functionality to skip policy application through override_policy flag

comfyui_manager/common/pip_util.implementation-plan.en.md

@@ -1,614 +0,0 @@
-# pip_util.py Implementation Plan Document
-
-## 1. Project Overview
-
-### Purpose
-Implement a policy-based pip package management system that minimizes breaking existing installed dependencies
-
-### Core Features
-- JSON-based policy file loading and merging (lazy loading)
-- Per-package installation policy evaluation and application
-- Performance optimization through batch-level pip freeze caching
-- Automated conditional package removal/restoration
-
-### Technology Stack
-- Python 3.x
-- packaging library (version comparison)
-- subprocess (pip command execution)
-- json (policy file parsing)
-
----
-
-## 2. Architecture Design
-
-### 2.1 Global Policy Management (Lazy Loading Pattern)
-
-```
-┌─────────────────────────────────────┐
-│  get_pip_policy()                   │
-│  - Auto-loads policy files on       │
-│    first call via lazy loading      │
-│  - Returns cache on subsequent calls│
-└─────────────────────────────────────┘
-           │
-           ▼
-┌─────────────────────────────────────┐
-│  _pip_policy_cache (global)         │
-│  - Merged policy dictionary         │
-│  - {package_name: policy_object}    │
-└─────────────────────────────────────┘
-```
-
-### 2.2 Batch Operation Class (PipBatch)
-
-```
-┌─────────────────────────────────────┐
-│  PipBatch (Context Manager)         │
-│  ┌───────────────────────────────┐  │
-│  │ _installed_cache              │  │
-│  │ - Caches pip freeze results   │  │
-│  │ - {package: version}          │  │
-│  └───────────────────────────────┘  │
-│                                     │
-│  Public Methods:                    │
-│  ├─ install()                       │
-│  ├─ ensure_not_installed()          │
-│  └─ ensure_installed()              │
-│                                     │
-│  Private Methods:                   │
-│  ├─ _get_installed_packages()       │
-│  ├─ _refresh_installed_cache()      │
-│  ├─ _invalidate_cache()             │
-│  ├─ _parse_package_spec()           │
-│  └─ _evaluate_condition()           │
-└─────────────────────────────────────┘
-```
-
-### 2.3 Policy Evaluation Flow
-
-```
-install("numpy>=1.20") called
-    │
-    ▼
-get_pip_policy() → Load policy (lazy)
-    │
-    ▼
-Parse package name: "numpy"
-    │
-    ▼
-Look up "numpy" policy in policy dictionary
-    │
-    ├─ Evaluate apply_first_match (exclusive)
-    │   ├─ skip → Return False (don't install)
-    │   ├─ force_version → Change version
-    │   └─ replace → Replace package
-    │
-    ├─ Evaluate apply_all_matches (cumulative)
-    │   ├─ pin_dependencies → Pin dependencies
-    │   ├─ install_with → Additional packages
-    │   └─ warn → Warning log
-    │
-    ▼
-Execute pip install
-    │
-    ▼
-Invalidate cache (_invalidate_cache)
-```
-
----
-
-## 3. Phase-by-Phase Implementation Plan
-
-### Phase 1: Core Infrastructure Setup (2-3 hours)
-
-#### Task 1.1: Project Structure and Dependency Setup (30 min)
-**Implementation**:
-- Create `pip_util.py` file
-- Add necessary import statements
-  ```python
-  import json
-  import logging
-  import platform
-  import re
-  import subprocess
-  from pathlib import Path
-  from typing import Dict, List, Optional, Tuple
-
-  from packaging.specifiers import SpecifierSet
-  from packaging.version import Version
-
-  from . import manager_util, context
-  ```
-- Set up logging
-  ```python
-  logger = logging.getLogger(__name__)
-  ```
-
-**Validation**:
-- Module loads without import errors
-- Logger works correctly
-
-#### Task 1.2: Global Variable and get_pip_policy() Implementation (1 hour)
-**Implementation**:
-- Declare global variable
-  ```python
-  _pip_policy_cache: Optional[Dict] = None
-  ```
-- Implement `get_pip_policy()` function
-  - Check cache and early return
-  - Read base policy file (`{manager_util.comfyui_manager_path}/pip-policy.json`)
-  - Read user policy file (`{context.manager_files_path}/pip-policy.user.json`)
-  - Create file if doesn't exist (for user policy)
-  - Merge policies (complete package-level replacement)
-  - Save to cache and return
-
-**Exception Handling**:
-- `FileNotFoundError`: File not found → Use empty dictionary
-- `json.JSONDecodeError`: JSON parse failure → Warning log + empty dictionary
-- General exception: Warning log + empty dictionary
-
-**Validation**:
-- Returns empty dictionary when policy files don't exist
-- Returns correct merged result when policy files exist
-- Confirms cache usage on second call (load log appears only once)
-
-#### Task 1.3: PipBatch Class Basic Structure (30 min)
-**Implementation**:
-- Class definition and `__init__`
-  ```python
-  class PipBatch:
-      def __init__(self):
-          self._installed_cache: Optional[Dict[str, str]] = None
-  ```
-- Context manager methods (`__enter__`, `__exit__`)
-  ```python
-  def __enter__(self):
-      return self
-
-  def __exit__(self, exc_type, exc_val, exc_tb):
-      self._installed_cache = None
-      return False
-  ```
-
-**Validation**:
-- `with PipBatch() as batch:` syntax works correctly
-- Cache cleared on `__exit__` call
-
----
-
-### Phase 2: Caching and Utility Methods (2-3 hours)
-
-#### Task 2.1: pip freeze Caching Methods (1 hour)
-**Implementation**:
-- Implement `_refresh_installed_cache()`
-  - Call `manager_util.make_pip_cmd(["freeze"])`
-  - Execute command via subprocess
-  - Parse output (package==version format)
-  - Exclude editable packages (-e) and comments (#)
-  - Convert to dictionary and store in `self._installed_cache`
-
-- Implement `_get_installed_packages()`
-  - Call `_refresh_installed_cache()` if cache is None
-  - Return cache
-
-- Implement `_invalidate_cache()`
-  - Set `self._installed_cache = None`
-
-**Exception Handling**:
-- `subprocess.CalledProcessError`: pip freeze failure → Empty dictionary
-- Parse error: Ignore line + warning log
-
-**Validation**:
-- pip freeze results correctly parsed into dictionary
-- New load occurs after cache invalidation and re-query
-
-#### Task 2.2: Package Spec Parsing (30 min)
-**Implementation**:
-- Implement `_parse_package_spec(package_info)`
-  - Regex pattern: `^([a-zA-Z0-9_-]+)([><=!~]+.*)?$`
-  - Split package name and version spec
-  - Return tuple: `(package_name, version_spec)`
-
-**Exception Handling**:
-- Parse failure: Raise `ValueError`
-
-**Validation**:
-- "numpy" → ("numpy", None)
-- "numpy==1.26.0" → ("numpy", "==1.26.0")
-- "pandas>=2.0.0" → ("pandas", ">=2.0.0")
-- Invalid format → ValueError
-
-#### Task 2.3: Condition Evaluation Method (1.5 hours)
-**Implementation**:
-- Implement `_evaluate_condition(condition, package_name, installed_packages)`
-
-**Handling by Condition Type**:
-1. **condition is None**: Always return True
-2. **"installed" type**:
-   - `target_package = condition.get("package", package_name)`
-   - Check version with `installed_packages.get(target_package)`
-   - If spec exists, compare using `packaging.specifiers.SpecifierSet`
-   - If no spec, only check installation status
-3. **"platform" type**:
-   - `os` condition: Compare with `platform.system()`
-   - `has_gpu` condition: Check `torch.cuda.is_available()` (False if torch unavailable)
-   - `comfyui_version` condition: TODO (currently warning)
-
-**Exception Handling**:
-- Version comparison failure: Warning log + return False
-- Unknown condition type: Warning log + return False
-
-**Validation**:
-- Write test cases for each condition type
-- Verify edge case handling (torch not installed, invalid version format, etc.)
-
----
-
-### Phase 3: Core Installation Logic Implementation (4-5 hours)
-
-#### Task 3.1: install() Method - Basic Flow (2 hours)
-**Implementation**:
-1. Parse package spec (`_parse_package_spec`)
-2. Query installed package cache (`_get_installed_packages`)
-3. If `override_policy=True`, install directly and return
-4. Call `get_pip_policy()` to load policy
-5. Default installation if no policy exists
-
-**Validation**:
-- Verify policy ignored when override_policy=True
-- Verify default installation for packages without policy
-
-#### Task 3.2: install() Method - apply_first_match Policy (1 hour)
-**Implementation**:
-- Iterate through policy list top-to-bottom
-- Evaluate each policy's condition (`_evaluate_condition`)
-- When condition satisfied:
-  - **skip**: Log reason and return False
-  - **force_version**: Force version change
-  - **replace**: Replace package
-- Apply only first match (break)
-
-**Validation**:
-- Verify installation blocked by skip policy
-- Verify version changed by force_version
-- Verify package replaced by replace
-
-#### Task 3.3: install() Method - apply_all_matches Policy (1 hour)
-**Implementation**:
-- Iterate through policy list top-to-bottom
-- Evaluate each policy's condition
-- Apply all condition-satisfying policies:
-  - **pin_dependencies**: Pin to installed version
-  - **install_with**: Add to additional package list
-  - **warn**: Output warning log
-
-**Validation**:
-- Verify multiple policies applied simultaneously
-- Verify version pinning by pin_dependencies
-- Verify additional package installation by install_with
-
-#### Task 3.4: install() Method - Installation Execution and Retry Logic (1 hour)
-**Implementation**:
-1. Compose final package list
-2. Generate command using `manager_util.make_pip_cmd()`
-3. Handle `extra_index_url`
-4. Execute installation via subprocess
-5. Handle failure based on on_failure setting:
-   - `retry_without_pin`: Retry without pins
-   - `fail`: Raise exception
-   - Other: Warning log
-6. Invalidate cache on success
-
-**Validation**:
-- Verify normal installation
-- Verify retry logic on pin failure
-- Verify error handling
-
----
-
-### Phase 4: Batch Operation Methods Implementation (2-3 hours)
-
-#### Task 4.1: ensure_not_installed() Implementation (1.5 hours)
-**Implementation**:
-1. Call `get_pip_policy()`
-2. Iterate through all package policies
-3. Check each package's uninstall policy
-4. When condition satisfied:
-   - Check if target package is installed
-   - If installed, execute `pip uninstall -y {target}`
-   - Remove from cache
-   - Add to removal list
-5. Execute only first match (per package)
-6. Return list of removed packages
-
-**Exception Handling**:
-- Individual package removal failure: Warning log + continue
-
-**Validation**:
-- Verify package removal by uninstall policy
-- Verify batch removal of multiple packages
-- Verify continued processing of other packages even on removal failure
-
-#### Task 4.2: ensure_installed() Implementation (1.5 hours)
-**Implementation**:
-1. Call `get_pip_policy()`
-2. Iterate through all package policies
-3. Check each package's restore policy
-4. When condition satisfied:
-   - Check target package's current version
-   - If absent or different version:
-     - Execute `pip install {target}=={version}`
-     - Add extra_index_url if present
-     - Update cache
-     - Add to restoration list
-5. Execute only first match (per package)
-6. Return list of restored packages
-
-**Exception Handling**:
-- Individual package installation failure: Warning log + continue
-
-**Validation**:
-- Verify package restoration by restore policy
-- Verify reinstallation on version mismatch
-- Verify continued processing of other packages even on restoration failure
-
----
-
-## 4. Testing Strategy
-
-### 4.1 Unit Tests
-
-#### Policy Loading Tests
-```python
-def test_get_pip_policy_empty():
-    """Returns empty dictionary when policy files don't exist"""
-
-def test_get_pip_policy_merge():
-    """Correctly merges base and user policies"""
-
-def test_get_pip_policy_cache():
-    """Uses cache on second call"""
-```
-
-#### Package Parsing Tests
-```python
-def test_parse_package_spec_simple():
-    """'numpy' → ('numpy', None)"""
-
-def test_parse_package_spec_version():
-    """'numpy==1.26.0' → ('numpy', '==1.26.0')"""
-
-def test_parse_package_spec_range():
-    """'pandas>=2.0.0' → ('pandas', '>=2.0.0')"""
-
-def test_parse_package_spec_invalid():
-    """Invalid format → ValueError"""
-```
-
-#### Condition Evaluation Tests
-```python
-def test_evaluate_condition_none():
-    """None condition → True"""
-
-def test_evaluate_condition_installed():
-    """Evaluates installed package condition"""
-
-def test_evaluate_condition_platform():
-    """Evaluates platform condition"""
-```
-
-### 4.2 Integration Tests
-
-#### Installation Policy Tests
-```python
-def test_install_with_skip_policy():
-    """Blocks installation with skip policy"""
-
-def test_install_with_force_version():
-    """Changes version with force_version policy"""
-
-def test_install_with_replace():
-    """Replaces package with replace policy"""
-
-def test_install_with_pin_dependencies():
-    """Pins versions with pin_dependencies"""
-```
-
-#### Batch Operation Tests
-```python
-def test_ensure_not_installed():
-    """Removes packages with uninstall policy"""
-
-def test_ensure_installed():
-    """Restores packages with restore policy"""
-
-def test_batch_workflow():
-    """Tests complete batch workflow"""
-```
-
-### 4.3 Edge Case Tests
-
-```python
-def test_install_without_policy():
-    """Default installation for packages without policy"""
-
-def test_install_override_policy():
-    """Ignores policy with override_policy=True"""
-
-def test_pip_freeze_failure():
-    """Handles empty cache on pip freeze failure"""
-
-def test_json_parse_error():
-    """Handles malformed JSON files"""
-
-def test_subprocess_failure():
-    """Exception handling when pip command fails"""
-```
-
----
-
-## 5. Error Handling Strategy
-
-### 5.1 Policy Loading Errors
-- **File not found**: Warning log + empty dictionary
-- **JSON parse failure**: Error log + empty dictionary
-- **No read permission**: Warning log + empty dictionary
-
-### 5.2 Package Installation Errors
-- **pip command failure**: Depends on on_failure setting
-  - `retry_without_pin`: Retry
-  - `fail`: Raise exception
-  - Other: Warning log
-- **Invalid package spec**: Raise ValueError
-
-### 5.3 Batch Operation Errors
-- **Individual package failure**: Warning log + continue to next package
-- **pip freeze failure**: Empty dictionary + warning log
-
----
-
-## 6. Performance Optimization
-
-### 6.1 Caching Strategy
-- **Policy cache**: Reused program-wide via global variable
-- **pip freeze cache**: Reused per batch, invalidated after install/remove
-- **lazy loading**: Load only when needed
-
-### 6.2 Parallel Processing Considerations
-- Current implementation is not thread-safe
-- Consider adding threading.Lock if needed
-- Batch operations execute sequentially only
-
----
-
-## 7. Documentation Requirements
-
-### 7.1 Code Documentation
-- Docstrings required for all public methods
-- Specify parameters, return values, and exceptions
-- Include usage examples
-
-### 7.2 User Guide
-- Explain `pip-policy.json` structure
-- Policy writing examples
-- Usage pattern examples
-
-### 7.3 Developer Guide
-- Architecture explanation
-- Extension methods
-- Test execution methods
-
----
-
-## 8. Deployment Checklist
-
-### 8.1 Code Quality
-- [ ] All unit tests pass
-- [ ] All integration tests pass
-- [ ] Code coverage ≥80%
-- [ ] No linting errors (flake8, pylint)
-- [ ] Type hints complete (mypy passes)
-
-### 8.2 Documentation
-- [ ] README.md written
-- [ ] API documentation generated
-- [ ] Example policy files written
-- [ ] Usage guide written
-
-### 8.3 Performance Verification
-- [ ] Policy loading performance measured (<100ms)
-- [ ] pip freeze caching effectiveness verified (≥50% speed improvement)
-- [ ] Memory usage confirmed (<10MB)
-
-### 8.4 Security Verification
-- [ ] Input validation complete
-- [ ] Path traversal prevention
-- [ ] Command injection prevention
-- [ ] JSON parsing safety confirmed
-
----
-
-## 9. Future Improvements
-
-### 9.1 Short-term (1-2 weeks)
-- Implement ComfyUI version check
-- Implement user confirmation prompt (allow_continue=false)
-- Thread-safe improvements (add Lock)
-
-### 9.2 Mid-term (1-2 months)
-- Add policy validation tools
-- Policy migration tools
-- More detailed logging and debugging options
-
-### 9.3 Long-term (3-6 months)
-- Web UI for policy management
-- Provide policy templates
-- Community policy sharing system
-
----
-
-## 10. Risks and Mitigation Strategies
-
-### Risk 1: Policy Conflicts
-**Description**: Policies for different packages may conflict
-**Mitigation**: Develop policy validation tools, conflict detection algorithm
-
-### Risk 2: pip Version Compatibility
-**Description**: Must work across various pip versions
-**Mitigation**: Test on multiple pip versions, version-specific branching
-
-### Risk 3: Performance Degradation
-**Description**: Installation speed may decrease due to policy evaluation
-**Mitigation**: Optimize caching, minimize condition evaluation
-
-### Risk 4: Policy Misconfiguration
-**Description**: Users may write incorrect policies
-**Mitigation**: JSON schema validation, provide examples and guides
-
----
-
-## 11. Timeline
-
-### Week 1
-- Phase 1: Core Infrastructure Setup (Day 1-2)
-- Phase 2: Caching and Utility Methods (Day 3-4)
-- Write unit tests (Day 5)
-
-### Week 2
-- Phase 3: Core Installation Logic Implementation (Day 1-3)
-- Phase 4: Batch Operation Methods Implementation (Day 4-5)
-
-### Week 3
-- Integration and edge case testing (Day 1-2)
-- Documentation (Day 3)
-- Code review and refactoring (Day 4-5)
-
-### Week 4
-- Performance optimization (Day 1-2)
-- Security verification (Day 3)
-- Final testing and deployment preparation (Day 4-5)
-
----
-
-## 12. Success Criteria
-
-### Feature Completeness
-- ✅ All policy types (uninstall, apply_first_match, apply_all_matches, restore) work correctly
-- ✅ Policy merge logic works correctly
-- ✅ Batch operations perform normally
-
-### Quality Metrics
-- ✅ Test coverage ≥80%
-- ✅ All tests pass
-- ✅ 0 linting errors
-- ✅ 100% type hint completion
-
-### Performance Metrics
-- ✅ Policy loading <100ms
-- ✅ ≥50% performance improvement with pip freeze caching
-- ✅ Memory usage <10MB
-
-### Usability
-- ✅ Clear error messages
-- ✅ Sufficient documentation
-- ✅ Verified in real-world use cases

comfyui_manager/common/pip_util.py

@@ -1,629 +0,0 @@
-"""
-pip_util - Policy-based pip package management system
-
-This module provides a policy-based approach to pip package installation
-to minimize dependency conflicts and protect existing installed packages.
-
-Usage:
-    # Batch operations (policy auto-loaded)
-    with PipBatch() as batch:
-        batch.ensure_not_installed()
-        batch.install("numpy>=1.20")
-        batch.install("pandas>=2.0")
-        batch.install("scipy>=1.7")
-        batch.ensure_installed()
-"""
-
-import json
-import logging
-import platform
-import re
-import subprocess
-from pathlib import Path
-from typing import Dict, List, Optional, Tuple
-
-from packaging.requirements import Requirement
-from packaging.specifiers import SpecifierSet
-from packaging.version import Version
-
-from . import manager_util, context
-
-logger = logging.getLogger(__name__)
-
-# Global policy cache (lazy loaded on first access)
-_pip_policy_cache: Optional[Dict] = None
-
-
-def get_pip_policy() -> Dict:
-    """
-    Get pip policy with lazy loading.
-
-    Returns the cached policy if available, otherwise loads it from files.
-    This function automatically loads the policy on first access.
-
-    Thread safety: This function is NOT thread-safe.
-    Ensure single-threaded access during initialization.
-
-    Returns:
-        Dictionary of merged pip policies
-
-    Example:
-        >>> policy = get_pip_policy()
-        >>> numpy_policy = policy.get("numpy", {})
-    """
-    global _pip_policy_cache
-
-    # Return cached policy if already loaded
-    if _pip_policy_cache is not None:
-        logger.debug("Returning cached pip policy")
-        return _pip_policy_cache
-
-    logger.info("Loading pip policies...")
-
-    # Load base policy
-    base_policy = {}
-    base_policy_path = Path(manager_util.comfyui_manager_path) / "pip-policy.json"
-
-    try:
-        if base_policy_path.exists():
-            with open(base_policy_path, 'r', encoding='utf-8') as f:
-                base_policy = json.load(f)
-            logger.debug(f"Loaded base policy from {base_policy_path}")
-        else:
-            logger.warning(f"Base policy file not found: {base_policy_path}")
-    except json.JSONDecodeError as e:
-        logger.error(f"Failed to parse base policy JSON: {e}")
-        base_policy = {}
-    except Exception as e:
-        logger.warning(f"Failed to read base policy file: {e}")
-        base_policy = {}
-
-    # Load user policy
-    user_policy = {}
-    user_policy_path = Path(context.manager_files_path) / "pip-policy.user.json"
-
-    try:
-        if user_policy_path.exists():
-            with open(user_policy_path, 'r', encoding='utf-8') as f:
-                user_policy = json.load(f)
-            logger.debug(f"Loaded user policy from {user_policy_path}")
-        else:
-            # Create empty user policy file
-            user_policy_path.parent.mkdir(parents=True, exist_ok=True)
-            with open(user_policy_path, 'w', encoding='utf-8') as f:
-                json.dump({"_comment": "User-specific pip policy overrides"}, f, indent=2)
-            logger.info(f"Created empty user policy file: {user_policy_path}")
-    except json.JSONDecodeError as e:
-        logger.warning(f"Failed to parse user policy JSON: {e}")
-        user_policy = {}
-    except Exception as e:
-        logger.warning(f"Failed to read user policy file: {e}")
-        user_policy = {}
-
-    # Merge policies (package-level override: user completely replaces base per package)
-    merged_policy = base_policy.copy()
-    for package_name, package_policy in user_policy.items():
-        if package_name.startswith("_"):  # Skip metadata fields like _comment
-            continue
-        merged_policy[package_name] = package_policy  # Complete package replacement
-
-    # Store in global cache
-    _pip_policy_cache = merged_policy
-    logger.info(f"Policy loaded successfully: {len(_pip_policy_cache)} package policies")
-
-    return _pip_policy_cache
-
-
-class PipBatch:
-    """
-    Pip package installation batch manager.
-
-    Maintains pip freeze cache during a batch of operations for performance optimization.
-
-    Usage pattern:
-        # Batch operations (policy auto-loaded)
-        with PipBatch() as batch:
-            batch.ensure_not_installed()
-            batch.install("numpy>=1.20")
-            batch.install("pandas>=2.0")
-            batch.install("scipy>=1.7")
-            batch.ensure_installed()
-
-    Attributes:
-        _installed_cache: Cache of installed packages from pip freeze
-    """
-
-    def __init__(self):
-        """Initialize PipBatch with empty cache."""
-        self._installed_cache: Optional[Dict[str, str]] = None
-
-    def __enter__(self):
-        """Enter context manager."""
-        return self
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        """Exit context manager and clear cache."""
-        self._installed_cache = None
-        return False
-
-    def _refresh_installed_cache(self) -> None:
-        """
-        Refresh the installed packages cache by executing pip freeze.
-
-        Parses pip freeze output into a dictionary of {package_name: version}.
-        Ignores editable packages and comments.
-
-        Raises:
-            No exceptions raised - failures result in empty cache with warning log
-        """
-        try:
-            cmd = manager_util.make_pip_cmd(["freeze"])
-            result = subprocess.run(cmd, capture_output=True, text=True, check=True)
-
-            packages = {}
-            for line in result.stdout.strip().split('\n'):
-                line = line.strip()
-
-                # Skip empty lines
-                if not line:
-                    continue
-
-                # Skip editable packages (-e /path/to/package or -e git+https://...)
-                # Editable packages don't have version info and are typically development-only
-                if line.startswith('-e '):
-                    continue
-
-                # Skip comments (defensive: pip freeze typically doesn't output comments,
-                # but this handles manually edited requirements.txt or future pip changes)
-                if line.startswith('#'):
-                    continue
-
-                # Parse package==version
-                if '==' in line:
-                    try:
-                        package_name, version = line.split('==', 1)
-                        packages[package_name.strip()] = version.strip()
-                    except ValueError:
-                        logger.warning(f"Failed to parse pip freeze line: {line}")
-                        continue
-
-            self._installed_cache = packages
-            logger.debug(f"Refreshed installed packages cache: {len(packages)} packages")
-
-        except subprocess.CalledProcessError as e:
-            logger.warning(f"pip freeze failed: {e}")
-            self._installed_cache = {}
-        except Exception as e:
-            logger.warning(f"Failed to refresh installed packages cache: {e}")
-            self._installed_cache = {}
-
-    def _get_installed_packages(self) -> Dict[str, str]:
-        """
-        Get cached installed packages, refresh if cache is None.
-
-        Returns:
-            Dictionary of {package_name: version}
-        """
-        if self._installed_cache is None:
-            self._refresh_installed_cache()
-        return self._installed_cache
-
-    def _invalidate_cache(self) -> None:
-        """
-        Invalidate the installed packages cache.
-
-        Should be called after install/uninstall operations.
-        """
-        self._installed_cache = None
-
-    def _parse_package_spec(self, package_info: str) -> Tuple[str, Optional[str]]:
-        """
-        Parse package spec string into package name and version spec using PEP 508.
-
-        Uses the packaging library to properly parse package specifications according to
-        PEP 508 standard, which handles complex cases like extras and multiple version
-        constraints that simple regex cannot handle correctly.
-
-        Args:
-            package_info: Package specification like "numpy", "numpy==1.26.0", "numpy>=1.20.0",
-                         or complex specs like "package[extra]>=1.0,<2.0"
-
-        Returns:
-            Tuple of (package_name, version_spec)
-            Examples: ("numpy", "==1.26.0"), ("pandas", ">=2.0.0"), ("scipy", None)
-            Package names are normalized (e.g., "NumPy" -> "numpy")
-
-        Raises:
-            ValueError: If package_info cannot be parsed according to PEP 508
-
-        Example:
-            >>> batch._parse_package_spec("numpy>=1.20")
-            ("numpy", ">=1.20")
-            >>> batch._parse_package_spec("requests[security]>=2.0,<3.0")
-            ("requests", ">=2.0,<3.0")
-        """
-        try:
-            req = Requirement(package_info)
-            package_name = req.name  # Normalized package name
-            version_spec = str(req.specifier) if req.specifier else None
-            return package_name, version_spec
-        except Exception as e:
-            raise ValueError(f"Invalid package spec: {package_info}") from e
-
-    def _evaluate_condition(self, condition: Optional[Dict], package_name: str,
-                           installed_packages: Dict[str, str]) -> bool:
-        """
-        Evaluate policy condition and return whether it's satisfied.
-
-        Args:
-            condition: Policy condition object (dict) or None
-            package_name: Current package being processed
-            installed_packages: Dictionary of {package_name: version}
-
-        Returns:
-            True if condition is satisfied, False otherwise
-            None condition always returns True
-
-        Example:
-            >>> condition = {"type": "installed", "package": "numpy", "spec": ">=1.20"}
-            >>> batch._evaluate_condition(condition, "numba", {"numpy": "1.26.0"})
-            True
-        """
-        # No condition means always satisfied
-        if condition is None:
-            return True
-
-        condition_type = condition.get("type")
-
-        if condition_type == "installed":
-            # Check if a package is installed with optional version spec
-            target_package = condition.get("package", package_name)
-            installed_version = installed_packages.get(target_package)
-
-            # Package not installed
-            if installed_version is None:
-                return False
-
-            # Check version spec if provided
-            spec = condition.get("spec")
-            if spec:
-                try:
-                    specifier = SpecifierSet(spec)
-                    return Version(installed_version) in specifier
-                except Exception as e:
-                    logger.warning(f"Failed to compare version {installed_version} with spec {spec}: {e}")
-                    return False
-
-            # Package is installed (no spec check)
-            return True
-
-        elif condition_type == "platform":
-            # Check platform conditions (os, has_gpu, comfyui_version)
-            conditions_met = True
-
-            # Check OS
-            if "os" in condition:
-                expected_os = condition["os"].lower()
-                actual_os = platform.system().lower()
-                if expected_os not in actual_os and actual_os not in expected_os:
-                    conditions_met = False
-
-            # Check GPU availability
-            if "has_gpu" in condition:
-                expected_gpu = condition["has_gpu"]
-                try:
-                    import torch
-                    has_gpu = torch.cuda.is_available()
-                except ImportError:
-                    has_gpu = False
-
-                if expected_gpu != has_gpu:
-                    conditions_met = False
-
-            # Check ComfyUI version
-            if "comfyui_version" in condition:
-                # TODO: Implement ComfyUI version check
-                logger.warning("ComfyUI version condition not yet implemented")
-
-            return conditions_met
-
-        else:
-            logger.warning(f"Unknown condition type: {condition_type}")
-            return False
-
-    def install(self, package_info: str, extra_index_url: Optional[str] = None,
-                override_policy: bool = False) -> bool:
-        """
-        Install a pip package with policy-based modifications.
-
-        Args:
-            package_info: Package specification (e.g., "numpy", "numpy==1.26.0", "numpy>=1.20.0")
-            extra_index_url: Additional package repository URL (optional)
-            override_policy: If True, skip policy application and install directly (default: False)
-
-        Returns:
-            True if installation succeeded, False if skipped by policy
-
-        Raises:
-            ValueError: If package_info cannot be parsed
-            subprocess.CalledProcessError: If installation fails (depending on policy on_failure settings)
-
-        Example:
-            >>> with PipBatch() as batch:
-            ...     batch.install("numpy>=1.20")
-            ...     batch.install("torch", override_policy=True)
-        """
-        # Parse package spec
-        try:
-            package_name, version_spec = self._parse_package_spec(package_info)
-        except ValueError as e:
-            logger.error(f"Invalid package spec: {e}")
-            raise
-
-        # Get installed packages cache
-        installed_packages = self._get_installed_packages()
-
-        # Override policy - skip to direct installation
-        if override_policy:
-            logger.info(f"Installing {package_info} (policy override)")
-            cmd = manager_util.make_pip_cmd(["install", package_info])
-            if extra_index_url:
-                cmd.extend(["--extra-index-url", extra_index_url])
-
-            try:
-                subprocess.run(cmd, check=True)
-                self._invalidate_cache()
-                logger.info(f"Successfully installed {package_info}")
-                return True
-            except subprocess.CalledProcessError as e:
-                logger.error(f"Failed to install {package_info}: {e}")
-                raise
-
-        # Get policy (lazy loading)
-        pip_policy = get_pip_policy()
-        policy = pip_policy.get(package_name, {})
-
-        # If no policy, proceed with default installation
-        if not policy:
-            logger.debug(f"No policy found for {package_name}, proceeding with default installation")
-            cmd = manager_util.make_pip_cmd(["install", package_info])
-            if extra_index_url:
-                cmd.extend(["--extra-index-url", extra_index_url])
-
-            try:
-                subprocess.run(cmd, check=True)
-                self._invalidate_cache()
-                logger.info(f"Successfully installed {package_info}")
-                return True
-            except subprocess.CalledProcessError as e:
-                logger.error(f"Failed to install {package_info}: {e}")
-                raise
-
-        # Apply apply_first_match policies (exclusive - first match only)
-        final_package_info = package_info
-        final_extra_index_url = extra_index_url
-        policy_reason = None
-
-        apply_first_match = policy.get("apply_first_match", [])
-        for policy_item in apply_first_match:
-            condition = policy_item.get("condition")
-            if self._evaluate_condition(condition, package_name, installed_packages):
-                policy_type = policy_item.get("type")
-
-                if policy_type == "skip":
-                    reason = policy_item.get("reason", "No reason provided")
-                    logger.info(f"Skipping installation of {package_name}: {reason}")
-                    return False
-
-                elif policy_type == "force_version":
-                    forced_version = policy_item.get("version")
-                    final_package_info = f"{package_name}=={forced_version}"
-                    policy_reason = policy_item.get("reason")
-                    if "extra_index_url" in policy_item:
-                        final_extra_index_url = policy_item["extra_index_url"]
-                    logger.info(f"Force version for {package_name}: {forced_version} ({policy_reason})")
-                    break  # First match only
-
-                elif policy_type == "replace":
-                    replacement = policy_item.get("replacement")
-                    replacement_version = policy_item.get("version", "")
-                    if replacement_version:
-                        final_package_info = f"{replacement}{replacement_version}"
-                    else:
-                        final_package_info = replacement
-                    policy_reason = policy_item.get("reason")
-                    if "extra_index_url" in policy_item:
-                        final_extra_index_url = policy_item["extra_index_url"]
-                    logger.info(f"Replacing {package_name} with {final_package_info}: {policy_reason}")
-                    break  # First match only
-
-        # Apply apply_all_matches policies (cumulative - all matches)
-        additional_packages = []
-        pinned_packages = []
-        pin_on_failure = "fail"
-
-        apply_all_matches = policy.get("apply_all_matches", [])
-        for policy_item in apply_all_matches:
-            condition = policy_item.get("condition")
-            if self._evaluate_condition(condition, package_name, installed_packages):
-                policy_type = policy_item.get("type")
-
-                if policy_type == "pin_dependencies":
-                    pin_list = policy_item.get("pinned_packages", [])
-                    for pkg in pin_list:
-                        installed_version = installed_packages.get(pkg)
-                        if installed_version:
-                            pinned_packages.append(f"{pkg}=={installed_version}")
-                        else:
-                            logger.warning(f"Cannot pin {pkg}: not currently installed")
-                    pin_on_failure = policy_item.get("on_failure", "fail")
-                    reason = policy_item.get("reason", "")
-                    logger.info(f"Pinning dependencies: {pinned_packages} ({reason})")
-
-                elif policy_type == "install_with":
-                    additional = policy_item.get("additional_packages", [])
-                    additional_packages.extend(additional)
-                    reason = policy_item.get("reason", "")
-                    logger.info(f"Installing additional packages: {additional} ({reason})")
-
-                elif policy_type == "warn":
-                    message = policy_item.get("message", "")
-                    allow_continue = policy_item.get("allow_continue", True)
-                    logger.warning(f"Policy warning for {package_name}: {message}")
-                    if not allow_continue:
-                        # TODO: Implement user confirmation
-                        logger.info("User confirmation required (not implemented, continuing)")
-
-        # Build final package list
-        packages_to_install = [final_package_info] + pinned_packages + additional_packages
-
-        # Execute installation
-        cmd = manager_util.make_pip_cmd(["install"] + packages_to_install)
-        if final_extra_index_url:
-            cmd.extend(["--extra-index-url", final_extra_index_url])
-
-        try:
-            subprocess.run(cmd, check=True)
-            self._invalidate_cache()
-            if policy_reason:
-                logger.info(f"Successfully installed {final_package_info}: {policy_reason}")
-            else:
-                logger.info(f"Successfully installed {final_package_info}")
-            return True
-
-        except subprocess.CalledProcessError as e:
-            # Handle installation failure
-            if pinned_packages and pin_on_failure == "retry_without_pin":
-                logger.warning(f"Installation failed with pinned dependencies, retrying without pins")
-                retry_cmd = manager_util.make_pip_cmd(["install", final_package_info])
-                if final_extra_index_url:
-                    retry_cmd.extend(["--extra-index-url", final_extra_index_url])
-
-                try:
-                    subprocess.run(retry_cmd, check=True)
-                    self._invalidate_cache()
-                    logger.info(f"Successfully installed {final_package_info} (without pins)")
-                    return True
-                except subprocess.CalledProcessError as retry_error:
-                    logger.error(f"Retry installation also failed: {retry_error}")
-                    raise
-
-            elif pin_on_failure == "fail":
-                logger.error(f"Installation failed: {e}")
-                raise
-
-            else:
-                logger.warning(f"Installation failed, but continuing: {e}")
-                return False
-
-    def ensure_not_installed(self) -> List[str]:
-        """
-        Remove all packages matching uninstall policies (batch processing).
-
-        Iterates through all package policies and executes uninstall actions
-        where conditions are satisfied.
-
-        Returns:
-            List of removed package names
-
-        Example:
-            >>> with PipBatch() as batch:
-            ...     removed = batch.ensure_not_installed()
-            ...     print(f"Removed: {removed}")
-        """
-        # Get policy (lazy loading)
-        pip_policy = get_pip_policy()
-
-        installed_packages = self._get_installed_packages()
-        removed_packages = []
-
-        for package_name, policy in pip_policy.items():
-            uninstall_policies = policy.get("uninstall", [])
-
-            for uninstall_policy in uninstall_policies:
-                condition = uninstall_policy.get("condition")
-
-                if self._evaluate_condition(condition, package_name, installed_packages):
-                    target = uninstall_policy.get("target")
-                    reason = uninstall_policy.get("reason", "No reason provided")
-
-                    # Check if target is installed
-                    if target in installed_packages:
-                        try:
-                            cmd = manager_util.make_pip_cmd(["uninstall", "-y", target])
-                            subprocess.run(cmd, check=True)
-
-                            logger.info(f"Uninstalled {target}: {reason}")
-                            removed_packages.append(target)
-
-                            # Remove from cache
-                            del installed_packages[target]
-
-                        except subprocess.CalledProcessError as e:
-                            logger.warning(f"Failed to uninstall {target}: {e}")
-
-                    # First match only per package
-                    break
-
-        return removed_packages
-
-    def ensure_installed(self) -> List[str]:
-        """
-        Restore all packages matching restore policies (batch processing).
-
-        Iterates through all package policies and executes restore actions
-        where conditions are satisfied.
-
-        Returns:
-            List of restored package names
-
-        Example:
-            >>> with PipBatch() as batch:
-            ...     batch.install("numpy>=1.20")
-            ...     restored = batch.ensure_installed()
-            ...     print(f"Restored: {restored}")
-        """
-        # Get policy (lazy loading)
-        pip_policy = get_pip_policy()
-
-        installed_packages = self._get_installed_packages()
-        restored_packages = []
-
-        for package_name, policy in pip_policy.items():
-            restore_policies = policy.get("restore", [])
-
-            for restore_policy in restore_policies:
-                condition = restore_policy.get("condition")
-
-                if self._evaluate_condition(condition, package_name, installed_packages):
-                    target = restore_policy.get("target")
-                    version = restore_policy.get("version")
-                    reason = restore_policy.get("reason", "No reason provided")
-                    extra_index_url = restore_policy.get("extra_index_url")
-
-                    # Check if target needs restoration
-                    current_version = installed_packages.get(target)
-
-                    if current_version is None or current_version != version:
-                        try:
-                            package_spec = f"{target}=={version}"
-                            cmd = manager_util.make_pip_cmd(["install", package_spec])
-
-                            if extra_index_url:
-                                cmd.extend(["--extra-index-url", extra_index_url])
-
-                            subprocess.run(cmd, check=True)
-
-                            logger.info(f"Restored {package_spec}: {reason}")
-                            restored_packages.append(target)
-
-                            # Update cache
-                            installed_packages[target] = version
-
-                        except subprocess.CalledProcessError as e:
-                            logger.warning(f"Failed to restore {target}: {e}")
-
-                    # First match only per package
-                    break
-
-        return restored_packages

comfyui_manager/data_models/README.md

@@ -1,68 +0,0 @@
-# Data Models
-
-This directory contains Pydantic models for ComfyUI Manager, providing type safety, validation, and serialization for the API and internal data structures.
-
-## Overview
-
-- `generated_models.py` - All models auto-generated from OpenAPI spec
-- `__init__.py` - Package exports for all models
-
-**Note**: All models are now auto-generated from the OpenAPI specification. Manual model files (`task_queue.py`, `state_management.py`) have been deprecated in favor of a single source of truth.
-
-## Generating Types from OpenAPI
-
-The state management models are automatically generated from the OpenAPI specification using `datamodel-codegen`. This ensures type safety and consistency between the API specification and the Python code.
-
-### Prerequisites
-
-Install the code generator:
-```bash
-pipx install datamodel-code-generator
-```
-
-### Generation Command
-
-To regenerate all models after updating the OpenAPI spec:
-
-```bash
-datamodel-codegen \
-  --use-subclass-enum \
-  --field-constraints \
-  --strict-types bytes \
-  --use-double-quotes \
-  --input openapi.yaml \
-  --output comfyui_manager/data_models/generated_models.py \
-  --output-model-type pydantic_v2.BaseModel
-```
-
-### When to Regenerate
-
-You should regenerate the models when:
-
-1. **Adding new API endpoints** that return new data structures
-2. **Modifying existing schemas** in the OpenAPI specification  
-3. **Adding new state management features** that require new models
-
-### Important Notes
-
-- **Single source of truth**: All models are now generated from `openapi.yaml`
-- **No manual models**: All previously manual models have been migrated to the OpenAPI spec
-- **OpenAPI requirements**: New schemas must be referenced in API paths to be generated by datamodel-codegen
-- **Validation**: Always validate the OpenAPI spec before generation:
-  ```bash
-  python3 -c "import yaml; yaml.safe_load(open('openapi.yaml'))"
-  ```
-
-### Example: Adding New State Models
-
-1. Add your schema to `openapi.yaml` under `components/schemas/`
-2. Reference the schema in an API endpoint response
-3. Run the generation command above
-4. Update `__init__.py` to export the new models
-5. Import and use the models in your code
-
-### Troubleshooting
-
-- **Models not generated**: Ensure schemas are under `components/schemas/` (not `parameters/`)
-- **Missing models**: Verify schemas are referenced in at least one API path
-- **Import errors**: Check that new models are added to `__init__.py` exports

comfyui_manager/data_models/__init__.py

@@ -1,137 +0,0 @@
-"""
-Data models for ComfyUI Manager.
-
-This package contains Pydantic models used throughout the ComfyUI Manager
-for data validation, serialization, and type safety.
-
-All models are auto-generated from the OpenAPI specification to ensure
-consistency between the API and implementation.
-"""
-
-from .generated_models import (
-    # Core Task Queue Models
-    QueueTaskItem,
-    TaskHistoryItem,
-    TaskStateMessage,
-    TaskExecutionStatus,
-    
-    # WebSocket Message Models
-    MessageTaskDone,
-    MessageTaskStarted,
-    MessageTaskFailed,
-    MessageUpdate,
-    ManagerMessageName,
-    
-    # State Management Models
-    BatchExecutionRecord,
-    ComfyUISystemState,
-    BatchOperation,
-    InstalledNodeInfo,
-    InstalledModelInfo,
-    ComfyUIVersionInfo,
-    
-    # Import Fail Info Models
-    ImportFailInfoBulkRequest,
-    ImportFailInfoBulkResponse,
-    ImportFailInfoItem,
-    ImportFailInfoItem1,
-    
-    # Other models
-    OperationType,
-    OperationResult,
-    ManagerPackInfo,
-    ManagerPackInstalled,
-    SelectedVersion,
-    ManagerChannel,
-    ManagerDatabaseSource,
-    ManagerPackState,
-    ManagerPackInstallType,
-    ManagerPack,
-    InstallPackParams,
-    UpdatePackParams,
-    UpdateAllPacksParams,
-    UpdateComfyUIParams,
-    FixPackParams,
-    UninstallPackParams,
-    DisablePackParams,
-    EnablePackParams,
-    UpdateAllQueryParams,
-    UpdateComfyUIQueryParams,
-    ComfyUISwitchVersionQueryParams,
-    QueueStatus,
-    ManagerMappings,
-    ModelMetadata,
-    NodePackageMetadata,
-    SnapshotItem,
-    Error,
-    InstalledPacksResponse,
-    HistoryResponse,
-    HistoryListResponse,
-    InstallType,
-    SecurityLevel,
-    RiskLevel,
-)
-
-__all__ = [
-    # Core Task Queue Models
-    "QueueTaskItem",
-    "TaskHistoryItem",
-    "TaskStateMessage",
-    "TaskExecutionStatus",
-    
-    # WebSocket Message Models
-    "MessageTaskDone",
-    "MessageTaskStarted",
-    "MessageTaskFailed",
-    "MessageUpdate",
-    "ManagerMessageName",
-    
-    # State Management Models
-    "BatchExecutionRecord",
-    "ComfyUISystemState",
-    "BatchOperation",
-    "InstalledNodeInfo",
-    "InstalledModelInfo",
-    "ComfyUIVersionInfo",
-    
-    # Import Fail Info Models
-    "ImportFailInfoBulkRequest",
-    "ImportFailInfoBulkResponse",
-    "ImportFailInfoItem",
-    "ImportFailInfoItem1",
-    
-    # Other models
-    "OperationType",
-    "OperationResult",
-    "ManagerPackInfo",
-    "ManagerPackInstalled",
-    "SelectedVersion",
-    "ManagerChannel",
-    "ManagerDatabaseSource",
-    "ManagerPackState",
-    "ManagerPackInstallType",
-    "ManagerPack",
-    "InstallPackParams",
-    "UpdatePackParams",
-    "UpdateAllPacksParams",
-    "UpdateComfyUIParams",
-    "FixPackParams",
-    "UninstallPackParams",
-    "DisablePackParams",
-    "EnablePackParams",
-    "UpdateAllQueryParams",
-    "UpdateComfyUIQueryParams",
-    "ComfyUISwitchVersionQueryParams",
-    "QueueStatus",
-    "ManagerMappings",
-    "ModelMetadata",
-    "NodePackageMetadata",
-    "SnapshotItem",
-    "Error",
-    "InstalledPacksResponse",
-    "HistoryResponse",
-    "HistoryListResponse",
-    "InstallType",
-    "SecurityLevel",
-    "RiskLevel",
-]

comfyui_manager/data_models/generated_models.py

@@ -1,561 +0,0 @@
-# generated by datamodel-codegen:
-#   filename:  openapi.yaml
-#   timestamp: 2025-07-31T04:52:26+00:00
-
-from __future__ import annotations
-
-from datetime import datetime
-from enum import Enum
-from typing import Any, Dict, List, Optional, Union
-
-from pydantic import BaseModel, Field, RootModel
-
-
-class OperationType(str, Enum):
-    install = "install"
-    uninstall = "uninstall"
-    update = "update"
-    update_comfyui = "update-comfyui"
-    fix = "fix"
-    disable = "disable"
-    enable = "enable"
-    install_model = "install-model"
-
-
-class OperationResult(str, Enum):
-    success = "success"
-    failed = "failed"
-    skipped = "skipped"
-    error = "error"
-    skip = "skip"
-
-
-class TaskExecutionStatus(BaseModel):
-    status_str: OperationResult
-    completed: bool = Field(..., description="Whether the task completed")
-    messages: List[str] = Field(..., description="Additional status messages")
-
-
-class ManagerMessageName(str, Enum):
-    cm_task_completed = "cm-task-completed"
-    cm_task_started = "cm-task-started"
-    cm_queue_status = "cm-queue-status"
-
-
-class ManagerPackInfo(BaseModel):
-    id: str = Field(
-        ...,
-        description="Either github-author/github-repo or name of pack from the registry",
-    )
-    version: str = Field(..., description="Semantic version or Git commit hash")
-    ui_id: Optional[str] = Field(None, description="Task ID - generated internally")
-
-
-class ManagerPackInstalled(BaseModel):
-    ver: str = Field(
-        ...,
-        description="The version of the pack that is installed (Git commit hash or semantic version)",
-    )
-    cnr_id: Optional[str] = Field(
-        None, description="The name of the pack if installed from the registry"
-    )
-    aux_id: Optional[str] = Field(
-        None,
-        description="The name of the pack if installed from github (author/repo-name format)",
-    )
-    enabled: bool = Field(..., description="Whether the pack is enabled")
-
-
-class SelectedVersion(str, Enum):
-    latest = "latest"
-    nightly = "nightly"
-
-
-class ManagerChannel(str, Enum):
-    default = "default"
-    recent = "recent"
-    legacy = "legacy"
-    forked = "forked"
-    dev = "dev"
-    tutorial = "tutorial"
-
-
-class ManagerDatabaseSource(str, Enum):
-    remote = "remote"
-    local = "local"
-    cache = "cache"
-
-
-class ManagerPackState(str, Enum):
-    installed = "installed"
-    disabled = "disabled"
-    not_installed = "not_installed"
-    import_failed = "import_failed"
-    needs_update = "needs_update"
-
-
-class ManagerPackInstallType(str, Enum):
-    git_clone = "git-clone"
-    copy = "copy"
-    cnr = "cnr"
-
-
-class SecurityLevel(str, Enum):
-    strong = "strong"
-    normal = "normal"
-    normal_ = "normal-"
-    weak = "weak"
-
-
-class RiskLevel(str, Enum):
-    block = "block"
-    high_ = "high+"
-    high = "high"
-    middle_ = "middle+"
-    middle = "middle"
-
-
-class UpdateState(Enum):
-    false = "false"
-    true = "true"
-
-
-class ManagerPack(ManagerPackInfo):
-    author: Optional[str] = Field(
-        None, description="Pack author name or 'Unclaimed' if added via GitHub crawl"
-    )
-    files: Optional[List[str]] = Field(
-        None,
-        description="Repository URLs for installation (typically contains one GitHub URL)",
-    )
-    reference: Optional[str] = Field(
-        None, description="The type of installation reference"
-    )
-    title: Optional[str] = Field(None, description="The display name of the pack")
-    cnr_latest: Optional[SelectedVersion] = None
-    repository: Optional[str] = Field(None, description="GitHub repository URL")
-    state: Optional[ManagerPackState] = None
-    update_state: Optional[UpdateState] = Field(
-        None, alias="update-state", description="Update availability status"
-    )
-    stars: Optional[int] = Field(None, description="GitHub stars count")
-    last_update: Optional[datetime] = Field(None, description="Last update timestamp")
-    health: Optional[str] = Field(None, description="Health status of the pack")
-    description: Optional[str] = Field(None, description="Pack description")
-    trust: Optional[bool] = Field(None, description="Whether the pack is trusted")
-    install_type: Optional[ManagerPackInstallType] = None
-
-
-class InstallPackParams(ManagerPackInfo):
-    selected_version: Union[str, SelectedVersion] = Field(
-        ..., description="Semantic version, Git commit hash, latest, or nightly"
-    )
-    repository: Optional[str] = Field(
-        None,
-        description="GitHub repository URL (required if selected_version is nightly)",
-    )
-    pip: Optional[List[str]] = Field(None, description="PyPi dependency names")
-    mode: ManagerDatabaseSource
-    channel: ManagerChannel
-    skip_post_install: Optional[bool] = Field(
-        None, description="Whether to skip post-installation steps"
-    )
-
-
-class UpdateAllPacksParams(BaseModel):
-    mode: Optional[ManagerDatabaseSource] = None
-    ui_id: Optional[str] = Field(None, description="Task ID - generated internally")
-
-
-class UpdatePackParams(BaseModel):
-    node_name: str = Field(..., description="Name of the node package to update")
-    node_ver: Optional[str] = Field(
-        None, description="Current version of the node package"
-    )
-
-
-class UpdateComfyUIParams(BaseModel):
-    is_stable: Optional[bool] = Field(
-        True,
-        description="Whether to update to stable version (true) or nightly (false)",
-    )
-    target_version: Optional[str] = Field(
-        None,
-        description="Specific version to switch to (for version switching operations)",
-    )
-
-
-class FixPackParams(BaseModel):
-    node_name: str = Field(..., description="Name of the node package to fix")
-    node_ver: str = Field(..., description="Version of the node package")
-
-
-class UninstallPackParams(BaseModel):
-    node_name: str = Field(..., description="Name of the node package to uninstall")
-    is_unknown: Optional[bool] = Field(
-        False, description="Whether this is an unknown/unregistered package"
-    )
-
-
-class DisablePackParams(BaseModel):
-    node_name: str = Field(..., description="Name of the node package to disable")
-    is_unknown: Optional[bool] = Field(
-        False, description="Whether this is an unknown/unregistered package"
-    )
-
-
-class EnablePackParams(BaseModel):
-    cnr_id: str = Field(
-        ..., description="ComfyUI Node Registry ID of the package to enable"
-    )
-
-
-class UpdateAllQueryParams(BaseModel):
-    client_id: str = Field(
-        ..., description="Client identifier that initiated the request"
-    )
-    ui_id: str = Field(..., description="Base UI identifier for task tracking")
-    mode: Optional[ManagerDatabaseSource] = None
-
-
-class UpdateComfyUIQueryParams(BaseModel):
-    client_id: str = Field(
-        ..., description="Client identifier that initiated the request"
-    )
-    ui_id: str = Field(..., description="UI identifier for task tracking")
-    stable: Optional[bool] = Field(
-        True,
-        description="Whether to update to stable version (true) or nightly (false)",
-    )
-
-
-class ComfyUISwitchVersionQueryParams(BaseModel):
-    ver: str = Field(..., description="Version to switch to")
-    client_id: str = Field(
-        ..., description="Client identifier that initiated the request"
-    )
-    ui_id: str = Field(..., description="UI identifier for task tracking")
-
-
-class QueueStatus(BaseModel):
-    total_count: int = Field(
-        ..., description="Total number of tasks (pending + running)"
-    )
-    done_count: int = Field(..., description="Number of completed tasks")
-    in_progress_count: int = Field(..., description="Number of tasks currently running")
-    pending_count: Optional[int] = Field(
-        None, description="Number of tasks waiting to be executed"
-    )
-    is_processing: bool = Field(..., description="Whether the task worker is active")
-    client_id: Optional[str] = Field(
-        None, description="Client ID (when filtered by client)"
-    )
-
-
-class ManagerMappings1(BaseModel):
-    title_aux: Optional[str] = Field(None, description="The display name of the pack")
-
-
-class ManagerMappings(
-    RootModel[Optional[Dict[str, List[Union[List[str], ManagerMappings1]]]]]
-):
-    root: Optional[Dict[str, List[Union[List[str], ManagerMappings1]]]] = Field(
-        None, description="Tuple of [node_names, metadata]"
-    )
-
-
-class ModelMetadata(BaseModel):
-    name: str = Field(..., description="Name of the model")
-    type: str = Field(..., description="Type of model")
-    base: Optional[str] = Field(None, description="Base model type")
-    save_path: Optional[str] = Field(None, description="Path for saving the model")
-    url: str = Field(..., description="Download URL")
-    filename: str = Field(..., description="Target filename")
-    ui_id: Optional[str] = Field(None, description="ID for UI reference")
-
-
-class InstallType(str, Enum):
-    git = "git"
-    copy = "copy"
-    pip = "pip"
-
-
-class NodePackageMetadata(BaseModel):
-    title: Optional[str] = Field(None, description="Display name of the node package")
-    name: Optional[str] = Field(None, description="Repository/package name")
-    files: Optional[List[str]] = Field(None, description="Source URLs for the package")
-    description: Optional[str] = Field(
-        None, description="Description of the node package functionality"
-    )
-    install_type: Optional[InstallType] = Field(None, description="Installation method")
-    version: Optional[str] = Field(None, description="Version identifier")
-    id: Optional[str] = Field(
-        None, description="Unique identifier for the node package"
-    )
-    ui_id: Optional[str] = Field(None, description="ID for UI reference")
-    channel: Optional[str] = Field(None, description="Source channel")
-    mode: Optional[str] = Field(None, description="Source mode")
-
-
-class SnapshotItem(RootModel[str]):
-    root: str = Field(..., description="Name of the snapshot")
-
-
-class Error(BaseModel):
-    error: str = Field(..., description="Error message")
-
-
-class InstalledPacksResponse(RootModel[Optional[Dict[str, ManagerPackInstalled]]]):
-    root: Optional[Dict[str, ManagerPackInstalled]] = None
-
-
-class HistoryListResponse(BaseModel):
-    ids: Optional[List[str]] = Field(
-        None, description="List of available batch history IDs"
-    )
-
-
-class InstalledNodeInfo(BaseModel):
-    name: str = Field(..., description="Node package name")
-    version: str = Field(..., description="Installed version")
-    repository_url: Optional[str] = Field(None, description="Git repository URL")
-    install_method: str = Field(
-        ..., description="Installation method (cnr, git, pip, etc.)"
-    )
-    enabled: Optional[bool] = Field(
-        True, description="Whether the node is currently enabled"
-    )
-    install_date: Optional[datetime] = Field(
-        None, description="ISO timestamp of installation"
-    )
-
-
-class InstalledModelInfo(BaseModel):
-    name: str = Field(..., description="Model filename")
-    path: str = Field(..., description="Full path to model file")
-    type: str = Field(..., description="Model type (checkpoint, lora, vae, etc.)")
-    size_bytes: Optional[int] = Field(None, description="File size in bytes", ge=0)
-    hash: Optional[str] = Field(None, description="Model file hash for verification")
-    install_date: Optional[datetime] = Field(
-        None, description="ISO timestamp when added"
-    )
-
-
-class ComfyUIVersionInfo(BaseModel):
-    version: str = Field(..., description="ComfyUI version string")
-    commit_hash: Optional[str] = Field(None, description="Git commit hash")
-    branch: Optional[str] = Field(None, description="Git branch name")
-    is_stable: Optional[bool] = Field(
-        False, description="Whether this is a stable release"
-    )
-    last_updated: Optional[datetime] = Field(
-        None, description="ISO timestamp of last update"
-    )
-
-
-class BatchOperation(BaseModel):
-    operation_id: str = Field(..., description="Unique operation identifier")
-    operation_type: OperationType
-    target: str = Field(
-        ..., description="Target of the operation (node name, model name, etc.)"
-    )
-    target_version: Optional[str] = Field(
-        None, description="Target version for the operation"
-    )
-    result: OperationResult
-    error_message: Optional[str] = Field(
-        None, description="Error message if operation failed"
-    )
-    start_time: datetime = Field(
-        ..., description="ISO timestamp when operation started"
-    )
-    end_time: Optional[datetime] = Field(
-        None, description="ISO timestamp when operation completed"
-    )
-    client_id: Optional[str] = Field(
-        None, description="Client that initiated the operation"
-    )
-
-
-class ComfyUISystemState(BaseModel):
-    snapshot_time: datetime = Field(
-        ..., description="ISO timestamp when snapshot was taken"
-    )
-    comfyui_version: ComfyUIVersionInfo
-    frontend_version: Optional[str] = Field(
-        None, description="ComfyUI frontend version if available"
-    )
-    python_version: str = Field(..., description="Python interpreter version")
-    platform_info: str = Field(
-        ..., description="Operating system and platform information"
-    )
-    installed_nodes: Optional[Dict[str, InstalledNodeInfo]] = Field(
-        None, description="Map of installed node packages by name"
-    )
-    installed_models: Optional[Dict[str, InstalledModelInfo]] = Field(
-        None, description="Map of installed models by name"
-    )
-    manager_config: Optional[Dict[str, Any]] = Field(
-        None, description="ComfyUI Manager configuration settings"
-    )
-    comfyui_root_path: Optional[str] = Field(
-        None, description="ComfyUI root installation directory"
-    )
-    model_paths: Optional[Dict[str, List[str]]] = Field(
-        None, description="Map of model types to their configured paths"
-    )
-    manager_version: Optional[str] = Field(None, description="ComfyUI Manager version")
-    security_level: Optional[SecurityLevel] = None
-    network_mode: Optional[str] = Field(
-        None, description="Network mode (online, offline, private)"
-    )
-    cli_args: Optional[Dict[str, Any]] = Field(
-        None, description="Selected ComfyUI CLI arguments"
-    )
-    custom_nodes_count: Optional[int] = Field(
-        None, description="Total number of custom node packages", ge=0
-    )
-    failed_imports: Optional[List[str]] = Field(
-        None, description="List of custom nodes that failed to import"
-    )
-    pip_packages: Optional[Dict[str, str]] = Field(
-        None, description="Map of installed pip packages to their versions"
-    )
-    embedded_python: Optional[bool] = Field(
-        None,
-        description="Whether ComfyUI is running from an embedded Python distribution",
-    )
-
-
-class BatchExecutionRecord(BaseModel):
-    batch_id: str = Field(..., description="Unique batch identifier")
-    start_time: datetime = Field(..., description="ISO timestamp when batch started")
-    end_time: Optional[datetime] = Field(
-        None, description="ISO timestamp when batch completed"
-    )
-    state_before: ComfyUISystemState
-    state_after: Optional[ComfyUISystemState] = Field(
-        None, description="System state after batch execution"
-    )
-    operations: Optional[List[BatchOperation]] = Field(
-        None, description="List of operations performed in this batch"
-    )
-    total_operations: Optional[int] = Field(
-        0, description="Total number of operations in batch", ge=0
-    )
-    successful_operations: Optional[int] = Field(
-        0, description="Number of successful operations", ge=0
-    )
-    failed_operations: Optional[int] = Field(
-        0, description="Number of failed operations", ge=0
-    )
-    skipped_operations: Optional[int] = Field(
-        0, description="Number of skipped operations", ge=0
-    )
-
-
-class ImportFailInfoBulkRequest(BaseModel):
-    cnr_ids: Optional[List[str]] = Field(
-        None, description="A list of CNR IDs to check."
-    )
-    urls: Optional[List[str]] = Field(
-        None, description="A list of repository URLs to check."
-    )
-
-
-class ImportFailInfoItem1(BaseModel):
-    error: Optional[str] = None
-    traceback: Optional[str] = None
-
-
-class ImportFailInfoItem(RootModel[Optional[ImportFailInfoItem1]]):
-    root: Optional[ImportFailInfoItem1]
-
-
-class QueueTaskItem(BaseModel):
-    ui_id: str = Field(..., description="Unique identifier for the task")
-    client_id: str = Field(..., description="Client identifier that initiated the task")
-    kind: OperationType
-    params: Union[
-        InstallPackParams,
-        UpdatePackParams,
-        UpdateAllPacksParams,
-        UpdateComfyUIParams,
-        FixPackParams,
-        UninstallPackParams,
-        DisablePackParams,
-        EnablePackParams,
-        ModelMetadata,
-    ]
-
-
-class TaskHistoryItem(BaseModel):
-    ui_id: str = Field(..., description="Unique identifier for the task")
-    client_id: str = Field(..., description="Client identifier that initiated the task")
-    kind: str = Field(..., description="Type of task that was performed")
-    timestamp: datetime = Field(..., description="ISO timestamp when task completed")
-    result: str = Field(..., description="Task result message or details")
-    status: Optional[TaskExecutionStatus] = None
-    batch_id: Optional[str] = Field(
-        None, description="ID of the batch this task belongs to"
-    )
-    end_time: Optional[datetime] = Field(
-        None, description="ISO timestamp when task execution ended"
-    )
-
-
-class TaskStateMessage(BaseModel):
-    history: Dict[str, TaskHistoryItem] = Field(
-        ..., description="Map of task IDs to their history items"
-    )
-    running_queue: List[QueueTaskItem] = Field(
-        ..., description="Currently executing tasks"
-    )
-    pending_queue: List[QueueTaskItem] = Field(
-        ..., description="Tasks waiting to be executed"
-    )
-    installed_packs: Dict[str, ManagerPackInstalled] = Field(
-        ..., description="Map of currently installed node packages by name"
-    )
-
-
-class MessageTaskDone(BaseModel):
-    ui_id: str = Field(..., description="Task identifier")
-    result: str = Field(..., description="Task result message")
-    kind: str = Field(..., description="Type of task")
-    status: Optional[TaskExecutionStatus] = None
-    timestamp: datetime = Field(..., description="ISO timestamp when task completed")
-    state: TaskStateMessage
-
-
-class MessageTaskStarted(BaseModel):
-    ui_id: str = Field(..., description="Task identifier")
-    kind: str = Field(..., description="Type of task")
-    timestamp: datetime = Field(..., description="ISO timestamp when task started")
-    state: TaskStateMessage
-
-
-class MessageTaskFailed(BaseModel):
-    ui_id: str = Field(..., description="Task identifier")
-    error: str = Field(..., description="Error message")
-    kind: str = Field(..., description="Type of task")
-    timestamp: datetime = Field(..., description="ISO timestamp when task failed")
-    state: TaskStateMessage
-
-
-class MessageUpdate(
-    RootModel[Union[MessageTaskDone, MessageTaskStarted, MessageTaskFailed]]
-):
-    root: Union[MessageTaskDone, MessageTaskStarted, MessageTaskFailed] = Field(
-        ..., description="Union type for all possible WebSocket message updates"
-    )
-
-
-class HistoryResponse(BaseModel):
-    history: Optional[Dict[str, TaskHistoryItem]] = Field(
-        None, description="Map of task IDs to their history items"
-    )
-
-
-class ImportFailInfoBulkResponse(RootModel[Optional[Dict[str, ImportFailInfoItem]]]):
-    root: Optional[Dict[str, ImportFailInfoItem]] = None

comfyui_manager/glob/CLAUDE.md

@@ -1,11 +0,0 @@
-- Anytime you make a change to the data being sent or received, you should follow this process:
-  1. Adjust the openapi.yaml file first
-  2. Verify the syntax of the openapi.yaml file using `yaml.safe_load`
-  3. Regenerate the types following the instructions in the `data_models/README.md` file
-  4. Verify the new data model is generated
-  5. Verify the syntax of the generated types files
-  6. Run formatting and linting on the generated types files
-  7. Adjust the `__init__.py` files in the `data_models` directory to match/export the new data model
-  8. Only then, make the changes to the rest of the codebase
-  9. Run the CI tests to verify that the changes are working
-- The comfyui_manager is a python package that is used to manage the comfyui server. There are two sub-packages `glob` and `legacy`. These represent the current version (`glob`) and the previous version (`legacy`), not including common utilities and data models. When developing, we work in the `glob` package. You can ignore the `legacy` package entirely, unless you have a very good reason to research how things were done in the legacy or prior major versions of the package. But in those cases, you should just look for the sake of knowledge or reflection, not for changing code (unless explicitly asked to do so).

comfyui_manager/glob/constants.py

@@ -1,55 +0,0 @@
-
-SECURITY_MESSAGE_MIDDLE = "ERROR: To use this action, a security_level of `normal or below` is required. Please contact the administrator.\nReference: https://github.com/ltdrdata/ComfyUI-Manager#security-policy"
-SECURITY_MESSAGE_MIDDLE_P = "ERROR: To use this action, security_level must be `normal or below`, and network_mode must be set to `personal_cloud`. Please contact the administrator.\nReference: https://github.com/ltdrdata/ComfyUI-Manager#security-policy"
-SECURITY_MESSAGE_NORMAL_MINUS = "ERROR: To use this feature, you must either set '--listen' to a local IP and set the security level to 'normal-' or lower, or set the security level to 'middle' or 'weak'. Please contact the administrator.\nReference: https://github.com/ltdrdata/ComfyUI-Manager#security-policy"
-SECURITY_MESSAGE_GENERAL = "ERROR: This installation is not allowed in this security_level. Please contact the administrator.\nReference: https://github.com/ltdrdata/ComfyUI-Manager#security-policy"
-SECURITY_MESSAGE_NORMAL_MINUS_MODEL = "ERROR: Downloading models that are not in '.safetensors' format is only allowed for models registered in the 'default' channel at this security level. If you want to download this model, set the security level to 'normal-' or lower."
-
-
-def is_loopback(address):
-    import ipaddress
-
-    try:
-        return ipaddress.ip_address(address).is_loopback
-    except ValueError:
-        return False
-
-
-model_dir_name_map = {
-    "checkpoints": "checkpoints",
-    "checkpoint": "checkpoints",
-    "unclip": "checkpoints",
-    "text_encoders": "text_encoders",
-    "clip": "text_encoders",
-    "vae": "vae",
-    "lora": "loras",
-    "t2i-adapter": "controlnet",
-    "t2i-style": "controlnet",
-    "controlnet": "controlnet",
-    "clip_vision": "clip_vision",
-    "gligen": "gligen",
-    "upscale": "upscale_models",
-    "embedding": "embeddings",
-    "embeddings": "embeddings",
-    "unet": "diffusion_models",
-    "diffusion_model": "diffusion_models",
-}
-
-# List of all model directory names used for checking installed models
-MODEL_DIR_NAMES = [
-    "checkpoints",
-    "loras",
-    "vae",
-    "text_encoders",
-    "diffusion_models",
-    "clip_vision",
-    "embeddings",
-    "diffusers",
-    "vae_approx",
-    "controlnet",
-    "gligen",
-    "upscale_models",
-    "hypernetworks",
-    "photomaker",
-    "classifiers",
-]

comfyui_manager/glob/share_3rdparty.py

@@ -1,451 +0,0 @@
-import mimetypes
-from ..common import context
-from . import manager_core as core
-
-import os
-from aiohttp import web
-import aiohttp
-import json
-import hashlib
-
-import folder_paths
-from server import PromptServer
-import logging
-import sys
-
-
-try:
-    from nio import AsyncClient, LoginResponse, UploadResponse
-    matrix_nio_is_available = True
-except Exception:
-    logging.warning(f"[ComfyUI-Manager] The matrix sharing feature has been disabled because the `matrix-nio` dependency is not installed.\n\tTo use this feature, please run the following command:\n\t{sys.executable} -m pip install matrix-nio\n")
-    matrix_nio_is_available = False
-
-
-def extract_model_file_names(json_data):
-    """Extract unique file names from the input JSON data."""
-    file_names = set()
-    model_filename_extensions = {'.safetensors', '.ckpt', '.pt', '.pth', '.bin'}
-
-    # Recursively search for file names in the JSON data
-    def recursive_search(data):
-        if isinstance(data, dict):
-            for value in data.values():
-                recursive_search(value)
-        elif isinstance(data, list):
-            for item in data:
-                recursive_search(item)
-        elif isinstance(data, str) and '.' in data:
-            file_names.add(os.path.basename(data))  # file_names.add(data)
-
-    recursive_search(json_data)
-    return [f for f in list(file_names) if os.path.splitext(f)[1] in model_filename_extensions]
-
-
-def find_file_paths(base_dir, file_names):
-    """Find the paths of the files in the base directory."""
-    file_paths = {}
-
-    for root, dirs, files in os.walk(base_dir):
-        # Exclude certain directories
-        dirs[:] = [d for d in dirs if d not in ['.git']]
-
-        for file in files:
-            if file in file_names:
-                file_paths[file] = os.path.join(root, file)
-    return file_paths
-
-
-def compute_sha256_checksum(filepath):
-    """Compute the SHA256 checksum of a file, in chunks"""
-    sha256 = hashlib.sha256()
-    with open(filepath, 'rb') as f:
-        for chunk in iter(lambda: f.read(4096), b''):
-            sha256.update(chunk)
-    return sha256.hexdigest()
-
-
-@PromptServer.instance.routes.get("/v2/manager/share_option")
-async def share_option(request):
-    if "value" in request.rel_url.query:
-        core.get_config()['share_option'] = request.rel_url.query['value']
-        core.write_config()
-    else:
-        return web.Response(text=core.get_config()['share_option'], status=200)
-
-    return web.Response(status=200)
-
-
-def get_openart_auth():
-    if not os.path.exists(os.path.join(context.manager_files_path, ".openart_key")):
-        return None
-    try:
-        with open(os.path.join(context.manager_files_path, ".openart_key"), "r") as f:
-            openart_key = f.read().strip()
-        return openart_key if openart_key else None
-    except Exception:
-        return None
-
-
-def get_matrix_auth():
-    if not os.path.exists(os.path.join(context.manager_files_path, "matrix_auth")):
-        return None
-    try:
-        with open(os.path.join(context.manager_files_path, "matrix_auth"), "r") as f:
-            matrix_auth = f.read()
-            homeserver, username, password = matrix_auth.strip().split("\n")
-            if not homeserver or not username or not password:
-                return None
-        return {
-            "homeserver": homeserver,
-            "username": username,
-            "password": password,
-        }
-    except Exception:
-        return None
-
-
-def get_comfyworkflows_auth():
-    if not os.path.exists(os.path.join(context.manager_files_path, "comfyworkflows_sharekey")):
-        return None
-    try:
-        with open(os.path.join(context.manager_files_path, "comfyworkflows_sharekey"), "r") as f:
-            share_key = f.read()
-            if not share_key.strip():
-                return None
-        return share_key
-    except Exception:
-        return None
-
-
-def get_youml_settings():
-    if not os.path.exists(os.path.join(context.manager_files_path, ".youml")):
-        return None
-    try:
-        with open(os.path.join(context.manager_files_path, ".youml"), "r") as f:
-            youml_settings = f.read().strip()
-        return youml_settings if youml_settings else None
-    except Exception:
-        return None
-
-
-def set_youml_settings(settings):
-    with open(os.path.join(context.manager_files_path, ".youml"), "w") as f:
-        f.write(settings)
-
-
-@PromptServer.instance.routes.get("/v2/manager/get_openart_auth")
-async def api_get_openart_auth(request):
-    # print("Getting stored Matrix credentials...")
-    openart_key = get_openart_auth()
-    if not openart_key:
-        return web.Response(status=404)
-    return web.json_response({"openart_key": openart_key})
-
-
-@PromptServer.instance.routes.post("/v2/manager/set_openart_auth")
-async def api_set_openart_auth(request):
-    json_data = await request.json()
-    openart_key = json_data['openart_key']
-    with open(os.path.join(context.manager_files_path, ".openart_key"), "w") as f:
-        f.write(openart_key)
-    return web.Response(status=200)
-
-
-@PromptServer.instance.routes.get("/v2/manager/get_matrix_auth")
-async def api_get_matrix_auth(request):
-    # print("Getting stored Matrix credentials...")
-    matrix_auth = get_matrix_auth()
-    if not matrix_auth:
-        return web.Response(status=404)
-    return web.json_response(matrix_auth)
-
-
-@PromptServer.instance.routes.get("/v2/manager/youml/settings")
-async def api_get_youml_settings(request):
-    youml_settings = get_youml_settings()
-    if not youml_settings:
-        return web.Response(status=404)
-    return web.json_response(json.loads(youml_settings))
-
-
-@PromptServer.instance.routes.post("/v2/manager/youml/settings")
-async def api_set_youml_settings(request):
-    json_data = await request.json()
-    set_youml_settings(json.dumps(json_data))
-    return web.Response(status=200)
-
-
-@PromptServer.instance.routes.get("/v2/manager/get_comfyworkflows_auth")
-async def api_get_comfyworkflows_auth(request):
-    # Check if the user has provided Matrix credentials in a file called 'matrix_accesstoken'
-    # in the same directory as the ComfyUI base folder
-    # print("Getting stored Comfyworkflows.com auth...")
-    comfyworkflows_auth = get_comfyworkflows_auth()
-    if not comfyworkflows_auth:
-        return web.Response(status=404)
-    return web.json_response({"comfyworkflows_sharekey": comfyworkflows_auth})
-
-
-@PromptServer.instance.routes.post("/v2/manager/set_esheep_workflow_and_images")
-async def set_esheep_workflow_and_images(request):
-    json_data = await request.json()
-    with open(os.path.join(context.manager_files_path, "esheep_share_message.json"), "w", encoding='utf-8') as file:
-        json.dump(json_data, file, indent=4)
-        return web.Response(status=200)
-
-
-@PromptServer.instance.routes.get("/v2/manager/get_esheep_workflow_and_images")
-async def get_esheep_workflow_and_images(request):
-    with open(os.path.join(context.manager_files_path, "esheep_share_message.json"), 'r', encoding='utf-8') as file:
-        data = json.load(file)
-        return web.Response(status=200, text=json.dumps(data))
-
-
-@PromptServer.instance.routes.get("/v2/manager/get_matrix_dep_status")
-async def get_matrix_dep_status(request):
-    if matrix_nio_is_available:
-        return web.Response(status=200, text='available')
-    else:
-        return web.Response(status=200, text='unavailable')
-
-
-def set_matrix_auth(json_data):
-    homeserver = json_data['homeserver']
-    username = json_data['username']
-    password = json_data['password']
-    with open(os.path.join(context.manager_files_path, "matrix_auth"), "w") as f:
-        f.write("\n".join([homeserver, username, password]))
-
-
-def set_comfyworkflows_auth(comfyworkflows_sharekey):
-    with open(os.path.join(context.manager_files_path, "comfyworkflows_sharekey"), "w") as f:
-        f.write(comfyworkflows_sharekey)
-
-
-def has_provided_matrix_auth(matrix_auth):
-    return matrix_auth['homeserver'].strip() and matrix_auth['username'].strip() and matrix_auth['password'].strip()
-
-
-def has_provided_comfyworkflows_auth(comfyworkflows_sharekey):
-    return comfyworkflows_sharekey.strip()
-
-
-@PromptServer.instance.routes.post("/v2/manager/share")
-async def share_art(request):
-    # get json data
-    json_data = await request.json()
-
-    matrix_auth = json_data['matrix_auth']
-    comfyworkflows_sharekey = json_data['cw_auth']['cw_sharekey']
-
-    set_matrix_auth(matrix_auth)
-    set_comfyworkflows_auth(comfyworkflows_sharekey)
-
-    share_destinations = json_data['share_destinations']
-    credits = json_data['credits']
-    title = json_data['title']
-    description = json_data['description']
-    is_nsfw = json_data['is_nsfw']
-    prompt = json_data['prompt']
-    potential_outputs = json_data['potential_outputs']
-    selected_output_index = json_data['selected_output_index']
-
-    try:
-        output_to_share = potential_outputs[int(selected_output_index)]
-    except Exception:
-        # for now, pick the first output
-        output_to_share = potential_outputs[0]
-
-    assert output_to_share['type'] in ('image', 'output')
-    output_dir = folder_paths.get_output_directory()
-
-    if output_to_share['type'] == 'image':
-        asset_filename = output_to_share['image']['filename']
-        asset_subfolder = output_to_share['image']['subfolder']
-
-        if output_to_share['image']['type'] == 'temp':
-            output_dir = folder_paths.get_temp_directory()
-    else:
-        asset_filename = output_to_share['output']['filename']
-        asset_subfolder = output_to_share['output']['subfolder']
-
-    if asset_subfolder:
-        asset_filepath = os.path.join(output_dir, asset_subfolder, asset_filename)
-    else:
-        asset_filepath = os.path.join(output_dir, asset_filename)
-
-    # get the mime type of the asset
-    assetFileType = mimetypes.guess_type(asset_filepath)[0]
-
-    share_website_host = "UNKNOWN"
-    if "comfyworkflows" in share_destinations:
-        share_website_host = "https://comfyworkflows.com"
-        share_endpoint = f"{share_website_host}/api"
-
-        # get presigned urls
-        async with aiohttp.ClientSession(trust_env=True, connector=aiohttp.TCPConnector(verify_ssl=False)) as session:
-            async with session.post(
-                    f"{share_endpoint}/get_presigned_urls",
-                    json={
-                        "assetFileName": asset_filename,
-                        "assetFileType": assetFileType,
-                        "workflowJsonFileName": 'workflow.json',
-                        "workflowJsonFileType": 'application/json',
-                    },
-            ) as resp:
-                assert resp.status == 200
-                presigned_urls_json = await resp.json()
-                assetFilePresignedUrl = presigned_urls_json["assetFilePresignedUrl"]
-                assetFileKey = presigned_urls_json["assetFileKey"]
-                workflowJsonFilePresignedUrl = presigned_urls_json["workflowJsonFilePresignedUrl"]
-                workflowJsonFileKey = presigned_urls_json["workflowJsonFileKey"]
-
-        # upload asset
-        async with aiohttp.ClientSession(trust_env=True, connector=aiohttp.TCPConnector(verify_ssl=False)) as session:
-            async with session.put(assetFilePresignedUrl, data=open(asset_filepath, "rb")) as resp:
-                assert resp.status == 200
-
-        # upload workflow json
-        async with aiohttp.ClientSession(trust_env=True, connector=aiohttp.TCPConnector(verify_ssl=False)) as session:
-            async with session.put(workflowJsonFilePresignedUrl, data=json.dumps(prompt['workflow']).encode('utf-8')) as resp:
-                assert resp.status == 200
-
-        model_filenames = extract_model_file_names(prompt['workflow'])
-        model_file_paths = find_file_paths(folder_paths.base_path, model_filenames)
-
-        models_info = {}
-        for filename, filepath in model_file_paths.items():
-            models_info[filename] = {
-                "filename": filename,
-                "sha256_checksum": compute_sha256_checksum(filepath),
-                "relative_path": os.path.relpath(filepath, folder_paths.base_path),
-            }
-
-        # make a POST request to /api/upload_workflow with form data key values
-        async with aiohttp.ClientSession(trust_env=True, connector=aiohttp.TCPConnector(verify_ssl=False)) as session:
-            form = aiohttp.FormData()
-            if comfyworkflows_sharekey:
-                form.add_field("shareKey", comfyworkflows_sharekey)
-            form.add_field("source", "comfyui_manager")
-            form.add_field("assetFileKey", assetFileKey)
-            form.add_field("assetFileType", assetFileType)
-            form.add_field("workflowJsonFileKey", workflowJsonFileKey)
-            form.add_field("sharedWorkflowWorkflowJsonString", json.dumps(prompt['workflow']))
-            form.add_field("sharedWorkflowPromptJsonString", json.dumps(prompt['output']))
-            form.add_field("shareWorkflowCredits", credits)
-            form.add_field("shareWorkflowTitle", title)
-            form.add_field("shareWorkflowDescription", description)
-            form.add_field("shareWorkflowIsNSFW", str(is_nsfw).lower())
-            form.add_field("currentSnapshot", json.dumps(await core.get_current_snapshot()))
-            form.add_field("modelsInfo", json.dumps(models_info))
-
-            async with session.post(
-                    f"{share_endpoint}/upload_workflow",
-                    data=form,
-            ) as resp:
-                assert resp.status == 200
-                upload_workflow_json = await resp.json()
-                workflowId = upload_workflow_json["workflowId"]
-
-    # check if the user has provided Matrix credentials
-    if matrix_nio_is_available and "matrix" in share_destinations:
-        comfyui_share_room_id = '!LGYSoacpJPhIfBqVfb:matrix.org'
-        filename = os.path.basename(asset_filepath)
-        content_type = assetFileType
-
-        try:
-            homeserver = 'matrix.org'
-            if matrix_auth:
-                homeserver = matrix_auth.get('homeserver', 'matrix.org')
-            homeserver = homeserver.replace("http://", "https://")
-            if not homeserver.startswith("https://"):
-                homeserver = "https://" + homeserver
-
-            client = AsyncClient(homeserver, matrix_auth['username'])
-
-            # Login
-            login_resp = await client.login(matrix_auth['password'])
-            if not isinstance(login_resp, LoginResponse) or not login_resp.access_token:
-                await client.close()
-                return web.json_response({"error": "Invalid Matrix credentials."}, content_type='application/json', status=400)
-
-            # Upload asset
-            with open(asset_filepath, 'rb') as f:
-                upload_resp, _maybe_keys = await client.upload(f, content_type=content_type, filename=filename)
-                asset_data = f.seek(0) or f.read()  # get size for info below
-            if not isinstance(upload_resp, UploadResponse) or not upload_resp.content_uri:
-                await client.close()
-                return web.json_response({"error": "Failed to upload asset to Matrix."}, content_type='application/json', status=500)
-            mxc_url = upload_resp.content_uri
-
-            # Upload workflow JSON
-            import io
-            workflow_json_bytes = json.dumps(prompt['workflow']).encode('utf-8')
-            workflow_io = io.BytesIO(workflow_json_bytes)
-            upload_workflow_resp, _maybe_keys = await client.upload(workflow_io, content_type='application/json', filename='workflow.json')
-            workflow_io.seek(0)
-            if not isinstance(upload_workflow_resp, UploadResponse) or not upload_workflow_resp.content_uri:
-                await client.close()
-                return web.json_response({"error": "Failed to upload workflow to Matrix."}, content_type='application/json', status=500)
-            workflow_json_mxc_url = upload_workflow_resp.content_uri
-
-            # Send text message
-            text_content = ""
-            if title:
-                text_content += f"{title}\n"
-            if description:
-                text_content += f"{description}\n"
-            if credits:
-                text_content += f"\ncredits: {credits}\n"
-            await client.room_send(
-                room_id=comfyui_share_room_id,
-                message_type="m.room.message",
-                content={"msgtype": "m.text", "body": text_content}
-            )
-
-            # Send image
-            await client.room_send(
-                room_id=comfyui_share_room_id,
-                message_type="m.room.message",
-                content={
-                    "msgtype": "m.image",
-                    "body": filename,
-                    "url": mxc_url,
-                    "info": {
-                        "mimetype": content_type,
-                        "size": len(asset_data)
-                    }
-                }
-            )
-
-            # Send workflow JSON file
-            await client.room_send(
-                room_id=comfyui_share_room_id,
-                message_type="m.room.message",
-                content={
-                    "msgtype": "m.file",
-                    "body": "workflow.json",
-                    "url": workflow_json_mxc_url,
-                    "info": {
-                        "mimetype": "application/json",
-                        "size": len(workflow_json_bytes)
-                    }
-                }
-            )
-
-            await client.close()
-
-        except:
-            import traceback
-            traceback.print_exc()
-            return web.json_response({"error": "An error occurred when sharing your art to Matrix."}, content_type='application/json', status=500)
-
-    return web.json_response({
-        "comfyworkflows": {
-            "url": None if "comfyworkflows" not in share_destinations else f"{share_website_host}/workflows/{workflowId}",
-        },
-        "matrix": {
-            "success": None if "matrix" not in share_destinations else True
-        }
-    }, content_type='application/json', status=200)

comfyui_manager/glob/utils/environment_utils.py

@@ -1,142 +0,0 @@
-import os
-import git
-import logging
-import traceback
-
-from comfyui_manager.common import context
-import folder_paths
-from comfy.cli_args import args
-import latent_preview
-
-from comfyui_manager.glob import manager_core as core
-from comfyui_manager.common import cm_global
-
-
-comfy_ui_hash = "-"
-comfyui_tag = None
-
-
-def print_comfyui_version():
-    global comfy_ui_hash
-    global comfyui_tag
-
-    is_detached = False
-    try:
-        repo = git.Repo(os.path.dirname(folder_paths.__file__))
-        core.comfy_ui_revision = len(list(repo.iter_commits("HEAD")))
-
-        comfy_ui_hash = repo.head.commit.hexsha
-        cm_global.variables["comfyui.revision"] = core.comfy_ui_revision
-
-        core.comfy_ui_commit_datetime = repo.head.commit.committed_datetime
-        cm_global.variables["comfyui.commit_datetime"] = core.comfy_ui_commit_datetime
-
-        is_detached = repo.head.is_detached
-        current_branch = repo.active_branch.name
-
-        comfyui_tag = context.get_comfyui_tag()
-
-        try:
-            if (
-                not os.environ.get("__COMFYUI_DESKTOP_VERSION__")
-                and core.comfy_ui_commit_datetime.date()
-                < core.comfy_ui_required_commit_datetime.date()
-            ):
-                logging.warning(
-                    f"\n\n## [WARN] ComfyUI-Manager: Your ComfyUI version ({core.comfy_ui_revision})[{core.comfy_ui_commit_datetime.date()}] is too old. Please update to the latest version. ##\n\n"
-                )
-        except Exception:
-            pass
-
-        # process on_revision_detected -->
-        if "cm.on_revision_detected_handler" in cm_global.variables:
-            for k, f in cm_global.variables["cm.on_revision_detected_handler"]:
-                try:
-                    f(core.comfy_ui_revision)
-                except Exception:
-                    logging.error(f"[ERROR] '{k}' on_revision_detected_handler")
-                    traceback.print_exc()
-
-            del cm_global.variables["cm.on_revision_detected_handler"]
-        else:
-            logging.warning(
-                "[ComfyUI-Manager] Some features are restricted due to your ComfyUI being outdated."
-            )
-        # <--
-
-        if current_branch == "master":
-            if comfyui_tag:
-                logging.info(
-                    f"### ComfyUI Version: {comfyui_tag} | Released on '{core.comfy_ui_commit_datetime.date()}'"
-                )
-            else:
-                logging.info(
-                    f"### ComfyUI Revision: {core.comfy_ui_revision} [{comfy_ui_hash[:8]}] | Released on '{core.comfy_ui_commit_datetime.date()}'"
-                )
-        else:
-            if comfyui_tag:
-                logging.info(
-                    f"### ComfyUI Version: {comfyui_tag} on '{current_branch}' | Released on '{core.comfy_ui_commit_datetime.date()}'"
-                )
-            else:
-                logging.info(
-                    f"### ComfyUI Revision: {core.comfy_ui_revision} on '{current_branch}' [{comfy_ui_hash[:8]}] | Released on '{core.comfy_ui_commit_datetime.date()}'"
-                )
-    except Exception:
-        if is_detached:
-            logging.info(
-                f"### ComfyUI Revision: {core.comfy_ui_revision} [{comfy_ui_hash[:8]}] *DETACHED | Released on '{core.comfy_ui_commit_datetime.date()}'"
-            )
-        else:
-            logging.info(
-                "### ComfyUI Revision: UNKNOWN (The currently installed ComfyUI is not a Git repository)"
-            )
-
-
-def set_preview_method(method):
-    if method == "auto":
-        args.preview_method = latent_preview.LatentPreviewMethod.Auto
-    elif method == "latent2rgb":
-        args.preview_method = latent_preview.LatentPreviewMethod.Latent2RGB
-    elif method == "taesd":
-        args.preview_method = latent_preview.LatentPreviewMethod.TAESD
-    else:
-        args.preview_method = latent_preview.LatentPreviewMethod.NoPreviews
-
-    core.get_config()["preview_method"] = method
-
-
-def set_update_policy(mode):
-    core.get_config()["update_policy"] = mode
-
-
-def set_db_mode(mode):
-    core.get_config()["db_mode"] = mode
-
-
-def setup_environment():
-    git_exe = core.get_config()["git_exe"]
-
-    if git_exe != "":
-        git.Git().update_environment(GIT_PYTHON_GIT_EXECUTABLE=git_exe)
-
-
-def initialize_environment():
-    context.comfy_path = os.path.dirname(folder_paths.__file__)
-    core.js_path = os.path.join(context.comfy_path, "web", "extensions")
-
-    # Legacy database paths - kept for potential future use
-    # local_db_model = os.path.join(manager_util.comfyui_manager_path, "model-list.json")
-    # local_db_alter = os.path.join(manager_util.comfyui_manager_path, "alter-list.json")
-    # local_db_custom_node_list = os.path.join(
-    #     manager_util.comfyui_manager_path, "custom-node-list.json"
-    # )
-    # local_db_extension_node_mappings = os.path.join(
-    #     manager_util.comfyui_manager_path, "extension-node-map.json"
-    # )
-
-    set_preview_method(core.get_config()["preview_method"])
-    print_comfyui_version()
-    setup_environment()
-
-    core.check_invalid_nodes()

comfyui_manager/glob/utils/formatting_utils.py

@@ -1,60 +0,0 @@
-import locale
-import sys
-import re
-
-
-def handle_stream(stream, prefix):
-    stream.reconfigure(encoding=locale.getpreferredencoding(), errors="replace")
-    for msg in stream:
-        if (
-            prefix == "[!]"
-            and ("it/s]" in msg or "s/it]" in msg)
-            and ("%|" in msg or "it [" in msg)
-        ):
-            if msg.startswith("100%"):
-                print("\r" + msg, end="", file=sys.stderr),
-            else:
-                print("\r" + msg[:-1], end="", file=sys.stderr),
-        else:
-            if prefix == "[!]":
-                print(prefix, msg, end="", file=sys.stderr)
-            else:
-                print(prefix, msg, end="")
-
-
-def convert_markdown_to_html(input_text):
-    pattern_a = re.compile(r"\[a/([^]]+)]\(([^)]+)\)")
-    pattern_w = re.compile(r"\[w/([^]]+)]")
-    pattern_i = re.compile(r"\[i/([^]]+)]")
-    pattern_bold = re.compile(r"\*\*([^*]+)\*\*")
-    pattern_white = re.compile(r"%%([^*]+)%%")
-
-    def replace_a(match):
-        return f"<a href='{match.group(2)}' target='blank'>{match.group(1)}</a>"
-
-    def replace_w(match):
-        return f"<p class='cm-warn-note'>{match.group(1)}</p>"
-
-    def replace_i(match):
-        return f"<p class='cm-info-note'>{match.group(1)}</p>"
-
-    def replace_bold(match):
-        return f"<B>{match.group(1)}</B>"
-
-    def replace_white(match):
-        return f"<font color='white'>{match.group(1)}</font>"
-
-    input_text = (
-        input_text.replace("\\[", "&#91;")
-        .replace("\\]", "&#93;")
-        .replace("<", "&lt;")
-        .replace(">", "&gt;")
-    )
-
-    result_text = re.sub(pattern_a, replace_a, input_text)
-    result_text = re.sub(pattern_w, replace_w, result_text)
-    result_text = re.sub(pattern_i, replace_i, result_text)
-    result_text = re.sub(pattern_bold, replace_bold, result_text)
-    result_text = re.sub(pattern_white, replace_white, result_text)
-
-    return result_text.replace("\n", "<BR>")

comfyui_manager/glob/utils/model_utils.py

@@ -1,161 +0,0 @@
-import os
-import logging
-import concurrent.futures
-import folder_paths
-
-from comfyui_manager.glob import manager_core as core
-from comfyui_manager.glob.constants import model_dir_name_map, MODEL_DIR_NAMES
-
-
-def get_model_dir(data, show_log=False):
-    if "download_model_base" in folder_paths.folder_names_and_paths:
-        models_base = folder_paths.folder_names_and_paths["download_model_base"][0][0]
-    else:
-        models_base = folder_paths.models_dir
-
-    # NOTE: Validate to prevent path traversal.
-    if any(char in data["filename"] for char in {"/", "\\", ":"}):
-        return None
-
-    def resolve_custom_node(save_path):
-        save_path = save_path[13:]  # remove 'custom_nodes/'
-
-        # NOTE: Validate to prevent path traversal.
-        if save_path.startswith(os.path.sep) or ":" in save_path:
-            return None
-
-        repo_name = save_path.replace("\\", "/").split("/")[
-            0
-        ]  # get custom node repo name
-
-        # NOTE: The creation of files within the custom node path should be removed in the future.
-        repo_path = core.lookup_installed_custom_nodes_legacy(repo_name)
-        if repo_path is not None and repo_path[0]:
-            # Returns the retargeted path based on the actually installed repository
-            return os.path.join(os.path.dirname(repo_path[1]), save_path)
-        else:
-            return None
-
-    if data["save_path"] != "default":
-        if ".." in data["save_path"] or data["save_path"].startswith("/"):
-            if show_log:
-                logging.info(
-                    f"[WARN] '{data['save_path']}' is not allowed path. So it will be saved into 'models/etc'."
-                )
-            base_model = os.path.join(models_base, "etc")
-        else:
-            if data["save_path"].startswith("custom_nodes"):
-                base_model = resolve_custom_node(data["save_path"])
-                if base_model is None:
-                    if show_log:
-                        logging.info(
-                            f"[ComfyUI-Manager] The target custom node for model download is not installed: {data['save_path']}"
-                        )
-                    return None
-            else:
-                base_model = os.path.join(models_base, data["save_path"])
-    else:
-        model_dir_name = model_dir_name_map.get(data["type"].lower())
-        if model_dir_name is not None:
-            base_model = folder_paths.folder_names_and_paths[model_dir_name][0][0]
-        else:
-            base_model = os.path.join(models_base, "etc")
-
-    return base_model
-
-
-def get_model_path(data, show_log=False):
-    base_model = get_model_dir(data, show_log)
-    if base_model is None:
-        return None
-    else:
-        if data["filename"] == "<huggingface>":
-            return os.path.join(base_model, os.path.basename(data["url"]))
-        else:
-            return os.path.join(base_model, data["filename"])
-
-
-def check_model_installed(json_obj):
-    def is_exists(model_dir_name, filename, url):
-        if filename == "<huggingface>":
-            filename = os.path.basename(url)
-
-        dirs = folder_paths.get_folder_paths(model_dir_name)
-
-        for x in dirs:
-            if os.path.exists(os.path.join(x, filename)):
-                return True
-
-        return False
-
-    total_models_files = set()
-    for x in MODEL_DIR_NAMES:
-        for y in folder_paths.get_filename_list(x):
-            total_models_files.add(y)
-
-    def process_model_phase(item):
-        if (
-            "diffusion" not in item["filename"]
-            and "pytorch" not in item["filename"]
-            and "model" not in item["filename"]
-        ):
-            # non-general name case
-            if item["filename"] in total_models_files:
-                item["installed"] = "True"
-                return
-
-        if item["save_path"] == "default":
-            model_dir_name = model_dir_name_map.get(item["type"].lower())
-            if model_dir_name is not None:
-                item["installed"] = str(
-                    is_exists(model_dir_name, item["filename"], item["url"])
-                )
-            else:
-                item["installed"] = "False"
-        else:
-            model_dir_name = item["save_path"].split("/")[0]
-            if model_dir_name in folder_paths.folder_names_and_paths:
-                if is_exists(model_dir_name, item["filename"], item["url"]):
-                    item["installed"] = "True"
-
-            if "installed" not in item:
-                if item["filename"] == "<huggingface>":
-                    filename = os.path.basename(item["url"])
-                else:
-                    filename = item["filename"]
-
-                fullpath = os.path.join(
-                    folder_paths.models_dir, item["save_path"], filename
-                )
-
-                item["installed"] = "True" if os.path.exists(fullpath) else "False"
-
-    with concurrent.futures.ThreadPoolExecutor(8) as executor:
-        for item in json_obj["models"]:
-            executor.submit(process_model_phase, item)
-
-
-async def check_whitelist_for_model(item):
-    from comfyui_manager.data_models import ManagerDatabaseSource
-    
-    json_obj = await core.get_data_by_mode(ManagerDatabaseSource.cache.value, "model-list.json")
-
-    for x in json_obj.get("models", []):
-        if (
-            x["save_path"] == item["save_path"]
-            and x["base"] == item["base"]
-            and x["filename"] == item["filename"]
-        ):
-            return True
-
-    json_obj = await core.get_data_by_mode(ManagerDatabaseSource.local.value, "model-list.json")
-
-    for x in json_obj.get("models", []):
-        if (
-            x["save_path"] == item["save_path"]
-            and x["base"] == item["base"]
-            and x["filename"] == item["filename"]
-        ):
-            return True
-
-    return False

comfyui_manager/glob/utils/node_pack_utils.py

@@ -1,65 +0,0 @@
-import concurrent.futures
-
-from comfyui_manager.glob import manager_core as core
-
-
-def check_state_of_git_node_pack(
-    node_packs, do_fetch=False, do_update_check=True, do_update=False
-):
-    if do_fetch:
-        print("Start fetching...", end="")
-    elif do_update:
-        print("Start updating...", end="")
-    elif do_update_check:
-        print("Start update check...", end="")
-
-    def process_custom_node(item):
-        core.check_state_of_git_node_pack_single(
-            item, do_fetch, do_update_check, do_update
-        )
-
-    with concurrent.futures.ThreadPoolExecutor(4) as executor:
-        for k, v in node_packs.items():
-            if v.get("active_version") in ["unknown", "nightly"]:
-                executor.submit(process_custom_node, v)
-
-    if do_fetch:
-        print("\x1b[2K\rFetching done.")
-    elif do_update:
-        update_exists = any(
-            item.get("updatable", False) for item in node_packs.values()
-        )
-        if update_exists:
-            print("\x1b[2K\rUpdate done.")
-        else:
-            print("\x1b[2K\rAll extensions are already up-to-date.")
-    elif do_update_check:
-        print("\x1b[2K\rUpdate check done.")
-
-
-def nickname_filter(json_obj):
-    preemptions_map = {}
-
-    for k, x in json_obj.items():
-        if "preemptions" in x[1]:
-            for y in x[1]["preemptions"]:
-                preemptions_map[y] = k
-        elif k.endswith("/ComfyUI"):
-            for y in x[0]:
-                preemptions_map[y] = k
-
-    updates = {}
-    for k, x in json_obj.items():
-        removes = set()
-        for y in x[0]:
-            k2 = preemptions_map.get(y)
-            if k2 is not None and k != k2:
-                removes.add(y)
-
-        if len(removes) > 0:
-            updates[k] = [y for y in x[0] if y not in removes]
-
-    for k, v in updates.items():
-        json_obj[k][0] = v
-
-    return json_obj

comfyui_manager/glob/utils/security_utils.py

@@ -1,67 +0,0 @@
-from comfyui_manager.glob import manager_core as core
-from comfy.cli_args import args
-from comfyui_manager.data_models import SecurityLevel, RiskLevel, ManagerDatabaseSource
-
-
-def is_loopback(address):
-    import ipaddress
-    try:
-        return ipaddress.ip_address(address).is_loopback
-    except ValueError:
-        return False
-
-
-def is_allowed_security_level(level):
-    is_local_mode = is_loopback(args.listen)
-    is_personal_cloud = core.get_config()['network_mode'].lower() == 'personal_cloud'
-
-    if level == RiskLevel.block.value:
-        return False
-    elif level == RiskLevel.high_.value:
-        if is_local_mode:
-            return core.get_config()['security_level'] in [SecurityLevel.weak.value, SecurityLevel.normal_.value]
-        elif is_personal_cloud:
-            return core.get_config()['security_level'] == SecurityLevel.weak.value
-        else:
-            return False
-    elif level == RiskLevel.high.value:
-        if is_local_mode:
-            return core.get_config()['security_level'] in [SecurityLevel.weak.value, SecurityLevel.normal_.value]
-        else:
-            return core.get_config()['security_level'] == SecurityLevel.weak.value
-    elif level == RiskLevel.middle_.value:
-        if is_local_mode or is_personal_cloud:
-            return core.get_config()['security_level'] in [SecurityLevel.weak.value, SecurityLevel.normal.value, SecurityLevel.normal_.value]
-        else:
-            return False
-    elif level == RiskLevel.middle.value:
-        return core.get_config()['security_level'] in [SecurityLevel.weak.value, SecurityLevel.normal.value, SecurityLevel.normal_.value]
-    else:
-        return True
-
-
-async def get_risky_level(files, pip_packages):
-    json_data1 = await core.get_data_by_mode(ManagerDatabaseSource.local.value, "custom-node-list.json")
-    json_data2 = await core.get_data_by_mode(
-        ManagerDatabaseSource.cache.value,
-        "custom-node-list.json",
-        channel_url="https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main",
-    )
-
-    all_urls = set()
-    for x in json_data1["custom_nodes"] + json_data2["custom_nodes"]:
-        all_urls.update(x.get("files", []))
-
-    for x in files:
-        if x not in all_urls:
-            return RiskLevel.high_.value
-
-    all_pip_packages = set()
-    for x in json_data1["custom_nodes"] + json_data2["custom_nodes"]:
-        all_pip_packages.update(x.get("pip", []))
-
-    for p in pip_packages:
-        if p not in all_pip_packages:
-            return RiskLevel.block.value
-
-    return RiskLevel.middle_.value

docs/en/cm-cli.md

@@ -139,9 +139,9 @@ You can set whether to use ComfyUI-Manager solely via CLI.
 `restore-dependencies`
 
 * This command can be used if custom nodes are installed under the `ComfyUI/custom_nodes` path but their dependencies are not installed.
-* It is useful when starting a new cloud instance, like colab, where dependencies need to be reinstalled and installation scripts re-executed.
+* It is useful when starting a new cloud instance, like Colab, where dependencies need to be reinstalled and installation scripts re-executed.
 * It can also be utilized if ComfyUI is reinstalled and only the custom_nodes path has been backed up and restored.
 
 ### 7. Clear
 
-In the GUI, installations, updates, or snapshot restorations are scheduled to execute the next time ComfyUI is launched. The `clear` command clears this scheduled state, ensuring no pre-execution actions are applied.
+In the GUI, installations, updates, or snapshot restorations are scheduled to execute the next time ComfyUI is launched. The `clear` command clears this scheduled state, ensuring no pre-execution actions are applied.

docs/ko/cm-cli.md

@@ -23,13 +23,13 @@ OPTIONS:
 ## How To Use?
 * `python cm-cli.py` 를 통해서 실행 시킬 수 있습니다.
 * 예를 들어 custom node를 모두 업데이트 하고 싶다면
-    * ComfyUI-Manager경로 에서 `python cm-cli.py update all` 를 command를 실행할 수 있습니다.
+    * ComfyUI-Manager 경로에서 `python cm-cli.py update all` 명령을 실행할 수 있습니다.
     * ComfyUI 경로에서 실행한다면, `python custom_nodes/ComfyUI-Manager/cm-cli.py update all` 와 같이 cm-cli.py 의 경로를 지정할 수도 있습니다.
 
 ## Prerequisite
 * ComfyUI 를 실행하는 python과 동일한 python 환경에서 실행해야 합니다.
     * venv를 사용할 경우 해당 venv를 activate 한 상태에서 실행해야 합니다.
-    * portable 버전을 사용할 경우 run_nvidia_gpu.bat 파일이 있는 경로인 경우, 다음과 같은 방식으로 코맨드를 실행해야 합니다.
+* portable 버전을 사용할 경우 run_nvidia_gpu.bat 파일이 있는 경로인 경우, 다음과 같은 방식으로 명령을 실행해야 합니다.
         `.\python_embeded\python.exe ComfyUI\custom_nodes\ComfyUI-Manager\cm-cli.py update all`
 * ComfyUI 의 경로는 COMFYUI_PATH 환경 변수로 설정할 수 있습니다. 만약 생략할 경우 다음과 같은 경고 메시지가 나타나며, ComfyUI-Manager가 설치된 경로를 기준으로 상대 경로로 설정됩니다.
         ```
@@ -40,8 +40,8 @@ OPTIONS:
 
 ### 1. --channel, --mode
 * 정보 보기 기능과 커스텀 노드 관리 기능의 경우는 --channel과 --mode를 통해 정보 DB를 설정할 수 있습니다.
-* 예들 들어 `python cm-cli.py update all --channel recent --mode remote`와 같은 command를 실행할 경우, 현재 ComfyUI-Manager repo에 내장된 로컬의 정보가 아닌 remote의 최신 정보를 기준으로 동작하며, recent channel에 있는 목록을 대상으로만 동작합니다.
-* --channel, --mode 는 `simple-show, show, install, uninstall, update, disable, enable, fix` command에서만 사용 가능합니다.
+* 예를 들어 `python cm-cli.py update all --channel recent --mode remote`와 같은 명령을 실행할 경우, 현재 ComfyUI-Manager repo에 내장된 로컬의 정보가 아닌 remote의 최신 정보를 기준으로 동작하며, recent channel에 있는 목록을 대상으로만 동작합니다.
+* --channel, --mode 는 `simple-show, show, install, uninstall, update, disable, enable, fix` 명령에서만 사용 가능합니다.
 
 ### 2. 관리 정보 보기
 
@@ -51,7 +51,7 @@ OPTIONS:
 * `[show|simple-show]` - `show`는 상세하게 정보를 보여주며, `simple-show`는 간단하게 정보를 보여줍니다.
 
 
-`python cm-cli.py show installed` 와 같은 코맨드를 실행하면 설치된 커스텀 노드의 정보를 상세하게 보여줍니다.
+`python cm-cli.py show installed` 와 같은 명령을 실행하면 설치된 커스텀 노드의 정보를 상세하게 보여줍니다.
 ```
 -= ComfyUI-Manager CLI (V2.24) =-
 
@@ -67,7 +67,7 @@ FETCH DATA from: https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main
 [    DISABLED   ]  ComfyUI-Loopchain                                 (author: Fannovel16)
 ```
 
-`python cm-cli.py simple-show installed` 와 같은 코맨드를 이용해서 설치된 커스텀 노드의 정보를 간단하게 보여줍니다.
+`python cm-cli.py simple-show installed` 와 같은 명령을 이용해서 설치된 커스텀 노드의 정보를 간단하게 보여줍니다.
 
 ```
 -= ComfyUI-Manager CLI (V2.24) =-
@@ -89,7 +89,7 @@ ComfyUI-Loopchain
     * `installed`: enable, disable 여부와 상관없이 설치된 모든 노드를 보여줍니다
     * `not-installed`: 설치되지 않은 커스텀 노드의 목록을 보여줍니다.
     * `all`: 모든 커스텀 노드의 목록을 보여줍니다.
-    * `snapshot`: 현재 설치된 커스텀 노드의 snapshot 정보를 보여줍니다. `show`롤 통해서 볼 경우는 json 출력 형태로  보여주며, `simple-show`를 통해서 볼 경우는 간단하게, 커밋 해시와 함께 보여줍니다.
+    * `snapshot`: 현재 설치된 커스텀 노드의 snapshot 정보를 보여줍니다. `show`를 통해서 볼 경우는 json 출력 형태로 보여주며, `simple-show`를 통해서 볼 경우는 간단하게, 커밋 해시와 함께 보여줍니다.
     * `snapshot-list`: ComfyUI-Manager/snapshots 에 저장된 snapshot 파일의 목록을 보여줍니다.
 
 ### 3. 커스텀 노드 관리 하기
@@ -98,7 +98,7 @@ ComfyUI-Loopchain
 
 * `python cm-cli.py install ComfyUI-Impact-Pack ComfyUI-Inspire-Pack ComfyUI_experiments` 와 같이 커스텀 노드의 이름을 나열해서 관리 기능을 적용할 수 있습니다.
 * 커스텀 노드의 이름은 `show`를 했을 때 보여주는 이름이며, git repository의 이름입니다. 
-(추후 nickname 을 사용가능하돌고 업데이트 할 예정입니다.)
+(추후 nickname을 사용 가능하도록 업데이트할 예정입니다.)
 
 `[update|disable|enable|fix] all ?[--channel <channel name>] ?[--mode [remote|local|cache]]`
 
@@ -124,7 +124,7 @@ ComfyUI-Loopchain
   * `--pip-non-local-url`: web URL에 등록된 pip 패키지들에 대해서 복구를 수행
   * `--pip-local-url`: local 경로를 지정하고 있는 pip 패키지들에 대해서 복구를 수행 
   * `--user-directory`: 사용자 디렉토리 설정
-  * `--restore-to`: 복구될 커스텀 노드가 설치될 경로. (이 옵션을 적용할 경우 오직 대상 경로에 설치된 custom nodes 만 설치된 것으로 인식함.)
+  * `--restore-to`: 복구될 커스텀 노드가 설치될 경로. (이 옵션을 적용할 경우 오직 대상 경로에 설치된 custom nodes만 설치된 것으로 인식함.)
 
 ### 5. CLI only mode
 
@@ -133,7 +133,7 @@ ComfyUI-Manager를 CLI로만 사용할 것인지를 설정할 수 있습니다.
 `cli-only-mode [enable|disable]`
 
 * security 혹은 policy 의 이유로 GUI 를 통한 ComfyUI-Manager 사용을 제한하고 싶은 경우 이 모드를 사용할 수 있습니다.
-    * CLI only mode를 적용할 경우 ComfyUI-Manager 가 매우 제한된 상태로 로드되어, 내부적으로 제공하는 web API가 비활성화 되며, 메인 메뉴에서도 Manager 버튼이 표시되지 않습니다.
+    * CLI only mode를 적용할 경우 ComfyUI-Manager 가 매우 제한된 상태로 로드되어, 내부적으로 제공하는 web API가 비활성화되며, 메인 메뉴에서도 Manager 버튼이 표시되지 않습니다.
 
 
 ### 6. 의존성 설치
@@ -141,10 +141,10 @@ ComfyUI-Manager를 CLI로만 사용할 것인지를 설정할 수 있습니다.
 `restore-dependencies`
 
 * `ComfyUI/custom_nodes` 하위 경로에 커스텀 노드들이 설치되어 있긴 하지만, 의존성이 설치되지 않은 경우 사용할 수 있습니다.
-* colab 과 같이 cloud instance를 새로 시작하는 경우 의존성 재설치 및 설치 스크립트가 재실행 되어야 하는 경우 사용합니다.
-* ComfyUI을 재설치할 경우, custom_nodes 경로만 백업했다가 재설치 할 경우 활용 가능합니다.
+* Colab과 같이 cloud instance를 새로 시작하는 경우 의존성 재설치 및 설치 스크립트가 재실행되어야 하는 경우 사용합니다.
+* ComfyUI를 재설치할 경우, custom_nodes 경로만 백업했다가 재설치할 경우 활용 가능합니다.
 
 
 ### 7. clear
 
-GUI에서 install, update를 하거나 snapshot 을 restore하는 경우 예약을 통해서 다음번 ComfyUI를 실행할 경우 실행되는 구조입니다. `clear` 는 이런 예약 상태를 clear해서, 아무런 사전 실행이 적용되지 않도록 합니다.
+GUI에서 install, update를 하거나 snapshot을 restore하는 경우 예약을 통해서 다음번 ComfyUI를 실행할 경우 실행되는 구조입니다. `clear` 는 이런 예약 상태를 clear해서, 아무런 사전 실행이 적용되지 않도록 합니다.

git_helper.py

@@ -15,12 +15,9 @@ comfy_path = os.environ.get('COMFYUI_PATH')
 git_exe_path = os.environ.get('GIT_EXE_PATH')
 
 if comfy_path is None:
-    print("git_helper: environment variable 'COMFYUI_PATH' is not specified.")
-    exit(-1)
+    print("\nWARN: The `COMFYUI_PATH` environment variable is not set. Assuming `custom_nodes/ComfyUI-Manager/../../` as the ComfyUI path.", file=sys.stderr)
+    comfy_path = os.path.abspath(os.path.join(os.path.dirname(__file__), '..', '..'))
 
-if not os.path.exists(os.path.join(comfy_path, 'folder_paths.py')):
-    print("git_helper: '{comfy_path}' is not a valid 'COMFYUI_PATH' location.")
-    exit(-1)
 
 def download_url(url, dest_folder, filename=None):
     # Ensure the destination folder exists
@@ -156,27 +153,27 @@ def switch_to_default_branch(repo):
         default_branch = repo.git.symbolic_ref(f'refs/remotes/{remote_name}/HEAD').replace(f'refs/remotes/{remote_name}/', '')
         repo.git.checkout(default_branch)
         return True
-    except Exception:
+    except:
         # try checkout master
         # try checkout main if failed
         try:
             repo.git.checkout(repo.heads.master)
             return True
-        except Exception:
+        except:
             try:
                 if remote_name is not None:
                     repo.git.checkout('-b', 'master', f'{remote_name}/master')
                     return True
-            except Exception:
+            except:
                 try:
                     repo.git.checkout(repo.heads.main)
                     return True
-                except Exception:
+                except:
                     try:
                         if remote_name is not None:
                             repo.git.checkout('-b', 'main', f'{remote_name}/main')
                             return True
-                    except Exception:
+                    except:
                         pass
 
     print("[ComfyUI Manager] Failed to switch to the default branch")
@@ -447,7 +444,7 @@ def restore_pip_snapshot(pips, options):
         res = 1
         try:
             res = subprocess.check_call([sys.executable, '-m', 'pip', 'install'] + non_url)
-        except Exception:
+        except:
             pass
 
         # fallback
@@ -456,7 +453,7 @@ def restore_pip_snapshot(pips, options):
                 res = 1
                 try:
                     res = subprocess.check_call([sys.executable, '-m', 'pip', 'install', x])
-                except Exception:
+                except:
                     pass
 
                 if res != 0:
@@ -467,7 +464,7 @@ def restore_pip_snapshot(pips, options):
             res = 1
             try:
                 res = subprocess.check_call([sys.executable, '-m', 'pip', 'install', x])
-            except Exception:
+            except:
                 pass
 
             if res != 0:
@@ -478,7 +475,7 @@ def restore_pip_snapshot(pips, options):
             res = 1
             try:
                 res = subprocess.check_call([sys.executable, '-m', 'pip', 'install', x])
-            except Exception:
+            except:
                 pass
 
             if res != 0:

glob/README.md

@@ -2,16 +2,20 @@
 
 This directory contains the Python backend modules that power ComfyUI-Manager, handling the core functionality of node management, downloading, security, and server operations.
 
-## Directory Structure
-- **glob/** - code for new cacheless ComfyUI-Manager
-- **legacy/** - code for legacy ComfyUI-Manager
-
 ## Core Modules
+
 - **manager_core.py**: The central implementation of management functions, handling configuration, installation, updates, and node management.
 - **manager_server.py**: Implements server functionality and API endpoints for the web interface to interact with the backend.
+- **manager_downloader.py**: Handles downloading operations for models, extensions, and other resources.
+- **manager_util.py**: Provides utility functions used throughout the system.
 
 ## Specialized Modules
 
+- **cm_global.py**: Maintains global variables and state management across the system.
+- **cnr_utils.py**: Helper utilities for interacting with the custom node registry (CNR).
+- **git_utils.py**: Git-specific utilities for repository operations.
+- **node_package.py**: Handles the packaging and installation of node extensions.
+- **security_check.py**: Implements the multi-level security system for installation safety.
 - **share_3rdparty.py**: Manages integration with third-party sharing platforms.
 
 ## Architecture

glob/cnr_utils.py

@@ -6,9 +6,8 @@ import time
 from dataclasses import dataclass
 from typing import List
 
-from . import context
-from . import manager_util
-
+import manager_core
+import manager_util
 import requests
 import toml
 
@@ -48,9 +47,9 @@ async def _get_cnr_data(cache_mode=True, dont_wait=True):
         # Get ComfyUI version tag
         if is_desktop:
             # extract version from pyproject.toml instead of git tag
-            comfyui_ver = context.get_current_comfyui_ver() or 'unknown'
+            comfyui_ver = manager_core.get_current_comfyui_ver() or 'unknown'
         else:
-            comfyui_ver = context.get_comfyui_tag() or 'unknown'
+            comfyui_ver = manager_core.get_comfyui_tag() or 'unknown'
 
         if is_desktop:
             if is_windows:
@@ -112,7 +111,7 @@ async def _get_cnr_data(cache_mode=True, dont_wait=True):
         json_obj = await fetch_all()
         manager_util.save_to_cache(uri, json_obj)
         return json_obj['nodes']
-    except Exception:
+    except:
         res = {}
         print("Cannot connect to comfyregistry.")
     finally:
@@ -211,7 +210,6 @@ def read_cnr_info(fullpath):
 
             project = data.get('project', {})
             name = project.get('name').strip().lower()
-            original_name = project.get('name')
 
             # normalize version
             # for example: 2.5 -> 2.5.0
@@ -223,7 +221,6 @@ def read_cnr_info(fullpath):
             if name and version:  # repository is optional
                 return {
                     "id": name,
-                    "original_name": original_name,
                     "version": version,
                     "url": repository
                 }
@@ -239,7 +236,7 @@ def generate_cnr_id(fullpath, cnr_id):
         if not os.path.exists(cnr_id_path):
             with open(cnr_id_path, "w") as f:
                 return f.write(cnr_id)
-    except Exception:
+    except:
         print(f"[ComfyUI Manager] unable to create file: {cnr_id_path}")
 
 
@@ -249,7 +246,7 @@ def read_cnr_id(fullpath):
         if os.path.exists(cnr_id_path):
             with open(cnr_id_path) as f:
                 return f.read().strip()
-    except Exception:
+    except:
         pass
 
     return None

glob/manager_core.py

@@ -23,6 +23,7 @@ import yaml
 import zipfile
 import traceback
 from concurrent.futures import ThreadPoolExecutor, as_completed
+import toml
 
 orig_print = print
 
@@ -31,22 +32,22 @@ from packaging import version
 
 import uuid
 
-from ..common import cm_global
-from ..common import cnr_utils
-from ..common import manager_util
-from ..common import git_utils
-from ..common import manager_downloader
-from ..common.node_package import InstalledNodePackage
-from ..common.enums import NetworkMode, SecurityLevel, DBMode
-from ..common import context
+glob_path = os.path.join(os.path.dirname(__file__))  # ComfyUI-Manager/glob
+sys.path.append(glob_path)
+
+import cm_global
+import cnr_utils
+import manager_util
+import git_utils
+import manager_downloader
+from node_package import InstalledNodePackage
 
 
-version_code = [4, 0, 2]
+version_code = [3, 37]
 version_str = f"V{version_code[0]}.{version_code[1]}" + (f'.{version_code[2]}' if len(version_code) > 2 else '')
 
 
-DEFAULT_CHANNEL = "https://raw.githubusercontent.com/Comfy-Org/ComfyUI-Manager/main"
-DEFAULT_CHANNEL_LEGACY = "https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main"
+DEFAULT_CHANNEL = "https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main"
 
 
 default_custom_nodes_path = None
@@ -57,14 +58,13 @@ class InvalidChannel(Exception):
         self.channel = channel
         super().__init__(channel)
 
-
 def get_default_custom_nodes_path():
     global default_custom_nodes_path
     if default_custom_nodes_path is None:
         try:
             import folder_paths
             default_custom_nodes_path = folder_paths.get_folder_paths("custom_nodes")[0]
-        except Exception:
+        except:
             default_custom_nodes_path = os.path.abspath(os.path.join(manager_util.comfyui_manager_path, '..'))
 
     return default_custom_nodes_path
@@ -74,11 +74,37 @@ def get_custom_nodes_paths():
         try:
             import folder_paths
             return folder_paths.get_folder_paths("custom_nodes")
-        except Exception:
+        except:
             custom_nodes_path = os.path.abspath(os.path.join(manager_util.comfyui_manager_path, '..'))
             return [custom_nodes_path]
 
 
+def get_comfyui_tag():
+    try:
+        repo = git.Repo(comfy_path)
+        return repo.git.describe('--tags')
+    except:
+        return None
+
+
+def get_current_comfyui_ver():
+    """
+    Extract version from pyproject.toml
+    """
+    toml_path = os.path.join(comfy_path, 'pyproject.toml')
+    if not os.path.exists(toml_path):
+        return None
+    else:
+        try:
+            with open(toml_path, "r", encoding="utf-8") as f:
+                data = toml.load(f)
+
+                project = data.get('project', {})
+                return project.get('version')
+        except:
+            return None
+
+
 def get_script_env():
     new_env = os.environ.copy()
     git_exe = get_config().get('git_exe')
@@ -86,10 +112,10 @@ def get_script_env():
         new_env['GIT_EXE_PATH'] = git_exe
 
     if 'COMFYUI_PATH' not in new_env:
-        new_env['COMFYUI_PATH'] = context.comfy_path
+        new_env['COMFYUI_PATH'] = comfy_path
 
     if 'COMFYUI_FOLDERS_BASE_PATH' not in new_env:
-        new_env['COMFYUI_FOLDERS_BASE_PATH'] = context.comfy_path
+        new_env['COMFYUI_FOLDERS_BASE_PATH'] = comfy_path
 
     return new_env
 
@@ -111,12 +137,12 @@ def check_invalid_nodes():
 
     try:
         import folder_paths
-    except Exception:
+    except:
         try:
-            sys.path.append(context.comfy_path)
+            sys.path.append(comfy_path)
             import folder_paths
-        except Exception:
-            raise Exception(f"Invalid COMFYUI_FOLDERS_BASE_PATH: {context.comfy_path}")
+        except:
+            raise Exception(f"Invalid COMFYUI_FOLDERS_BASE_PATH: {comfy_path}")
 
     def check(root):
         global invalid_nodes
@@ -151,6 +177,75 @@ def check_invalid_nodes():
         print("\n---------------------------------------------------------------------------\n")
 
 
+# read env vars
+comfy_path: str = os.environ.get('COMFYUI_PATH')
+comfy_base_path = os.environ.get('COMFYUI_FOLDERS_BASE_PATH')
+
+if comfy_path is None:
+    try:
+        import folder_paths
+        comfy_path = os.path.join(os.path.dirname(folder_paths.__file__))
+    except:
+        comfy_path = os.path.abspath(os.path.join(manager_util.comfyui_manager_path, '..', '..'))
+
+if comfy_base_path is None:
+    comfy_base_path = comfy_path
+
+
+channel_list_template_path = os.path.join(manager_util.comfyui_manager_path, 'channels.list.template')
+git_script_path = os.path.join(manager_util.comfyui_manager_path, "git_helper.py")
+
+manager_files_path = None
+manager_config_path = None
+manager_channel_list_path = None
+manager_startup_script_path:str = None
+manager_snapshot_path = None
+manager_pip_overrides_path = None
+manager_pip_blacklist_path = None
+manager_components_path = None
+
+def update_user_directory(user_dir):
+    global manager_files_path
+    global manager_config_path
+    global manager_channel_list_path
+    global manager_startup_script_path
+    global manager_snapshot_path
+    global manager_pip_overrides_path
+    global manager_pip_blacklist_path
+    global manager_components_path
+
+    manager_files_path = os.path.abspath(os.path.join(user_dir, 'default', 'ComfyUI-Manager'))
+    if not os.path.exists(manager_files_path):
+        os.makedirs(manager_files_path)
+
+    manager_snapshot_path = os.path.join(manager_files_path, "snapshots")
+    if not os.path.exists(manager_snapshot_path):
+        os.makedirs(manager_snapshot_path)
+
+    manager_startup_script_path = os.path.join(manager_files_path, "startup-scripts")
+    if not os.path.exists(manager_startup_script_path):
+        os.makedirs(manager_startup_script_path)
+
+    manager_config_path = os.path.join(manager_files_path, 'config.ini')
+    manager_channel_list_path = os.path.join(manager_files_path, 'channels.list')
+    manager_pip_overrides_path = os.path.join(manager_files_path, "pip_overrides.json")
+    manager_pip_blacklist_path = os.path.join(manager_files_path, "pip_blacklist.list")
+    manager_components_path = os.path.join(manager_files_path, "components")
+    manager_util.cache_dir = os.path.join(manager_files_path, "cache")
+
+    if not os.path.exists(manager_util.cache_dir):
+        os.makedirs(manager_util.cache_dir)
+
+try:
+    import folder_paths
+    update_user_directory(folder_paths.get_user_directory())
+
+except Exception:
+    # fallback:
+    # This case is only possible when running with cm-cli, and in practice, this case is not actually used.
+    update_user_directory(os.path.abspath(manager_util.comfyui_manager_path))
+
+
 cached_config = None
 js_path = None
 
@@ -161,7 +256,7 @@ comfy_ui_revision = "Unknown"
 comfy_ui_commit_datetime = datetime(1900, 1, 1, 0, 0, 0)
 
 channel_dict = None
-valid_channels = {'default', 'local', DEFAULT_CHANNEL, DEFAULT_CHANNEL_LEGACY}
+valid_channels = {'default', 'local'}
 channel_list = None
 
 
@@ -526,7 +621,7 @@ class UnifiedManager:
                     ver = str(manager_util.StrictVersion(info['version']))
                     return {'id': cnr['id'], 'cnr': cnr, 'ver': ver}
                 else:
-                    return {'id': info['id'], 'ver': info['version']}
+                    return None
             else:
                 return None
 
@@ -702,9 +797,7 @@ class UnifiedManager:
 
         return latest
 
-    async def reload(self, cache_mode, dont_wait=True, update_cnr_map=True):
-        import folder_paths
-
+    async def reload(self, cache_mode, dont_wait=True):
         self.custom_node_map_cache = {}
         self.cnr_inactive_nodes = {}      # node_id -> node_version -> fullpath
         self.nightly_inactive_nodes = {}  # node_id -> fullpath
@@ -712,18 +805,17 @@ class UnifiedManager:
         self.unknown_active_nodes = {}    # node_id -> repo url * fullpath
         self.active_nodes = {}            # node_id -> node_version * fullpath
 
-        if get_config()['network_mode'] != 'public' or manager_util.is_manager_pip_package():
+        if get_config()['network_mode'] != 'public':
             dont_wait = True
 
-        if update_cnr_map:
-            # reload 'cnr_map' and 'repo_cnr_map'
-            cnrs = await cnr_utils.get_cnr_data(cache_mode=cache_mode=='cache', dont_wait=dont_wait)
+        # reload 'cnr_map' and 'repo_cnr_map'
+        cnrs = await cnr_utils.get_cnr_data(cache_mode=cache_mode=='cache', dont_wait=dont_wait)
 
-            for x in cnrs:
-                self.cnr_map[x['id']] = x
-                if 'repository' in x:
-                    normalized_url = git_utils.normalize_url(x['repository'])
-                    self.repo_cnr_map[normalized_url] = x
+        for x in cnrs:
+            self.cnr_map[x['id']] = x
+            if 'repository' in x:
+                normalized_url = git_utils.normalize_url(x['repository'])
+                self.repo_cnr_map[normalized_url] = x
 
         # reload node status info from custom_nodes/*
         for custom_nodes_path in folder_paths.get_folder_paths('custom_nodes'):
@@ -771,7 +863,7 @@ class UnifiedManager:
                 if 'id' in x:
                     if x['id'] not in res:
                         res[x['id']] = (x, True)
-            except Exception:
+            except:
                 logging.error(f"[ComfyUI-Manager] broken item:{x}")
 
         return res
@@ -824,7 +916,7 @@ class UnifiedManager:
     def safe_version(ver_str):
         try:
             return version.parse(ver_str)
-        except Exception:
+        except:
             return version.parse("0.0.0")
 
     def execute_install_script(self, url, repo_path, instant_execution=False, lazy_mode=False, no_deps=False):
@@ -838,14 +930,15 @@ class UnifiedManager:
         else:
             if os.path.exists(requirements_path) and not no_deps:
                 print("Install: pip packages")
-                pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), context.comfy_path, context.manager_files_path)
+                pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, manager_files_path)
                 lines = manager_util.robust_readlines(requirements_path)
                 for line in lines:
                     package_name = remap_pip_package(line.strip())
                     if package_name and not package_name.startswith('#') and package_name not in self.processed_install:
                         self.processed_install.add(package_name)
-                        install_cmd = manager_util.make_pip_cmd(["install", package_name])
-                        if package_name.strip() != "" and not package_name.startswith('#'):
+                        clean_package_name = package_name.split('#')[0].strip()
+                        install_cmd = manager_util.make_pip_cmd(["install", clean_package_name])
+                        if clean_package_name != "" and not clean_package_name.startswith('#'):
                             res = res and try_install_script(url, repo_path, install_cmd, instant_execution=instant_execution)
 
                 pip_fixer.fix_broken()
@@ -859,7 +952,7 @@ class UnifiedManager:
         return res
 
     def reserve_cnr_switch(self, target, zip_url, from_path, to_path, no_deps):
-        script_path = os.path.join(context.manager_startup_script_path, "install-scripts.txt")
+        script_path = os.path.join(manager_startup_script_path, "install-scripts.txt")
         with open(script_path, "a") as file:
             obj = [target, "#LAZY-CNR-SWITCH-SCRIPT", zip_url, from_path, to_path, no_deps, get_default_custom_nodes_path(), sys.executable]
             file.write(f"{obj}\n")
@@ -1265,7 +1358,7 @@ class UnifiedManager:
             print(f"Download: git clone '{clone_url}'")
 
             if not instant_execution and platform.system() == 'Windows':
-                res = manager_funcs.run_script([sys.executable, context.git_script_path, "--clone", get_default_custom_nodes_path(), clone_url, repo_path], cwd=get_default_custom_nodes_path())
+                res = manager_funcs.run_script([sys.executable, git_script_path, "--clone", get_default_custom_nodes_path(), clone_url, repo_path], cwd=get_default_custom_nodes_path())
                 if res != 0:
                     return result.fail(f"Failed to clone repo: {clone_url}")
             else:
@@ -1418,20 +1511,12 @@ class UnifiedManager:
             return self.unified_enable(node_id, version_spec)
 
         elif version_spec == 'unknown' or version_spec == 'nightly':
-            to_path = os.path.abspath(os.path.join(get_default_custom_nodes_path(), node_id))
-
             if version_spec == 'nightly':
                 # disable cnr nodes
                 if self.is_enabled(node_id, 'cnr'):
                     self.unified_disable(node_id, False)
 
-                # use `repo name` as a dir name instead of `cnr id` if system added nodepack (i.e. publisher is null)
-                cnr = self.cnr_map.get(node_id)
-
-                if cnr is not None and cnr.get('publisher') is None:
-                    repo_name = os.path.basename(git_utils.normalize_url(repo_url))
-                    to_path = os.path.abspath(os.path.join(get_default_custom_nodes_path(), repo_name))
-
+            to_path = os.path.abspath(os.path.join(get_default_custom_nodes_path(), node_id))
             res = self.repo_install(repo_url, to_path, instant_execution=instant_execution, no_deps=no_deps, return_postinstall=return_postinstall)
             if res.result:
                 if version_spec == 'unknown':
@@ -1492,7 +1577,7 @@ def identify_node_pack_from_path(fullpath):
         if github_id is None:
             try:
                 github_id = os.path.basename(repo_url)
-            except Exception:
+            except:
                 logging.warning(f"[ComfyUI-Manager] unexpected repo url: {repo_url}")
                 github_id = module_name
 
@@ -1547,10 +1632,10 @@ def get_channel_dict():
     if channel_dict is None:
         channel_dict = {}
 
-        if not os.path.exists(context.manager_channel_list_path):
-            shutil.copy(context.channel_list_template_path, context.manager_channel_list_path)
+        if not os.path.exists(manager_channel_list_path):
+            shutil.copy(channel_list_template_path, manager_channel_list_path)
 
-        with open(context.manager_channel_list_path, 'r') as file:
+        with open(manager_channel_list_path, 'r') as file:
             channels = file.read()
             for x in channels.split('\n'):
                 channel_info = x.split("::")
@@ -1614,18 +1699,18 @@ def write_config():
         'db_mode': get_config()['db_mode'],
     }
 
-    directory = os.path.dirname(context.manager_config_path)
+    directory = os.path.dirname(manager_config_path)
     if not os.path.exists(directory):
         os.makedirs(directory)
 
-    with open(context.manager_config_path, 'w') as configfile:
+    with open(manager_config_path, 'w') as configfile:
         config.write(configfile)
 
 
 def read_config():
     try:
         config = configparser.ConfigParser(strict=False)
-        config.read(context.manager_config_path)
+        config.read(manager_config_path)
         default_conf = config['default']
 
         def get_bool(key, default_value):
@@ -1638,7 +1723,7 @@ def read_config():
                     'http_channel_enabled': get_bool('http_channel_enabled', False),
                     'preview_method': default_conf.get('preview_method', manager_funcs.get_current_preview_method()).lower(),
                     'git_exe': default_conf.get('git_exe', ''),
-                    'use_uv': get_bool('use_uv', True),
+                    'use_uv': get_bool('use_uv', False),
                     'channel_url': default_conf.get('channel_url', DEFAULT_CHANNEL),
                     'default_cache_as_channel_url': get_bool('default_cache_as_channel_url', False),
                     'share_option': default_conf.get('share_option', 'all').lower(),
@@ -1650,20 +1735,22 @@ def read_config():
                     'model_download_by_agent': get_bool('model_download_by_agent', False),
                     'downgrade_blacklist': default_conf.get('downgrade_blacklist', '').lower(),
                     'always_lazy_install': get_bool('always_lazy_install', False),
-                    'network_mode': default_conf.get('network_mode', NetworkMode.PUBLIC.value).lower(),
-                    'security_level': default_conf.get('security_level', SecurityLevel.NORMAL.value).lower(),
-                    'db_mode': default_conf.get('db_mode', DBMode.CACHE.value).lower(),
+                    'network_mode': default_conf.get('network_mode', 'public').lower(),
+                    'security_level': default_conf.get('security_level', 'normal').lower(),
+                    'db_mode': default_conf.get('db_mode', 'cache').lower(),
                }
 
     except Exception:
-        manager_util.use_uv = False
+        import importlib.util
+        # temporary disable `uv` on Windows by default (https://github.com/Comfy-Org/ComfyUI-Manager/issues/1969)
+        manager_util.use_uv = importlib.util.find_spec("uv") is not None and platform.system() != "Windows"
         manager_util.bypass_ssl = False
 
         return {
             'http_channel_enabled': False,
             'preview_method': manager_funcs.get_current_preview_method(),
             'git_exe': '',
-            'use_uv': True,
+            'use_uv': manager_util.use_uv,
             'channel_url': DEFAULT_CHANNEL,
             'default_cache_as_channel_url': False,
             'share_option': 'all',
@@ -1675,9 +1762,9 @@ def read_config():
             'model_download_by_agent': False,
             'downgrade_blacklist': '',
             'always_lazy_install': False,
-            'network_mode': NetworkMode.PUBLIC.value,
-            'security_level': SecurityLevel.NORMAL.value,
-            'db_mode': DBMode.CACHE.value,
+            'network_mode': 'public',   # public | private | offline
+            'security_level': 'normal', # strong | normal | normal- | weak
+            'db_mode': 'cache',         # local | cache | remote
         }
 
 
@@ -1721,27 +1808,27 @@ def switch_to_default_branch(repo):
         default_branch = repo.git.symbolic_ref(f'refs/remotes/{remote_name}/HEAD').replace(f'refs/remotes/{remote_name}/', '')
         repo.git.checkout(default_branch)
         return True
-    except Exception:
+    except:
         # try checkout master
         # try checkout main if failed
         try:
             repo.git.checkout(repo.heads.master)
             return True
-        except Exception:
+        except:
             try:
                 if remote_name is not None:
                     repo.git.checkout('-b', 'master', f'{remote_name}/master')
                     return True
-            except Exception:
+            except:
                 try:
                     repo.git.checkout(repo.heads.main)
                     return True
-                except Exception:
+                except:
                     try:
                         if remote_name is not None:
                             repo.git.checkout('-b', 'main', f'{remote_name}/main')
                             return True
-                    except Exception:
+                    except:
                         pass
 
     print("[ComfyUI Manager] Failed to switch to the default branch")
@@ -1749,10 +1836,10 @@ def switch_to_default_branch(repo):
 
 
 def reserve_script(repo_path, install_cmds):
-    if not os.path.exists(context.manager_startup_script_path):
-        os.makedirs(context.manager_startup_script_path)
+    if not os.path.exists(manager_startup_script_path):
+        os.makedirs(manager_startup_script_path)
 
-    script_path = os.path.join(context.manager_startup_script_path, "install-scripts.txt")
+    script_path = os.path.join(manager_startup_script_path, "install-scripts.txt")
     with open(script_path, "a") as file:
         obj = [repo_path] + install_cmds
         file.write(f"{obj}\n")
@@ -1792,7 +1879,7 @@ def try_install_script(url, repo_path, install_cmd, instant_execution=False):
                     print(f"[WARN] ComfyUI-Manager: Your ComfyUI version ({comfy_ui_revision})[{comfy_ui_commit_datetime.date()}] is too old. Please update to the latest version.")
                     print("[WARN] The extension installation feature may not work properly in the current installed ComfyUI version on Windows environment.")
                     print("###################################################################\n\n")
-            except Exception:
+            except:
                 pass
 
         if code != 0:
@@ -1807,11 +1894,11 @@ def try_install_script(url, repo_path, install_cmd, instant_execution=False):
 # use subprocess to avoid file system lock by git (Windows)
 def __win_check_git_update(path, do_fetch=False, do_update=False):
     if do_fetch:
-        command = [sys.executable, context.git_script_path, "--fetch", path]
+        command = [sys.executable, git_script_path, "--fetch", path]
     elif do_update:
-        command = [sys.executable, context.git_script_path, "--pull", path]
+        command = [sys.executable, git_script_path, "--pull", path]
     else:
-        command = [sys.executable, context.git_script_path, "--check", path]
+        command = [sys.executable, git_script_path, "--check", path]
 
     new_env = get_script_env()
     process = subprocess.Popen(command, stdout=subprocess.PIPE, stderr=subprocess.PIPE, cwd=get_default_custom_nodes_path(), env=new_env)
@@ -1865,7 +1952,7 @@ def __win_check_git_update(path, do_fetch=False, do_update=False):
 
 
 def __win_check_git_pull(path):
-    command = [sys.executable, context.git_script_path, "--pull", path]
+    command = [sys.executable, git_script_path, "--pull", path]
     process = subprocess.Popen(command, env=get_script_env(), cwd=get_default_custom_nodes_path())
     process.wait()
 
@@ -1881,7 +1968,7 @@ def execute_install_script(url, repo_path, lazy_mode=False, instant_execution=Fa
     else:
         if os.path.exists(requirements_path) and not no_deps:
             print("Install: pip packages")
-            pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), context.comfy_path, context.manager_files_path)
+            pip_fixer = manager_util.PIPFixer(manager_util.get_installed_packages(), comfy_path, manager_files_path)
             with open(requirements_path, "r") as requirements_file:
                 for line in requirements_file:
                     #handle comments
@@ -2061,6 +2148,13 @@ def is_valid_url(url):
     return False
 
 
+def extract_url_and_commit_id(s):
+    index = s.rfind('@')
+    if index == -1:
+        return (s, '')
+    else:
+        return (s[:index], s[index+1:])
+
 async def gitclone_install(url, instant_execution=False, msg_prefix='', no_deps=False):
     await unified_manager.reload('cache')
     await unified_manager.get_custom_nodes('default', 'cache')
@@ -2078,8 +2172,11 @@ async def gitclone_install(url, instant_execution=False, msg_prefix='', no_deps=
         cnr = unified_manager.get_cnr_by_repo(url)
         if cnr:
             cnr_id = cnr['id']
-            return await unified_manager.install_by_id(cnr_id, version_spec='nightly', channel='default', mode='cache')
+            return await unified_manager.install_by_id(cnr_id, version_spec=None, channel='default', mode='cache')
         else:
+            new_url, commit_id = extract_url_and_commit_id(url)
+            if commit_id != "":
+                url = new_url
             repo_name = os.path.splitext(os.path.basename(url))[0]
 
             # NOTE: Keep original name as possible if unknown node
@@ -2107,11 +2204,15 @@ async def gitclone_install(url, instant_execution=False, msg_prefix='', no_deps=
             clone_url = git_utils.get_url_for_clone(url)
 
             if not instant_execution and platform.system() == 'Windows':
-                res = manager_funcs.run_script([sys.executable, context.git_script_path, "--clone", get_default_custom_nodes_path(), clone_url, repo_path], cwd=get_default_custom_nodes_path())
+                res = manager_funcs.run_script([sys.executable, git_script_path, "--clone", get_default_custom_nodes_path(), clone_url, repo_path], cwd=get_default_custom_nodes_path())
                 if res != 0:
                     return result.fail(f"Failed to clone '{clone_url}' into  '{repo_path}'")
             else:
                 repo = git.Repo.clone_from(clone_url, repo_path, recursive=True, progress=GitProgress())
+                if commit_id!= "":
+                    repo.git.checkout(commit_id)
+                    repo.git.submodule('update', '--init', '--recursive')
+
                 repo.git.clear_cache()
                 repo.close()
 
@@ -2174,7 +2275,7 @@ async def get_data_by_mode(mode, filename, channel_url=None):
             cache_uri = str(manager_util.simple_hash(uri))+'_'+filename
             cache_uri = os.path.join(manager_util.cache_dir, cache_uri)
 
-            if get_config()['network_mode'] == 'offline' or manager_util.is_manager_pip_package():
+            if get_config()['network_mode'] == 'offline':
                 # offline network mode
                 if os.path.exists(cache_uri):
                     json_obj = await manager_util.get_data(cache_uri)
@@ -2194,7 +2295,7 @@ async def get_data_by_mode(mode, filename, channel_url=None):
                         with open(cache_uri, "w", encoding='utf-8') as file:
                             json.dump(json_obj, file, indent=4, sort_keys=True)
     except Exception as e:
-        print(f"[ComfyUI-Manager] Due to a network error, switching to local mode.\n=> {filename} @ {channel_url}/{mode}\n=> {e}")
+        print(f"[ComfyUI-Manager] Due to a network error, switching to local mode.\n=> {filename}\n=> {e}")
         uri = os.path.join(manager_util.comfyui_manager_path, filename)
         json_obj = await manager_util.get_data(uri)
 
@@ -2265,7 +2366,7 @@ def gitclone_uninstall(files):
             url = url[:-1]
         try:
             for custom_nodes_dir in get_custom_nodes_paths():
-                dir_name:str = os.path.splitext(os.path.basename(url))[0].replace(".git", "")
+                dir_name = os.path.splitext(os.path.basename(url))[0].replace(".git", "")
                 dir_path = os.path.join(custom_nodes_dir, dir_name)
 
                 # safety check
@@ -2313,7 +2414,7 @@ def gitclone_set_active(files, is_disable):
             url = url[:-1]
         try:
             for custom_nodes_dir in get_custom_nodes_paths():
-                dir_name:str = os.path.splitext(os.path.basename(url))[0].replace(".git", "")
+                dir_name = os.path.splitext(os.path.basename(url))[0].replace(".git", "")
                 dir_path = os.path.join(custom_nodes_dir, dir_name)
 
                 # safety check
@@ -2410,7 +2511,7 @@ def update_to_stable_comfyui(repo_path):
         repo = git.Repo(repo_path)
         try:
             repo.git.checkout(repo.heads.master)
-        except Exception:
+        except:
             logging.error(f"[ComfyUI-Manager] Failed to checkout 'master' branch.\nrepo_path={repo_path}\nAvailable branches:")
             for branch in repo.branches:
                 logging.error('\t'+branch.name)
@@ -2433,7 +2534,7 @@ def update_to_stable_comfyui(repo_path):
             logging.info(f"[ComfyUI-Manager] Updating ComfyUI: {current_tag} -> {latest_tag}")
             repo.git.checkout(latest_tag)
             return 'updated', latest_tag
-    except Exception:
+    except:
         traceback.print_exc()
         return "fail", None
             
@@ -2586,7 +2687,7 @@ async def get_current_snapshot(custom_nodes_only = False):
     await unified_manager.get_custom_nodes('default', 'cache')
 
     # Get ComfyUI hash
-    repo_path = context.comfy_path
+    repo_path = comfy_path
 
     comfyui_commit_hash = None
     if not custom_nodes_only:
@@ -2631,7 +2732,7 @@ async def get_current_snapshot(custom_nodes_only = False):
                         commit_hash = git_utils.get_commit_hash(fullpath)
                         url = git_utils.git_url(fullpath)
                         git_custom_nodes[url] = dict(hash=commit_hash, disabled=is_disabled)
-                except Exception:
+                except:
                     print(f"Failed to extract snapshots for the custom node '{path}'.")
 
             elif path.endswith('.py'):
@@ -2662,7 +2763,7 @@ async def save_snapshot_with_postfix(postfix, path=None, custom_nodes_only = Fal
         date_time_format = now.strftime("%Y-%m-%d_%H-%M-%S")
         file_name = f"{date_time_format}_{postfix}"
 
-        path = os.path.join(context.manager_snapshot_path, f"{file_name}.json")
+        path = os.path.join(manager_snapshot_path, f"{file_name}.json")
     else:
         file_name = path.replace('\\', '/').split('/')[-1]
         file_name = file_name.split('.')[-2]
@@ -2689,7 +2790,7 @@ async def extract_nodes_from_workflow(filepath, mode='local', channel_url='defau
         with open(filepath, "r", encoding="UTF-8", errors="ignore") as json_file:
             try:
                 workflow = json.load(json_file)
-            except Exception:
+            except:
                 print(f"Invalid workflow file: {filepath}")
                 exit(-1)
 
@@ -2702,7 +2803,7 @@ async def extract_nodes_from_workflow(filepath, mode='local', channel_url='defau
             else:
                 try:
                     workflow = json.loads(img.info['workflow'])
-                except Exception:
+                except:
                     print(f"This is not a valid .png file containing a ComfyUI workflow: {filepath}")
                     exit(-1)
 
@@ -2973,7 +3074,7 @@ def populate_github_stats(node_packs, json_obj_github):
                 v['stars'] = -1
                 v['last_update'] = -1
                 v['trust'] = False
-        except Exception:
+        except:
             logging.error(f"[ComfyUI-Manager] DB item is broken:\n{v}")
 
 
@@ -3251,12 +3352,12 @@ async def restore_snapshot(snapshot_path, git_helper_extras=None):
 
 def get_comfyui_versions(repo=None):
     if repo is None:
-        repo = git.Repo(context.comfy_path)
+        repo = git.Repo(comfy_path)
 
     try:
         remote = get_remote_name(repo)   
         repo.remotes[remote].fetch()    
-    except Exception:
+    except:
         logging.error("[ComfyUI-Manager] Failed to fetch ComfyUI")
 
     versions = [x.name for x in repo.tags if x.name.startswith('v')]
@@ -3285,7 +3386,7 @@ def get_comfyui_versions(repo=None):
 
 
 def switch_comfyui(tag):
-    repo = git.Repo(context.comfy_path)
+    repo = git.Repo(comfy_path)
 
     if tag == 'nightly':
         repo.git.checkout('master')
@@ -3325,5 +3426,5 @@ def repo_switch_commit(repo_path, commit_hash):
 
         repo.git.checkout(commit_hash)
         return True
-    except Exception:
+    except:
         return None

glob/manager_util.py

@@ -15,10 +15,10 @@ import re
 import logging
 import platform
 import shlex
+from functools import lru_cache
 
 
 cache_lock = threading.Lock()
-session_lock = threading.Lock()
 
 comfyui_manager_path = os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))
 cache_dir = os.path.join(comfyui_manager_path, '.cache')  # This path is also updated together in **manager_core.update_user_directory**.
@@ -26,9 +26,6 @@ cache_dir = os.path.join(comfyui_manager_path, '.cache')  # This path is also up
 use_uv = False
 bypass_ssl = False
 
-def is_manager_pip_package():
-    return not os.path.exists(os.path.join(comfyui_manager_path, '..', 'custom_nodes'))
-
 def add_python_path_to_env():
     if platform.system() != "Windows":
         sep = ':'
@@ -38,23 +35,69 @@ def add_python_path_to_env():
     os.environ['PATH'] = os.path.dirname(sys.executable)+sep+os.environ['PATH']
 
 
+@lru_cache(maxsize=2)
+def get_pip_cmd(force_uv=False):
+    """
+    Get the base pip command, with automatic fallback to uv if pip is unavailable.
+
+    Args:
+        force_uv (bool): If True, use uv directly without trying pip
+
+    Returns:
+        list: Base command for pip operations
+    """
+    embedded = 'python_embeded' in sys.executable
+
+    # Try pip first (unless forcing uv)
+    if not force_uv:
+        try:
+            test_cmd = [sys.executable] + (['-s'] if embedded else []) + ['-m', 'pip', '--version']
+            subprocess.check_output(test_cmd, stderr=subprocess.DEVNULL, timeout=5)
+            return [sys.executable] + (['-s'] if embedded else []) + ['-m', 'pip']
+        except Exception:
+            logging.warning("[ComfyUI-Manager] python -m pip not available. Falling back to uv.")
+
+    # Try uv (either forced or pip failed)
+    import shutil
+
+    # Try uv as Python module
+    try:
+        test_cmd = [sys.executable] + (['-s'] if embedded else []) + ['-m', 'uv', '--version']
+        subprocess.check_output(test_cmd, stderr=subprocess.DEVNULL, timeout=5)
+        logging.info("[ComfyUI-Manager] Using uv as Python module for pip operations.")
+        return [sys.executable] + (['-s'] if embedded else []) + ['-m', 'uv', 'pip']
+    except Exception:
+        pass
+
+    # Try standalone uv
+    if shutil.which('uv'):
+        logging.info("[ComfyUI-Manager] Using standalone uv for pip operations.")
+        return ['uv', 'pip']
+
+    # Nothing worked
+    logging.error("[ComfyUI-Manager] Neither python -m pip nor uv are available. Cannot proceed with package operations.")
+    raise Exception("Neither pip nor uv are available for package management")
+
+
 def make_pip_cmd(cmd):
-    if 'python_embeded' in sys.executable:
-        if use_uv:
-            return [sys.executable, '-s', '-m', 'uv', 'pip'] + cmd
-        else:
-            return [sys.executable, '-s', '-m', 'pip'] + cmd
-    else:
-        # FIXED: https://github.com/ltdrdata/ComfyUI-Manager/issues/1667
-        if use_uv:
-            return [sys.executable, '-m', 'uv', 'pip'] + cmd
-        else:
-            return [sys.executable, '-m', 'pip'] + cmd
+    """
+    Create a pip command by combining the cached base pip command with the given arguments.
+
+    Args:
+        cmd (list): List of pip command arguments (e.g., ['install', 'package'])
+
+    Returns:
+        list: Complete command list ready for subprocess execution
+    """
+    global use_uv
+    base_cmd = get_pip_cmd(force_uv=use_uv)
+    return base_cmd + cmd
+
 
 # DON'T USE StrictVersion - cannot handle pre_release version
 # try:
 #     from distutils.version import StrictVersion
-# except Exception:
+# except:
 #     print(f"[ComfyUI-Manager]  'distutils' package not found. Activating fallback mode for compatibility.")
 class StrictVersion:
     def __init__(self, version_string):
@@ -509,7 +552,7 @@ def robust_readlines(fullpath):
     try:
         with open(fullpath, "r") as f:
             return f.readlines()
-    except Exception:
+    except:
         encoding = None
         with open(fullpath, "rb") as f:
             raw_data = f.read()

glob/node_package.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from dataclasses import dataclass
 import os
 
-from .git_utils import get_commit_hash
+from git_utils import get_commit_hash
 
 
 @dataclass

glob/security_check.py

@@ -2,7 +2,7 @@ import sys
 import subprocess
 import os
 
-from . import manager_util
+import manager_util
 
 
 def security_check():

glob/share_3rdparty.py

@@ -1,7 +1,5 @@
 import mimetypes
-from ..common import context
-from . import manager_core as core
-
+import manager_core as core
 import os
 from aiohttp import web
 import aiohttp
@@ -10,16 +8,6 @@ import hashlib
 
 import folder_paths
 from server import PromptServer
-import logging
-import sys
-
-
-try:
-    from nio import AsyncClient, LoginResponse, UploadResponse
-    matrix_nio_is_available = True
-except Exception:
-    logging.warning(f"[ComfyUI-Manager] The matrix sharing feature has been disabled because the `matrix-nio` dependency is not installed.\n\tTo use this feature, please run the following command:\n\t{sys.executable} -m pip install matrix-nio\n")
-    matrix_nio_is_available = False
 
 
 def extract_model_file_names(json_data):
@@ -65,7 +53,7 @@ def compute_sha256_checksum(filepath):
     return sha256.hexdigest()
 
 
-@PromptServer.instance.routes.get("/v2/manager/share_option")
+@PromptServer.instance.routes.get("/manager/share_option")
 async def share_option(request):
     if "value" in request.rel_url.query:
         core.get_config()['share_option'] = request.rel_url.query['value']
@@ -77,21 +65,21 @@ async def share_option(request):
 
 
 def get_openart_auth():
-    if not os.path.exists(os.path.join(context.manager_files_path, ".openart_key")):
+    if not os.path.exists(os.path.join(core.manager_files_path, ".openart_key")):
         return None
     try:
-        with open(os.path.join(context.manager_files_path, ".openart_key"), "r") as f:
+        with open(os.path.join(core.manager_files_path, ".openart_key"), "r") as f:
             openart_key = f.read().strip()
         return openart_key if openart_key else None
-    except Exception:
+    except:
         return None
 
 
 def get_matrix_auth():
-    if not os.path.exists(os.path.join(context.manager_files_path, "matrix_auth")):
+    if not os.path.exists(os.path.join(core.manager_files_path, "matrix_auth")):
         return None
     try:
-        with open(os.path.join(context.manager_files_path, "matrix_auth"), "r") as f:
+        with open(os.path.join(core.manager_files_path, "matrix_auth"), "r") as f:
             matrix_auth = f.read()
             homeserver, username, password = matrix_auth.strip().split("\n")
             if not homeserver or not username or not password:
@@ -101,40 +89,40 @@ def get_matrix_auth():
             "username": username,
             "password": password,
         }
-    except Exception:
+    except:
         return None
 
 
 def get_comfyworkflows_auth():
-    if not os.path.exists(os.path.join(context.manager_files_path, "comfyworkflows_sharekey")):
+    if not os.path.exists(os.path.join(core.manager_files_path, "comfyworkflows_sharekey")):
         return None
     try:
-        with open(os.path.join(context.manager_files_path, "comfyworkflows_sharekey"), "r") as f:
+        with open(os.path.join(core.manager_files_path, "comfyworkflows_sharekey"), "r") as f:
             share_key = f.read()
             if not share_key.strip():
                 return None
         return share_key
-    except Exception:
+    except:
         return None
 
 
 def get_youml_settings():
-    if not os.path.exists(os.path.join(context.manager_files_path, ".youml")):
+    if not os.path.exists(os.path.join(core.manager_files_path, ".youml")):
         return None
     try:
-        with open(os.path.join(context.manager_files_path, ".youml"), "r") as f:
+        with open(os.path.join(core.manager_files_path, ".youml"), "r") as f:
             youml_settings = f.read().strip()
         return youml_settings if youml_settings else None
-    except Exception:
+    except:
         return None
 
 
 def set_youml_settings(settings):
-    with open(os.path.join(context.manager_files_path, ".youml"), "w") as f:
+    with open(os.path.join(core.manager_files_path, ".youml"), "w") as f:
         f.write(settings)
 
 
-@PromptServer.instance.routes.get("/v2/manager/get_openart_auth")
+@PromptServer.instance.routes.get("/manager/get_openart_auth")
 async def api_get_openart_auth(request):
     # print("Getting stored Matrix credentials...")
     openart_key = get_openart_auth()
@@ -143,16 +131,16 @@ async def api_get_openart_auth(request):
     return web.json_response({"openart_key": openart_key})
 
 
-@PromptServer.instance.routes.post("/v2/manager/set_openart_auth")
+@PromptServer.instance.routes.post("/manager/set_openart_auth")
 async def api_set_openart_auth(request):
     json_data = await request.json()
     openart_key = json_data['openart_key']
-    with open(os.path.join(context.manager_files_path, ".openart_key"), "w") as f:
+    with open(os.path.join(core.manager_files_path, ".openart_key"), "w") as f:
         f.write(openart_key)
     return web.Response(status=200)
 
 
-@PromptServer.instance.routes.get("/v2/manager/get_matrix_auth")
+@PromptServer.instance.routes.get("/manager/get_matrix_auth")
 async def api_get_matrix_auth(request):
     # print("Getting stored Matrix credentials...")
     matrix_auth = get_matrix_auth()
@@ -161,7 +149,7 @@ async def api_get_matrix_auth(request):
     return web.json_response(matrix_auth)
 
 
-@PromptServer.instance.routes.get("/v2/manager/youml/settings")
+@PromptServer.instance.routes.get("/manager/youml/settings")
 async def api_get_youml_settings(request):
     youml_settings = get_youml_settings()
     if not youml_settings:
@@ -169,14 +157,14 @@ async def api_get_youml_settings(request):
     return web.json_response(json.loads(youml_settings))
 
 
-@PromptServer.instance.routes.post("/v2/manager/youml/settings")
+@PromptServer.instance.routes.post("/manager/youml/settings")
 async def api_set_youml_settings(request):
     json_data = await request.json()
     set_youml_settings(json.dumps(json_data))
     return web.Response(status=200)
 
 
-@PromptServer.instance.routes.get("/v2/manager/get_comfyworkflows_auth")
+@PromptServer.instance.routes.get("/manager/get_comfyworkflows_auth")
 async def api_get_comfyworkflows_auth(request):
     # Check if the user has provided Matrix credentials in a file called 'matrix_accesstoken'
     # in the same directory as the ComfyUI base folder
@@ -187,39 +175,31 @@ async def api_get_comfyworkflows_auth(request):
     return web.json_response({"comfyworkflows_sharekey": comfyworkflows_auth})
 
 
-@PromptServer.instance.routes.post("/v2/manager/set_esheep_workflow_and_images")
+@PromptServer.instance.routes.post("/manager/set_esheep_workflow_and_images")
 async def set_esheep_workflow_and_images(request):
     json_data = await request.json()
-    with open(os.path.join(context.manager_files_path, "esheep_share_message.json"), "w", encoding='utf-8') as file:
+    with open(os.path.join(core.manager_files_path, "esheep_share_message.json"), "w", encoding='utf-8') as file:
         json.dump(json_data, file, indent=4)
         return web.Response(status=200)
 
 
-@PromptServer.instance.routes.get("/v2/manager/get_esheep_workflow_and_images")
+@PromptServer.instance.routes.get("/manager/get_esheep_workflow_and_images")
 async def get_esheep_workflow_and_images(request):
-    with open(os.path.join(context.manager_files_path, "esheep_share_message.json"), 'r', encoding='utf-8') as file:
+    with open(os.path.join(core.manager_files_path, "esheep_share_message.json"), 'r', encoding='utf-8') as file:
         data = json.load(file)
         return web.Response(status=200, text=json.dumps(data))
 
 
-@PromptServer.instance.routes.get("/v2/manager/get_matrix_dep_status")
-async def get_matrix_dep_status(request):
-    if matrix_nio_is_available:
-        return web.Response(status=200, text='available')
-    else:
-        return web.Response(status=200, text='unavailable')
-
-
 def set_matrix_auth(json_data):
     homeserver = json_data['homeserver']
     username = json_data['username']
     password = json_data['password']
-    with open(os.path.join(context.manager_files_path, "matrix_auth"), "w") as f:
+    with open(os.path.join(core.manager_files_path, "matrix_auth"), "w") as f:
         f.write("\n".join([homeserver, username, password]))
 
 
 def set_comfyworkflows_auth(comfyworkflows_sharekey):
-    with open(os.path.join(context.manager_files_path, "comfyworkflows_sharekey"), "w") as f:
+    with open(os.path.join(core.manager_files_path, "comfyworkflows_sharekey"), "w") as f:
         f.write(comfyworkflows_sharekey)
 
 
@@ -231,7 +211,7 @@ def has_provided_comfyworkflows_auth(comfyworkflows_sharekey):
     return comfyworkflows_sharekey.strip()
 
 
-@PromptServer.instance.routes.post("/v2/manager/share")
+@PromptServer.instance.routes.post("/manager/share")
 async def share_art(request):
     # get json data
     json_data = await request.json()
@@ -253,7 +233,7 @@ async def share_art(request):
 
     try:
         output_to_share = potential_outputs[int(selected_output_index)]
-    except Exception:
+    except:
         # for now, pick the first output
         output_to_share = potential_outputs[0]
 
@@ -349,12 +329,14 @@ async def share_art(request):
                 workflowId = upload_workflow_json["workflowId"]
 
     # check if the user has provided Matrix credentials
-    if matrix_nio_is_available and "matrix" in share_destinations:
+    if "matrix" in share_destinations:
         comfyui_share_room_id = '!LGYSoacpJPhIfBqVfb:matrix.org'
         filename = os.path.basename(asset_filepath)
         content_type = assetFileType
 
         try:
+            from nio import AsyncClient, LoginResponse, UploadResponse
+
             homeserver = 'matrix.org'
             if matrix_auth:
                 homeserver = matrix_auth.get('homeserver', 'matrix.org')

js/README.md

@@ -13,7 +13,7 @@ This directory contains the JavaScript frontend implementation for ComfyUI-Manag
 ## Sharing Components
 
 - **comfyui-share-common.js**: Base functionality for workflow sharing features.
-- **comfyui-share-copus.js**: Integration with the ComfyUI Opus sharing platform.
+- **comfyui-share-copus.js**: Integration with the ComfyUI Copus sharing platform.
 - **comfyui-share-openart.js**: Integration with the OpenArt sharing platform.
 - **comfyui-share-youml.js**: Integration with the YouML sharing platform.
 
@@ -47,4 +47,4 @@ CSS files are included for specific components:
 - **custom-nodes-manager.css**: Styling for the node management UI
 - **model-manager.css**: Styling for the model management UI
 
-This frontend implementation provides a comprehensive yet user-friendly interface for managing the ComfyUI ecosystem.
+This frontend implementation provides a comprehensive yet user-friendly interface for managing the ComfyUI ecosystem.

js/cm-api.js

@@ -25,7 +25,7 @@ async function tryInstallCustomNode(event) {
 	const res = await customConfirm(msg);
 	if(res) {
 		if(event.detail.target.installed == 'Disabled') {
-			const response = await api.fetchApi(`/v2/customnode/toggle_active`, {
+			const response = await api.fetchApi(`/customnode/toggle_active`, {
 										method: 'POST',
 										headers: { 'Content-Type': 'application/json' },
 										body: JSON.stringify(event.detail.target)
@@ -35,7 +35,7 @@ async function tryInstallCustomNode(event) {
 			await sleep(300);
 			app.ui.dialog.show(`Installing... '${event.detail.target.title}'`);
 
-			const response = await api.fetchApi(`/v2/customnode/install`, {
+			const response = await api.fetchApi(`/customnode/install`, {
 										method: 'POST',
 										headers: { 'Content-Type': 'application/json' },
 										body: JSON.stringify(event.detail.target)
@@ -52,7 +52,7 @@ async function tryInstallCustomNode(event) {
 			}
 		}
 
-		let response = await api.fetchApi("/v2/manager/reboot");
+		let response = await api.fetchApi("/manager/reboot");
 		if(response.status == 403) {
 			show_message('This action is not allowed with this security level configuration.');
 			return false;

js/comfyui-manager.js

@@ -14,9 +14,9 @@ import { OpenArtShareDialog } from "./comfyui-share-openart.js";
 import {
 	free_models, install_pip, install_via_git_url, manager_instance,
 	rebootAPI, setManagerInstance, show_message, customAlert, customPrompt,
-	infoToast, showTerminal, setNeedRestart, generateUUID
+	infoToast, showTerminal, setNeedRestart
 } from "./common.js";
-import { ComponentBuilderDialog, load_components, set_component_policy } from "./components-manager.js";
+import { ComponentBuilderDialog, getPureName, load_components, set_component_policy } from "./components-manager.js";
 import { CustomNodesManager } from "./custom-nodes-manager.js";
 import { ModelManager } from "./model-manager.js";
 import { SnapshotManager } from "./snapshot.js";
@@ -189,7 +189,8 @@ docStyle.innerHTML = `
 }
 `;
 
-function isBeforeFrontendVersion(compareVersion) {
+function is_legacy_front() {
+    let compareVersion = '1.2.49';
     try {
         const frontendVersion = window['__COMFYUI_FRONTEND_VERSION__'];
         if (typeof frontendVersion !== 'string') {
@@ -231,7 +232,7 @@ var restart_stop_button = null;
 var update_policy_combo = null;
 
 let share_option = 'all';
-var batch_id = null;
+var is_updating = false;
 
 
 // copied style from https://github.com/pythongosssss/ComfyUI-Custom-Scripts
@@ -414,7 +415,7 @@ const style = `
 `;
 
 async function init_share_option() {
-	api.fetchApi('/v2/manager/share_option')
+	api.fetchApi('/manager/share_option')
 		.then(response => response.text())
 		.then(data => {
 			share_option = data || 'all';
@@ -422,7 +423,7 @@ async function init_share_option() {
 }
 
 async function init_notice(notice) {
-	api.fetchApi('/v2/manager/notice')
+	api.fetchApi('/manager/notice')
 		.then(response => response.text())
 		.then(data => {
 			notice.innerHTML = data;
@@ -473,19 +474,14 @@ async function updateComfyUI() {
 	let prev_text = update_comfyui_button.innerText;
 	update_comfyui_button.innerText = "Updating ComfyUI...";
 
-//	set_inprogress_mode();
+	set_inprogress_mode();
+
+	const response = await api.fetchApi('/manager/queue/update_comfyui');
+
 	showTerminal();
 
-	batch_id = generateUUID();
-
-	let batch = {};
-	batch['batch_id'] = batch_id;
-	batch['update_comfyui'] = true;
-
-	const res = await api.fetchApi(`/v2/manager/queue/batch`, {
-		method: 'POST',
-		body: JSON.stringify(batch)
-	});
+	is_updating = true;
+	await api.fetchApi('/manager/queue/start');
 }
 
 function showVersionSelectorDialog(versions, current, onSelect) {
@@ -616,7 +612,7 @@ async function switchComfyUI() {
 	switch_comfyui_button.disabled = true;
 	switch_comfyui_button.style.backgroundColor = "gray";
 	
-	let res = await api.fetchApi(`/v2/comfyui_manager/comfyui_versions`, { cache: "no-store" });
+	let res = await api.fetchApi(`/comfyui_manager/comfyui_versions`, { cache: "no-store" });
 
 	switch_comfyui_button.disabled = false;
 	switch_comfyui_button.style.backgroundColor = "";
@@ -635,14 +631,14 @@ async function switchComfyUI() {
 		showVersionSelectorDialog(versions, obj.current, async (selected_version) => {
 			if(selected_version == 'nightly') {
 				update_policy_combo.value = 'nightly-comfyui';
-				api.fetchApi('/v2/manager/policy/update?value=nightly-comfyui');
+				api.fetchApi('/manager/policy/update?value=nightly-comfyui');
 			}
 			else {
 				update_policy_combo.value = 'stable-comfyui';
-				api.fetchApi('/v2/manager/policy/update?value=stable-comfyui');
+				api.fetchApi('/manager/policy/update?value=stable-comfyui');
 			}
 
-			let response = await api.fetchApi(`/v2/comfyui_manager/comfyui_switch_version?ver=${selected_version}`, { cache: "no-store" });
+			let response = await api.fetchApi(`/comfyui_manager/comfyui_switch_version?ver=${selected_version}`, { cache: "no-store" });
 			if (response.status == 200) {
 				infoToast(`ComfyUI version is switched to ${selected_version}`);
 			}
@@ -660,17 +656,18 @@ async function onQueueStatus(event) {
 	const isElectron = 'electronAPI' in window;
 
 	if(event.detail.status == 'in_progress') {
-//		set_inprogress_mode();
+		set_inprogress_mode();
 		update_all_button.innerText = `in progress.. (${event.detail.done_count}/${event.detail.total_count})`;
 	}
-	else if(event.detail.status == 'all-done') {
+	else if(event.detail.status == 'done') {
 		reset_action_buttons();
-	}
-	else if(event.detail.status == 'batch-done') {
-		if(batch_id != event.detail.batch_id) {
+
+		if(!is_updating)  {
 			return;
 		}
 
+		is_updating = false;
+
 		let success_list = [];
 		let failed_list = [];
 		let comfyui_state = null;
@@ -770,28 +767,41 @@ api.addEventListener("cm-queue-status", onQueueStatus);
 async function updateAll(update_comfyui) {
 	update_all_button.innerText = "Updating...";
 
-//	set_inprogress_mode();
+	set_inprogress_mode();
 
 	var mode = manager_instance.datasrc_combo.value;
 
 	showTerminal();
 
-	batch_id = generateUUID();
-
-	let batch = {};
 	if(update_comfyui) {
 		update_all_button.innerText = "Updating ComfyUI...";
-		batch['update_comfyui'] = true;
+		await api.fetchApi('/manager/queue/update_comfyui');
 	}
 
-	batch['update_all'] = mode;
+	const response = await api.fetchApi(`/manager/queue/update_all?mode=${mode}`);
 
-	const res = await api.fetchApi(`/v2/manager/queue/batch`, {
-		method: 'POST',
-		body: JSON.stringify(batch)
-	});
+	if (response.status == 401) {
+		customAlert('Another task is already in progress. Please stop the ongoing task first.');
+	}
+	else if(response.status == 200) {
+		is_updating = true;
+		await api.fetchApi('/manager/queue/start');
+	}
 }
 
+function newDOMTokenList(initialTokens) {
+	const tmp = document.createElement(`div`);
+
+	const classList = tmp.classList;
+	if (initialTokens) {
+		initialTokens.forEach(token => {
+		classList.add(token);
+		});
+	}
+
+	return classList;
+	}
+
 /**
  * Check whether the node is a potential output node (img, gif or video output)
  */
@@ -804,7 +814,7 @@ function restartOrStop() {
 		rebootAPI();
 	}
 	else {
-		api.fetchApi('/v2/manager/queue/reset');
+		api.fetchApi('/manager/queue/reset');
 		infoToast('Cancel', 'Remaining tasks will stop after completing the current task.');
 	}
 }
@@ -952,12 +962,12 @@ class ManagerMenuDialog extends ComfyDialog {
 		this.datasrc_combo.appendChild($el('option', { value: 'local', text: 'DB: Local' }, []));
 		this.datasrc_combo.appendChild($el('option', { value: 'remote', text: 'DB: Channel (remote)' }, []));
 
-		api.fetchApi('/v2/manager/db_mode')
+		api.fetchApi('/manager/db_mode')
 			.then(response => response.text())
 			.then(data => { this.datasrc_combo.value = data; });
 
 		this.datasrc_combo.addEventListener('change', function (event) {
-			api.fetchApi(`/v2/manager/db_mode?value=${event.target.value}`);
+			api.fetchApi(`/manager/db_mode?value=${event.target.value}`);
 		});
 
 		// preview method
@@ -969,19 +979,19 @@ class ManagerMenuDialog extends ComfyDialog {
 		preview_combo.appendChild($el('option', { value: 'latent2rgb', text: 'Preview method: Latent2RGB (fast)' }, []));
 		preview_combo.appendChild($el('option', { value: 'none', text: 'Preview method: None (very fast)' }, []));
 
-		api.fetchApi('/v2/manager/preview_method')
+		api.fetchApi('/manager/preview_method')
 			.then(response => response.text())
 			.then(data => { preview_combo.value = data; });
 
 		preview_combo.addEventListener('change', function (event) {
-			api.fetchApi(`/v2/manager/preview_method?value=${event.target.value}`);
+			api.fetchApi(`/manager/preview_method?value=${event.target.value}`);
 		});
 
 		// channel
 		let channel_combo = document.createElement("select");
 		channel_combo.setAttribute("title", "Configure the channel for retrieving data from the Custom Node list (including missing nodes) or the Model list.");
 		channel_combo.className = "cm-menu-combo";
-		api.fetchApi('/v2/manager/channel_url_list')
+		api.fetchApi('/manager/channel_url_list')
 			.then(response => response.json())
 			.then(async data => {
 				try {
@@ -994,7 +1004,7 @@ class ManagerMenuDialog extends ComfyDialog {
 					}
 
 					channel_combo.addEventListener('change', function (event) {
-						api.fetchApi(`/v2/manager/channel_url_list?value=${event.target.value}`);
+						api.fetchApi(`/manager/channel_url_list?value=${event.target.value}`);
 					});
 
 					channel_combo.value = data.selected;
@@ -1022,7 +1032,7 @@ class ManagerMenuDialog extends ComfyDialog {
 			share_combo.appendChild($el('option', { value: option[0], text: `Share: ${option[1]}` }, []));
 		}
 
-		api.fetchApi('/v2/manager/share_option')
+		api.fetchApi('/manager/share_option')
 			.then(response => response.text())
 			.then(data => {
 				share_combo.value = data || 'all';
@@ -1032,7 +1042,7 @@ class ManagerMenuDialog extends ComfyDialog {
 		share_combo.addEventListener('change', function (event) {
 			const value = event.target.value;
 			share_option = value;
-			api.fetchApi(`/v2/manager/share_option?value=${value}`);
+			api.fetchApi(`/manager/share_option?value=${value}`);
 			const shareButton = document.getElementById("shareButton");
 			if (value === 'none') {
 				shareButton.style.display = "none";
@@ -1047,7 +1057,7 @@ class ManagerMenuDialog extends ComfyDialog {
 		component_policy_combo.appendChild($el('option', { value: 'workflow', text: 'Component: Use workflow version' }, []));
 		component_policy_combo.appendChild($el('option', { value: 'higher', text: 'Component: Use higher version' }, []));
 		component_policy_combo.appendChild($el('option', { value: 'mine', text: 'Component: Use my version' }, []));
-		api.fetchApi('/v2/manager/policy/component')
+		api.fetchApi('/manager/policy/component')
 			.then(response => response.text())
 			.then(data => {
 				component_policy_combo.value = data;
@@ -1055,7 +1065,7 @@ class ManagerMenuDialog extends ComfyDialog {
 			});
 
 		component_policy_combo.addEventListener('change', function (event) {
-			api.fetchApi(`/v2/manager/policy/component?value=${event.target.value}`);
+			api.fetchApi(`/manager/policy/component?value=${event.target.value}`);
 			set_component_policy(event.target.value);
 		});
 
@@ -1068,14 +1078,14 @@ class ManagerMenuDialog extends ComfyDialog {
 		update_policy_combo.className = "cm-menu-combo";
 		update_policy_combo.appendChild($el('option', { value: 'stable-comfyui', text: 'Update: ComfyUI Stable Version' }, []));
 		update_policy_combo.appendChild($el('option', { value: 'nightly-comfyui', text: 'Update: ComfyUI Nightly Version' }, []));
-		api.fetchApi('/v2/manager/policy/update')
+		api.fetchApi('/manager/policy/update')
 			.then(response => response.text())
 			.then(data => {
 				update_policy_combo.value = data;
 			});
 
 		update_policy_combo.addEventListener('change', function (event) {
-			api.fetchApi(`/v2/manager/policy/update?value=${event.target.value}`);
+			api.fetchApi(`/manager/policy/update?value=${event.target.value}`);
 		});
 
 		return [
@@ -1378,12 +1388,12 @@ class ManagerMenuDialog extends ComfyDialog {
 }
 
 async function getVersion() {
-	let version = await api.fetchApi(`/v2/manager/version`);
+	let version = await api.fetchApi(`/manager/version`);
 	return await version.text();
 }
 
 app.registerExtension({
-	name: "Comfy.Legacy.ManagerMenu",
+	name: "Comfy.ManagerMenu",
 
 	aboutPageBadges: [
 		{
@@ -1514,6 +1524,8 @@ app.registerExtension({
 					tooltip: "Share"
 				}).element
 			);
+
+			app.menu?.settingsGroup.element.before(cmGroup.element);
 		}
 		catch(exception) {
 			console.log('ComfyUI is outdated. New style menu based features are disabled.');

js/comfyui-share-common.js

@@ -172,7 +172,7 @@ export const shareToEsheep= () => {
 		const nodes = app.graph._nodes
 		const { potential_outputs, potential_output_nodes } = getPotentialOutputsAndOutputNodes(nodes);
 		const workflow = prompt['workflow']
-		api.fetchApi(`/v2/manager/set_esheep_workflow_and_images`, {
+		api.fetchApi(`/manager/set_esheep_workflow_and_images`, {
 			method: 'POST',
 			headers: { 'Content-Type': 'application/json' },
 			body: JSON.stringify({
@@ -552,20 +552,6 @@ export class ShareDialog extends ComfyDialog {
 		this.matrix_destination_checkbox.style.color = "var(--fg-color)";
 		this.matrix_destination_checkbox.checked = this.share_option === 'matrix'; //true;
 
-		try {
-			api.fetchApi(`/v2/manager/get_matrix_dep_status`)
-				.then(response => response.text())
-				.then(data => {
-					if(data == 'unavailable') {
-						matrix_destination_checkbox_text.style.textDecoration = "line-through";
-						this.matrix_destination_checkbox.disabled = true;
-						this.matrix_destination_checkbox.title = "It has been disabled because the 'matrix-nio' dependency is not installed. Please install this dependency to use the matrix sharing feature.";
-						matrix_destination_checkbox_text.title = "It has been disabled because the 'matrix-nio' dependency is not installed. Please install this dependency to use the matrix sharing feature.";
-					}
-				})
-				.catch(error => {});
-		} catch (error) {}
-
 		this.comfyworkflows_destination_checkbox = $el("input", { type: 'checkbox', id: "comfyworkflows_destination" }, [])
 		const comfyworkflows_destination_checkbox_text = $el("label", {}, [" ComfyWorkflows.com"])
 		this.comfyworkflows_destination_checkbox.style.color = "var(--fg-color)";
@@ -826,7 +812,7 @@ export class ShareDialog extends ComfyDialog {
 		// get the user's existing matrix auth and share key
 		ShareDialog.matrix_auth = { homeserver: "matrix.org", username: "", password: "" };
 		try {
-			api.fetchApi(`/v2/manager/get_matrix_auth`)
+			api.fetchApi(`/manager/get_matrix_auth`)
 				.then(response => response.json())
 				.then(data => {
 					ShareDialog.matrix_auth = data;
@@ -845,7 +831,7 @@ export class ShareDialog extends ComfyDialog {
 		ShareDialog.cw_sharekey = "";
 		try {
 			// console.log("Fetching comfyworkflows share key")
-			api.fetchApi(`/v2/manager/get_comfyworkflows_auth`)
+			api.fetchApi(`/manager/get_comfyworkflows_auth`)
 				.then(response => response.json())
 				.then(data => {
 					ShareDialog.cw_sharekey = data.comfyworkflows_sharekey;
@@ -905,7 +891,7 @@ export class ShareDialog extends ComfyDialog {
 			// Change the text of the share button to "Sharing..." to indicate that the share process has started
 			this.share_button.textContent = "Sharing...";
 
-			const response = await api.fetchApi(`/v2/manager/share`, {
+			const response = await api.fetchApi(`/manager/share`, {
 				method: 'POST',
 				headers: { 'Content-Type': 'application/json' },
 				body: JSON.stringify({

js/comfyui-share-openart.js

@@ -67,7 +67,7 @@ export class OpenArtShareDialog extends ComfyDialog {
   async readKey() {
     let key = ""
     try {
-      key = await api.fetchApi(`/v2/manager/get_openart_auth`)
+      key = await api.fetchApi(`/manager/get_openart_auth`)
         .then(response => response.json())
         .then(data => {
           return data.openart_key;
@@ -82,7 +82,7 @@ export class OpenArtShareDialog extends ComfyDialog {
   }
 
   async saveKey(value) {
-    await api.fetchApi(`/v2/manager/set_openart_auth`, {
+    await api.fetchApi(`/manager/set_openart_auth`, {
       method: 'POST',
       headers: {'Content-Type': 'application/json'},
       body: JSON.stringify({
@@ -399,7 +399,7 @@ export class OpenArtShareDialog extends ComfyDialog {
     form.append("file", uploadFile);
     try {
       const res = await this.fetchApi(
-        `/v2/workflows/upload_thumbnail`,
+        `/workflows/upload_thumbnail`,
         {
           method: "POST",
           body: form,
@@ -459,7 +459,7 @@ export class OpenArtShareDialog extends ComfyDialog {
       throw new Error("Title is required");
     }
 
-    const current_snapshot = await api.fetchApi(`/v2/snapshot/get_current`)
+    const current_snapshot = await api.fetchApi(`/snapshot/get_current`)
       .then(response => response.json())
       .catch(error => {
         // console.log(error);
@@ -489,7 +489,7 @@ export class OpenArtShareDialog extends ComfyDialog {
 
     try {
       const response = await this.fetchApi(
-        "/v2/workflows/publish",
+        "/workflows/publish",
         {
           method: "POST",
           headers: {"Content-Type": "application/json"},

js/comfyui-share-youml.js

@@ -179,7 +179,7 @@ export class YouMLShareDialog extends ComfyDialog {
   async loadToken() {
     let key = ""
     try {
-      const response = await api.fetchApi(`/v2/manager/youml/settings`)
+      const response = await api.fetchApi(`/manager/youml/settings`)
       const settings = await response.json()
       return settings.token
     } catch (error) {
@@ -188,7 +188,7 @@ export class YouMLShareDialog extends ComfyDialog {
   }
 
   async saveToken(value) {
-    await api.fetchApi(`/v2/manager/youml/settings`, {
+    await api.fetchApi(`/manager/youml/settings`, {
       method: 'POST',
       headers: {'Content-Type': 'application/json'},
       body: JSON.stringify({
@@ -380,7 +380,7 @@ export class YouMLShareDialog extends ComfyDialog {
     try {
       let snapshotData = null;
       try {
-        const snapshot = await api.fetchApi(`/v2/snapshot/get_current`)
+        const snapshot = await api.fetchApi(`/snapshot/get_current`)
         snapshotData = await snapshot.json()
       } catch (e) {
         console.error("Failed to get snapshot", e)

js/common.js

@@ -172,7 +172,7 @@ export function rebootAPI() {
 	customConfirm("Are you sure you'd like to reboot the server?").then((isConfirmed) => {
 		if (isConfirmed) {
 			try {
-				api.fetchApi("/v2/manager/reboot");
+				api.fetchApi("/manager/reboot");
 			}
 			catch(exception) {}
 		}
@@ -210,7 +210,7 @@ export async function install_pip(packages) {
 	if(packages.includes('&'))
 		app.ui.dialog.show(`Invalid PIP package enumeration: '${packages}'`);
 
-	const res = await api.fetchApi("/v2/customnode/install/pip", {
+	const res = await api.fetchApi("/customnode/install/pip", {
 		method: "POST",
 		body: packages,
 	});
@@ -245,7 +245,7 @@ export async function install_via_git_url(url, manager_dialog) {
 
 	show_message(`Wait...<BR><BR>Installing '${url}'`);
 
-	const res = await api.fetchApi("/v2/customnode/install/git_url", {
+	const res = await api.fetchApi("/customnode/install/git_url", {
 		method: "POST",
 		body: url,
 	});
@@ -630,14 +630,6 @@ export function showTooltip(target, text, className = 'cn-tooltip', styleMap = {
 	});
 }
 
-export function generateUUID() {
-	return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
-		const r = Math.random() * 16 | 0;
-		const v = c === 'x' ? r : (r & 0x3 | 0x8);
-		return v.toString(16);
-	  });	
-}
-
 function initTooltip () {
 	const mouseenterHandler = (e) => {
         const target = e.target;

js/components-manager.js

@@ -64,7 +64,7 @@ function storeGroupNode(name, data, register=true) {
 }
 
 export async function load_components() {
-	let data = await api.fetchApi('/v2/manager/component/loads', {method: "POST"});
+	let data = await api.fetchApi('/manager/component/loads', {method: "POST"});
 	let components = await data.json();
 
 	let start_time = Date.now();
@@ -222,7 +222,7 @@ async function save_as_component(node, version, author, prefix, nodename, packna
 	pack_map[packname] = component_name;
 	rpack_map[component_name] = subgraph;
 
-	const res = await api.fetchApi('/v2/manager/component/save', {
+	const res = await api.fetchApi('/manager/component/save', {
 			method: "POST",
 			headers: {
 				"Content-Type": "application/json",
@@ -259,7 +259,7 @@ async function import_component(component_name, component, mode) {
 				workflow: component
 			};
 
-		const res = await api.fetchApi('/v2/manager/component/save', {
+		const res = await api.fetchApi('/manager/component/save', {
 						method: "POST",
 						headers: { "Content-Type": "application/json", },
 						body: JSON.stringify(body)
@@ -709,7 +709,7 @@ app.handleFile = handleFile;
 
 let current_component_policy = 'workflow';
 try {
-	api.fetchApi('/v2/manager/policy/component')
+	api.fetchApi('/manager/policy/component')
 		.then(response => response.text())
 		.then(data => { current_component_policy = data; });
 }

js/custom-nodes-manager.css

@@ -1,5 +1,5 @@
 .cn-manager {
-	--grid-font: -apple-system, BlinkMacSystemFont, "Segue UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
+	--grid-font: -apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji";
 	z-index: 1099;
 	width: 80%;
 	height: 80%;

js/custom-nodes-manager.js

@@ -7,7 +7,7 @@ import {
 	fetchData, md5, icons, show_message, customConfirm, customAlert, customPrompt,
 	sanitizeHTML, infoToast, showTerminal, setNeedRestart,
 	storeColumnWidth, restoreColumnWidth, getTimeAgo, copyText, loadCss,
-	showPopover, hidePopover, generateUUID
+	showPopover, hidePopover
 } from  "./common.js";
 
 // https://cenfun.github.io/turbogrid/api.html
@@ -66,7 +66,7 @@ export class CustomNodesManager {
 		this.id = "cn-manager";
 
 		app.registerExtension({
-			name: "Comfy.Legacy.CustomNodesManager",
+			name: "Comfy.CustomNodesManager",
 			afterConfigureGraph: (missingNodeTypes) => {
 				const item = this.getFilterItem(ShowMode.MISSING);
 				if (item) {
@@ -459,7 +459,7 @@ export class CustomNodesManager {
 
 			".cn-manager-stop": {
 				click: () => {
-					api.fetchApi('/v2/manager/queue/reset');
+					api.fetchApi('/manager/queue/reset');
 					infoToast('Cancel', 'Remaining tasks will stop after completing the current task.');
 				}
 			},
@@ -635,7 +635,7 @@ export class CustomNodesManager {
 			};
 		}
 
-		const response = await api.fetchApi(`/v2/customnode/import_fail_info`, {
+		const response = await api.fetchApi(`/customnode/import_fail_info`, {
 									method: 'POST',
 									headers: { 'Content-Type': 'application/json' },
 									body: JSON.stringify(info)
@@ -1244,7 +1244,7 @@ export class CustomNodesManager {
 	async loadNodes(node_packs) {
 		const mode = manager_instance.datasrc_combo.value;
 		this.showStatus(`Loading node mappings (${mode}) ...`);
-		const res = await fetchData(`/v2/customnode/getmappings?mode=${mode}`);
+		const res = await fetchData(`/customnode/getmappings?mode=${mode}`);
 		if (res.error) {
 			console.log(res.error);
 			return;
@@ -1396,10 +1396,10 @@ export class CustomNodesManager {
 		this.showLoading();
 		let res;
 		if(is_enable) {
-			res = await api.fetchApi(`/v2/customnode/disabled_versions/${node_id}`, { cache: "no-store" });
+			res = await api.fetchApi(`/customnode/disabled_versions/${node_id}`, { cache: "no-store" });
 		}
 		else {
-			res = await api.fetchApi(`/v2/customnode/versions/${node_id}`, { cache: "no-store" });
+			res = await api.fetchApi(`/customnode/versions/${node_id}`, { cache: "no-store" });
 		}
 		this.hideLoading();
 
@@ -1441,6 +1441,13 @@ export class CustomNodesManager {
 	}
 
 	async installNodes(list, btn, title, selected_version) {
+		let stats = await api.fetchApi('/manager/queue/status');
+		stats = await stats.json();
+		if(stats.is_processing) {
+			customAlert(`[ComfyUI-Manager] There are already tasks in progress. Please try again after it is completed. (${stats.done_count}/${stats.total_count})`);
+			return;
+		}
+
 		const { target, label, mode} = btn;
 
 		if(mode === "uninstall") {
@@ -1467,9 +1474,9 @@ export class CustomNodesManager {
 		let needRestart = false;
 		let errorMsg = "";
 
-		let target_items = [];
+		await api.fetchApi('/manager/queue/reset');
 
-		let batch = {};
+		let target_items = [];
 
 		for (const hash of list) {
 			const item = this.grid.getRowItemBy("hash", hash);
@@ -1512,11 +1519,23 @@ export class CustomNodesManager {
 				api_mode = 'reinstall';
 			}
 
-			if(batch[api_mode]) {
-				batch[api_mode].push(data);
-			}
-			else {
-				batch[api_mode] = [data];
+			const res = await api.fetchApi(`/manager/queue/${api_mode}`, {
+				method: 'POST',
+				body: JSON.stringify(data)
+			});
+
+			if (res.status != 200) {
+				errorMsg = `'${item.title}': `;
+
+				if(res.status == 403) {
+					errorMsg += `This action is not allowed with this security level configuration.\n`;
+				} else if(res.status == 404) {
+					errorMsg += `With the current security level configuration, only custom nodes from the <B>"default channel"</B> can be installed.\n`;
+				} else {
+					errorMsg += await res.text() + '\n';
+				}
+
+				break;
 			}
 		}
 
@@ -1533,24 +1552,7 @@ export class CustomNodesManager {
 			}
 		}
 		else {
-			this.batch_id = generateUUID();
-			batch['batch_id'] = this.batch_id;
-
-			const res = await api.fetchApi(`/v2/manager/queue/batch`, {
-				method: 'POST',
-				body: JSON.stringify(batch)
-			});
-
-			let failed = await res.json();
-
-			if(failed.length > 0) {
-				for(let k in failed) {
-					let hash = failed[k];
-					const item = this.grid.getRowItemBy("hash", hash);
-					errorMsg = `[FAIL] ${item.title}`;
-				}
-			}
-
+			await api.fetchApi('/manager/queue/start');
 			this.showStop();
 			showTerminal();
 		}
@@ -1558,9 +1560,6 @@ export class CustomNodesManager {
 
 	async onQueueStatus(event) {
 		let self = CustomNodesManager.instance;
-		// If legacy manager front is not open, return early (using new manager front)
-		if (self.element?.style.display === 'none') return
-
 		if(event.detail.status == 'in_progress' && event.detail.ui_target == 'nodepack_manager') {
 			const hash = event.detail.target;
 
@@ -1571,7 +1570,7 @@ export class CustomNodesManager {
 			self.grid.updateCell(item, "action");
 			self.grid.setRowSelected(item, false);
 		}
-		else if(event.detail.status == 'batch-done' && event.detail.batch_id == self.batch_id) {
+		else if(event.detail.status == 'done') {
 			self.hideStop();
 			self.onQueueCompleted(event.detail);
 		}
@@ -1765,7 +1764,7 @@ export class CustomNodesManager {
 	async getMissingNodesLegacy(hashMap, missing_nodes) {
 		const mode = manager_instance.datasrc_combo.value;
 		this.showStatus(`Loading missing nodes (${mode}) ...`);
-		const res = await fetchData(`/v2/customnode/getmappings?mode=${mode}`);
+		const res = await fetchData(`/customnode/getmappings?mode=${mode}`);
 		if (res.error) {
 			this.showError(`Failed to get custom node mappings: ${res.error}`);
 			return;
@@ -1880,7 +1879,7 @@ export class CustomNodesManager {
 	async getAlternatives() {
 		const mode = manager_instance.datasrc_combo.value;
 		this.showStatus(`Loading alternatives (${mode}) ...`);
-		const res = await fetchData(`/v2/customnode/alternatives?mode=${mode}`);
+		const res = await fetchData(`/customnode/alternatives?mode=${mode}`);
 		if (res.error) {
 			this.showError(`Failed to get alternatives: ${res.error}`);
 			return [];
@@ -1928,7 +1927,7 @@ export class CustomNodesManager {
 			infoToast('Fetching updated information. This may take some time if many custom nodes are installed.');
 		}
 
-		const res = await fetchData(`/v2/customnode/getlist?mode=${mode}${skip_update}`);
+		const res = await fetchData(`/customnode/getlist?mode=${mode}${skip_update}`);
 		if (res.error) {
 			this.showError("Failed to get custom node list.");
 			this.hideLoading();

js/model-manager.js

@@ -3,7 +3,7 @@ import { $el } from "../../scripts/ui.js";
 import { 
 	manager_instance, rebootAPI, 
 	fetchData, md5, icons, show_message, customAlert, infoToast, showTerminal,
-	storeColumnWidth, restoreColumnWidth, loadCss, generateUUID
+	storeColumnWidth, restoreColumnWidth, loadCss
 } from  "./common.js";
 import { api } from "../../scripts/api.js";
 
@@ -175,7 +175,7 @@ export class ModelManager {
 
 			".cmm-manager-stop": {
 				click: () => {
-					api.fetchApi('/v2/manager/queue/reset');
+					api.fetchApi('/manager/queue/reset');
 					infoToast('Cancel', 'Remaining tasks will stop after completing the current task.');
 				}
 			},
@@ -435,15 +435,23 @@ export class ModelManager {
 	}
 
 	async installModels(list, btn) {
+		let stats = await api.fetchApi('/manager/queue/status');
+
+		stats = await stats.json();
+		if(stats.is_processing) {
+			customAlert(`[ComfyUI-Manager] There are already tasks in progress. Please try again after it is completed. (${stats.done_count}/${stats.total_count})`);
+			return;
+		}
+
 		btn.classList.add("cmm-btn-loading");
 		this.showError("");
 
 		let needRefresh = false;
 		let errorMsg = "";
 
-		let target_items = [];
+		await api.fetchApi('/manager/queue/reset');
 
-		let batch = {};
+		let target_items = [];
 
 		for (const item of list) {
 			this.grid.scrollRowIntoView(item);
@@ -460,12 +468,21 @@ export class ModelManager {
 			const data = item.originalData;
 			data.ui_id = item.hash;
 
+			const res = await api.fetchApi(`/manager/queue/install_model`, {
+				method: 'POST',
+				body: JSON.stringify(data)
+			});
 
-			if(batch['install_model']) {
-				batch['install_model'].push(data);
-			}
-			else {
-				batch['install_model'] = [data];
+			if (res.status != 200) {
+				errorMsg = `'${item.name}': `;
+
+				if(res.status == 403) {
+					errorMsg += `This action is not allowed with this security level configuration.\n`;
+				} else {
+					errorMsg += await res.text() + '\n';
+				}
+
+				break;
 			}
 		}
 
@@ -482,24 +499,7 @@ export class ModelManager {
 			}
 		}
 		else {
-			this.batch_id = generateUUID();
-			batch['batch_id'] = this.batch_id;
-
-			const res = await api.fetchApi(`/v2/manager/queue/batch`, {
-				method: 'POST',
-				body: JSON.stringify(batch)
-			});
-
-			let failed = await res.json();
-
-			if(failed.length > 0) {
-				for(let k in failed) {
-					let hash = failed[k];
-					const item = self.grid.getRowItemBy("hash", hash);
-					errorMsg = `[FAIL] ${item.title}`;
-				}
-			}
-
+			await api.fetchApi('/manager/queue/start');
 			this.showStop();
 			showTerminal();
 		}
@@ -519,7 +519,7 @@ export class ModelManager {
 //			self.grid.updateCell(item, "tg-column-select");
 			self.grid.updateRow(item);
 		}
-		else if(event.detail.status == 'batch-done') {
+		else if(event.detail.status == 'done') {
 			self.hideStop();
 			self.onQueueCompleted(event.detail);
 		}
@@ -645,7 +645,7 @@ export class ModelManager {
 
 		const mode = manager_instance.datasrc_combo.value;
 
-		const res = await fetchData(`/v2/externalmodel/getlist?mode=${mode}`);
+		const res = await fetchData(`/externalmodel/getlist?mode=${mode}`);
 		if (res.error) {
 			this.showError("Failed to get external model list.");
 			this.hideLoading();

js/node_fixer.js

@@ -142,7 +142,7 @@ function node_info_copy(src, dest, connect_both, copy_shape) {
 }
 
 app.registerExtension({
-	name: "Comfy.Legacy.Manager.NodeFixer",
+	name: "Comfy.Manager.NodeFixer",
 	beforeRegisterNodeDef(nodeType, nodeData, app) {
 		addMenuHandler(nodeType, function (_, options) {
 			options.push({

js/snapshot.js

@@ -7,7 +7,7 @@ import { manager_instance, rebootAPI, show_message } from  "./common.js";
 async function restore_snapshot(target) {
 	if(SnapshotManager.instance) {
 		try {
-			const response = await api.fetchApi(`/v2/snapshot/restore?target=${target}`, { cache: "no-store" });
+			const response = await api.fetchApi(`/snapshot/restore?target=${target}`, { cache: "no-store" });
 
 			if(response.status == 403) {
 				show_message('This action is not allowed with this security level configuration.');
@@ -35,7 +35,7 @@ async function restore_snapshot(target) {
 async function remove_snapshot(target) {
 	if(SnapshotManager.instance) {
 		try {
-			const response = await api.fetchApi(`/v2/snapshot/remove?target=${target}`, { cache: "no-store" });
+			const response = await api.fetchApi(`/snapshot/remove?target=${target}`, { cache: "no-store" });
 
 			if(response.status == 403) {
 				show_message('This action is not allowed with this security level configuration.');
@@ -61,7 +61,7 @@ async function remove_snapshot(target) {
 
 async function save_current_snapshot() {
 	try {
-		const response = await api.fetchApi('/v2/snapshot/save', { cache: "no-store" });
+		const response = await api.fetchApi('/snapshot/save', { cache: "no-store" });
 		app.ui.dialog.close();
 		return true;
 	}
@@ -76,7 +76,7 @@ async function save_current_snapshot() {
 }
 
 async function getSnapshotList() {
-	const response = await api.fetchApi(`/v2/snapshot/getlist`);
+	const response = await api.fetchApi(`/snapshot/getlist`);
 	const data = await response.json();
 	return data;
 }

js/workflow-metadata.js

@@ -38,7 +38,7 @@ class WorkflowMetadataExtension {
    * enabled is true if the node is enabled, false if it is disabled
    */
   async getInstalledNodes() {
-    const res = await api.fetchApi("/v2/customnode/installed");
+    const res = await api.fetchApi("/customnode/installed");
     return await res.json();
   }
 

model-list.json

@@ -5355,6 +5355,317 @@
       "filename": "LBM_relighting.safetensors",
       "url": "https://huggingface.co/jasperai/LBM_relighting/resolve/main/model.safetensors",
       "size": "5.02GB"
+    },
+    {
+      "name": "Qwen-Image VAE",
+      "type": "VAE",
+      "base": "Qwen-Image",
+      "save_path": "vae/qwen-image",
+      "description": "VAE model for Qwen-Image",
+      "reference": "https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI",
+      "filename": "qwen_image_vae.safetensors",
+      "url": "https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/resolve/main/split_files/vae/qwen_image_vae.safetensors",
+      "size": "335MB"
+    },
+    {
+      "name": "Qwen 2.5 VL 7B Text Encoder (fp8_scaled)",
+      "type": "clip",
+      "base": "Qwen-2.5-VL",
+      "save_path": "text_encoders/qwen",
+      "description": "Qwen 2.5 VL 7B text encoder model (fp8_scaled)",
+      "reference": "https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI",
+      "filename": "qwen_2.5_vl_7b_fp8_scaled.safetensors",
+      "url": "https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/resolve/main/split_files/text_encoders/qwen_2.5_vl_7b_fp8_scaled.safetensors",
+      "size": "3.75GB"
+    },
+    {
+      "name": "Qwen 2.5 VL 7B Text Encoder",
+      "type": "clip",
+      "base": "Qwen-2.5-VL",
+      "save_path": "text_encoders/qwen",
+      "description": "Qwen 2.5 VL 7B text encoder model",
+      "reference": "https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI",
+      "filename": "qwen_2.5_vl_7b.safetensors",
+      "url": "https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/resolve/main/split_files/text_encoders/qwen_2.5_vl_7b.safetensors",
+      "size": "7.51GB"
+    },
+    {
+      "name": "Qwen-Image Diffusion Model (fp8_e4m3fn)",
+      "type": "diffusion_model",
+      "base": "Qwen-Image",
+      "save_path": "diffusion_models/qwen-image",
+      "description": "Qwen-Image diffusion model (fp8_e4m3fn)",
+      "reference": "https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI",
+      "filename": "qwen_image_fp8_e4m3fn.safetensors",
+      "url": "https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/resolve/main/split_files/diffusion_models/qwen_image_fp8_e4m3fn.safetensors",
+      "size": "4.89GB"
+    },
+    {
+      "name": "Qwen-Image Diffusion Model (bf16)",
+      "type": "diffusion_model",
+      "base": "Qwen-Image",
+      "save_path": "diffusion_models/qwen-image",
+      "description": "Qwen-Image diffusion model (bf16)",
+      "reference": "https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI",
+      "filename": "qwen_image_bf16.safetensors",
+      "url": "https://huggingface.co/Comfy-Org/Qwen-Image_ComfyUI/resolve/main/split_files/diffusion_models/qwen_image_bf16.safetensors",
+      "size": "9.78GB"
+    },
+    {
+      "name": "Qwen-Image-Edit 2509 Diffusion Model (fp8_e4m3fn)",
+      "type": "diffusion_model",
+      "base": "Qwen-Image-Edit",
+      "save_path": "diffusion_models/qwen-image-edit",
+      "description": "Qwen-Image-Edit 2509 diffusion model (fp8_e4m3fn)",
+      "reference": "https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI",
+      "filename": "qwen_image_edit_2509_fp8_e4m3fn.safetensors",
+      "url": "https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI/resolve/main/split_files/diffusion_models/qwen_image_edit_2509_fp8_e4m3fn.safetensors",
+      "size": "4.89GB"
+    },
+
+    {
+      "name": "Qwen-Image-Edit 2509 Diffusion Model (bf16)",
+      "type": "diffusion_model",
+      "base": "Qwen-Image-Edit",
+      "save_path": "diffusion_models/qwen-image-edit",
+      "description": "Qwen-Image-Edit 2509 diffusion model (bf16)",
+      "reference": "https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI",
+      "filename": "qwen_image_edit_2509_bf16.safetensors",
+      "url": "https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI/resolve/main/split_files/diffusion_models/qwen_image_edit_2509_bf16.safetensors",
+      "size": "9.78GB"
+    },
+
+    {
+      "name": "Qwen-Image-Edit Diffusion Model (fp8_e4m3fn)",
+      "type": "diffusion_model",
+      "base": "Qwen-Image-Edit",
+      "save_path": "diffusion_models/qwen-image-edit",
+      "description": "Qwen-Image-Edit diffusion model (fp8_e4m3fn)",
+      "reference": "https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI",
+      "filename": "qwen_image_edit_fp8_e4m3fn.safetensors",
+      "url": "https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI/resolve/main/split_files/diffusion_models/qwen_image_edit_fp8_e4m3fn.safetensors",
+      "size": "4.89GB"
+    },
+
+    {
+      "name": "Qwen-Image-Edit Diffusion Model (bf16)",
+      "type": "diffusion_model",
+      "base": "Qwen-Image-Edit",
+      "save_path": "diffusion_models/qwen-image-edit",
+      "description": "Qwen-Image-Edit diffusion model (bf16)",
+      "reference": "https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI",
+      "filename": "qwen_image_edit_bf16.safetensors",
+      "url": "https://huggingface.co/Comfy-Org/Qwen-Image-Edit_ComfyUI/resolve/main/split_files/diffusion_models/qwen_image_edit_bf16.safetensors",
+      "size": "9.78GB"
+    },
+    {
+      "name": "Qwen-Image-Lightning 8steps V1.0",
+      "type": "lora",
+      "base": "Qwen-Image",
+      "save_path": "loras/qwen-image-lightning",
+      "description": "Qwen-Image-Lightning 8-step LoRA model V1.0",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Lightning-8steps-V1.0.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Lightning-8steps-V1.0.safetensors",
+      "size": "9.78GB"
+    },
+    {
+      "name": "Qwen-Image-Lightning 4steps V1.0",
+      "type": "lora",
+      "base": "Qwen-Image",
+      "save_path": "loras/qwen-image-lightning",
+      "description": "Qwen-Image-Lightning 4-step LoRA model V1.0",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Lightning-4steps-V1.0.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Lightning-4steps-V1.0.safetensors",
+      "size": "9.78GB"
+    },
+    {
+      "name": "Qwen-Image-Lightning 4steps V1.0 (bf16)",
+      "type": "lora",
+      "base": "Qwen-Image",
+      "save_path": "loras/qwen-image-lightning",
+      "description": "Qwen-Image-Lightning 4-step LoRA model V1.0 (bf16)",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Lightning-4steps-V1.0-bf16.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Lightning-4steps-V1.0-bf16.safetensors",
+      "size": "19.6GB"
+    },
+    {
+      "name": "Qwen-Image-Lightning 4steps V2.0",
+      "type": "lora",
+      "base": "Qwen-Image",
+      "save_path": "loras/qwen-image-lightning",
+      "description": "Qwen-Image-Lightning 4-step LoRA model V2.0",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Lightning-4steps-V2.0.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Lightning-4steps-V2.0.safetensors",
+      "size": "9.78GB"
+    },
+    {
+      "name": "Qwen-Image-Lightning 4steps V2.0 (bf16)",
+      "type": "lora",
+      "base": "Qwen-Image",
+      "save_path": "loras/qwen-image-lightning",
+      "description": "Qwen-Image-Lightning 4-step LoRA model V2.0 (bf16)",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Lightning-4steps-V2.0-bf16.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Lightning-4steps-V2.0-bf16.safetensors",
+      "size": "19.6GB"
+    },
+    {
+      "name": "Qwen-Image-Lightning 8steps V1.1",
+      "type": "lora",
+      "base": "Qwen-Image",
+      "save_path": "loras/qwen-image-lightning",
+      "description": "Qwen-Image-Lightning 8-step LoRA model V1.1",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Lightning-8steps-V1.1.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Lightning-8steps-V1.1.safetensors",
+      "size": "9.78GB"
+    },
+    {
+      "name": "Qwen-Image-Lightning 8steps V1.1 (bf16)",
+      "type": "lora",
+      "base": "Qwen-Image",
+      "save_path": "loras/qwen-image-lightning",
+      "description": "Qwen-Image-Lightning 8-step LoRA model V1.1 (bf16)",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Lightning-8steps-V1.1-bf16.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Lightning-8steps-V1.1-bf16.safetensors",
+      "size": "19.6GB"
+    },
+    {
+      "name": "Qwen-Image-Lightning 8steps V2.0",
+      "type": "lora",
+      "base": "Qwen-Image",
+      "save_path": "loras/qwen-image-lightning",
+      "description": "Qwen-Image-Lightning 8-step LoRA model V2.0",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Lightning-8steps-V2.0.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Lightning-8steps-V2.0.safetensors",
+      "size": "9.78GB"
+    },
+    {
+      "name": "Qwen-Image-Lightning 8steps V2.0 (bf16)",
+      "type": "lora",
+      "base": "Qwen-Image",
+      "save_path": "loras/qwen-image-lightning",
+      "description": "Qwen-Image-Lightning 8-step LoRA model V2.0 (bf16)",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Lightning-8steps-V2.0-bf16.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Lightning-8steps-V2.0-bf16.safetensors",
+      "size": "19.6GB"
+    },
+    {
+      "name": "Qwen-Image-Edit-Lightning 4steps V1.0",
+      "type": "lora",
+      "base": "Qwen-Image-Edit",
+      "save_path": "loras/qwen-image-edit-lightning",
+      "description": "Qwen-Image-Edit-Lightning 4-step LoRA model V1.0",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Edit-Lightning-4steps-V1.0.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Edit-Lightning-4steps-V1.0.safetensors",
+      "size": "9.78GB"
+    },
+    {
+      "name": "Qwen-Image-Edit-Lightning 4steps V1.0 (bf16)",
+      "type": "lora",
+      "base": "Qwen-Image-Edit",
+      "save_path": "loras/qwen-image-edit-lightning",
+      "description": "Qwen-Image-Edit-Lightning 4-step LoRA model V1.0 (bf16)",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Edit-Lightning-4steps-V1.0-bf16.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Edit-Lightning-4steps-V1.0-bf16.safetensors",
+      "size": "19.6GB"
+    },
+    {
+      "name": "Qwen-Image-Edit-Lightning 8steps V1.0",
+      "type": "lora",
+      "base": "Qwen-Image-Edit",
+      "save_path": "loras/qwen-image-edit-lightning",
+      "description": "Qwen-Image-Edit-Lightning 8-step LoRA model V1.0",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Edit-Lightning-8steps-V1.0.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Edit-Lightning-8steps-V1.0.safetensors",
+      "size": "9.78GB"
+    },
+    {
+      "name": "Qwen-Image-Edit-Lightning 8steps V1.0 (bf16)",
+      "type": "lora",
+      "base": "Qwen-Image-Edit",
+      "save_path": "loras/qwen-image-edit-lightning",
+      "description": "Qwen-Image-Edit-Lightning 8-step LoRA model V1.0 (bf16)",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Edit-Lightning-8steps-V1.0-bf16.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Edit-Lightning-8steps-V1.0-bf16.safetensors",
+      "size": "19.6GB"
+    },
+    {
+      "name": "Qwen-Image-Edit-2509-Lightning 4steps V1.0 (bf16)",
+      "type": "lora",
+      "base": "Qwen-Image-Edit",
+      "save_path": "loras/qwen-image-edit-lightning",
+      "description": "Qwen-Image-Edit-2509-Lightning 4-step LoRA model V1.0 (bf16)",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Edit-2509-Lightning-4steps-V1.0-bf16.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Edit-2509/Qwen-Image-Edit-2509-Lightning-4steps-V1.0-bf16.safetensors",
+      "size": "19.6GB"
+    },
+    {
+      "name": "Qwen-Image-Edit-2509-Lightning 4steps V1.0 (fp32)",
+      "type": "lora",
+      "base": "Qwen-Image-Edit",
+      "save_path": "loras/qwen-image-edit-lightning",
+      "description": "Qwen-Image-Edit-2509-Lightning 4-step LoRA model V1.0 (fp32)",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Edit-2509-Lightning-4steps-V1.0-fp32.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Edit-2509/Qwen-Image-Edit-2509-Lightning-4steps-V1.0-fp32.safetensors",
+      "size": "39.1GB"
+    },
+    {
+      "name": "Qwen-Image-Edit-2509-Lightning 8steps V1.0 (bf16)",
+      "type": "lora",
+      "base": "Qwen-Image-Edit",
+      "save_path": "loras/qwen-image-edit-lightning",
+      "description": "Qwen-Image-Edit-2509-Lightning 8-step LoRA model V1.0 (bf16)",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Edit-2509-Lightning-8steps-V1.0-bf16.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Edit-2509/Qwen-Image-Edit-2509-Lightning-8steps-V1.0-bf16.safetensors",
+      "size": "19.6GB"
+    },
+    {
+      "name": "Qwen-Image-Edit-2509-Lightning 8steps V1.0 (fp32)",
+      "type": "lora",
+      "base": "Qwen-Image-Edit",
+      "save_path": "loras/qwen-image-edit-lightning",
+      "description": "Qwen-Image-Edit-2509-Lightning 8-step LoRA model V1.0 (fp32)",
+      "reference": "https://huggingface.co/lightx2v/Qwen-Image-Lightning",
+      "filename": "Qwen-Image-Edit-2509-Lightning-8steps-V1.0-fp32.safetensors",
+      "url": "https://huggingface.co/lightx2v/Qwen-Image-Lightning/resolve/main/Qwen-Image-Edit-2509/Qwen-Image-Edit-2509-Lightning-8steps-V1.0-fp32.safetensors",
+      "size": "39.1GB"
+    },
+    {
+      "name": "Qwen-Image InstantX ControlNet Union",
+      "type": "controlnet",
+      "base": "Qwen-Image",
+      "save_path": "controlnet/qwen-image/instantx",
+      "description": "Qwen-Image InstantX ControlNet Union model",
+      "reference": "https://huggingface.co/Comfy-Org/Qwen-Image-InstantX-ControlNets",
+      "filename": "Qwen-Image-InstantX-ControlNet-Union.safetensors",
+      "url": "https://huggingface.co/Comfy-Org/Qwen-Image-InstantX-ControlNets/resolve/main/split_files/controlnet/Qwen-Image-InstantX-ControlNet-Union.safetensors",
+      "size": "2.54GB"
+    },
+    {
+      "name": "Qwen-Image InstantX ControlNet Inpainting",
+      "type": "controlnet",
+      "base": "Qwen-Image",
+      "save_path": "controlnet/qwen-image/instantx",
+      "description": "Qwen-Image InstantX ControlNet Inpainting model",
+      "reference": "https://huggingface.co/Comfy-Org/Qwen-Image-InstantX-ControlNets",
+      "filename": "Qwen-Image-InstantX-ControlNet-Inpainting.safetensors",
+      "url": "https://huggingface.co/Comfy-Org/Qwen-Image-InstantX-ControlNets/resolve/main/split_files/controlnet/Qwen-Image-InstantX-ControlNet-Inpainting.safetensors",
+      "size": "2.54GB"
     }
   ]
-}
+}

node_db/legacy/custom-node-list.json

@@ -1,5 +1,490 @@
 {
     "custom_nodes": [
+        {
+            "author": "neocrz",
+            "title": "comfyui-tinyae [REMOVED]",
+            "reference": "https://github.com/neocrz/comfyui-tinyae",
+            "files": [
+                "https://github.com/neocrz/comfyui-tinyae"
+            ],
+            "install_type": "git-clone",
+            "description": "NODES: TinyAE Encode (Image/Video), TinyAE Decode (Image/Video), TinyAE Encode Tiled (Image), TinyAE Decode Tiled (Image)"
+        },
+        {
+            "author": "Laser-one",
+            "title": "ComfyUI-align-pose [REMOVED]",
+            "reference": "https://github.com/Laser-one/ComfyUI-align-pose",
+            "files": [
+                "https://github.com/Laser-one/ComfyUI-align-pose"
+            ],
+            "install_type": "git-clone",
+            "description": "NODES:align pose"
+        },
+        {
+            "author": "nomadoor",
+            "title": "ComfyUI Video Stabilizer",
+            "reference": "https://github.com/nomadoor/ComfyUI-Video-Stabilizer",
+            "files": [
+                "https://github.com/nomadoor/ComfyUI-Video-Stabilizer"
+            ],
+            "install_type": "git-clone",
+            "description": "Two complementary stabiliser nodes for ComfyUI: Video Stabilizer (Classic), Video Stabilizer (Flow)"
+        },
+        {
+            "author": "0xhappydev",
+            "title": "comfyui-qwen-image-tools",
+            "reference": "https://github.com/0xhappydev/comfyui-qwen-image-tools",
+            "files": [
+                "https://github.com/0xhappydev/comfyui-qwen-image-tools"
+            ],
+            "install_type": "git-clone",
+            "description": "Custom nodes for Qwen-Image-Edit with multi-image support, more flexibility around the vision transformer (qwen2.5-vl), custom system prompts, and some other experimental things to come."
+        },
+        {
+            "author": "Rathius-Saranoth",
+            "title": "Rathius ComfyUI Nodes",
+            "reference": "https://github.com/Rathius-Saranoth/rathius-comfyui-nodes",
+            "files": [
+                "https://github.com/Rathius-Saranoth/rathius-comfyui-nodes"
+            ],
+            "install_type": "git-clone",
+            "description": "Custom nodes for ComfyUI by Rathius"
+        },
+        {
+            "author": "Hiero207",
+            "title": "Hiero-Nodes [REMOVED]",
+            "id": "hiero",
+            "reference": "https://github.com/Hiero207/ComfyUI-Hiero-Nodes",
+            "files": [
+                "https://github.com/Hiero207/ComfyUI-Hiero-Nodes"
+            ],
+            "install_type": "git-clone",
+            "description": "Nodes:Post to Discord w/ Webhook"
+        },
+        {
+            "author": "NeoDroleDeGueule",
+            "title": "comfyui-image-mixer",
+            "reference": "https://github.com/NeoDroleDeGueule/comfyui-image-mixer [REMOVED]",
+            "files": [
+                "https://github.com/NeoDroleDeGueule/comfyui-image-mixer"
+            ],
+            "install_type": "git-clone",
+            "description": "A ComfyUI custom node that blends two images in latent space using a mix factor slider."
+        },
+        {
+            "author": "Glarus-akash",
+            "title": "ComfyUI_Image_Upscaler [REMOVED]",
+            "reference": "https://github.com/Glarus-akash/ComfyUI_Image_Upscaler",
+            "files": [
+                "https://github.com/Glarus-akash/ComfyUI_Image_Upscaler"
+            ],
+            "install_type": "git-clone",
+            "description": "Welcome to the Image Upscaler & Restorer project! This tool utilizes the [a/GFPGAN](https://github.com/TencentARC/GFPGAN) algorithm to enhance and restore images, providing a seamless way to improve image quality."
+        },
+        {
+            "author": "styletransfer",
+            "title": "Sequential Group Controller for ComfyUI [REMOVED]",
+            "reference": "https://github.com/styletransfer/ComfyUI_SequentialGroupController",
+            "files": [
+                "https://github.com/styletransfer/ComfyUI_SequentialGroupController"
+            ],
+            "install_type": "git-clone",
+            "description": "Control which groups execute based on iteration ranges - a simplified alternative to complex conditional branching workflows."
+        },
+        {
+            "author": "xl0",
+            "title": "q_tools [REMOVED]",
+            "reference": "https://github.com/xl0/q_tools",
+            "files": [
+                "https://github.com/xl0/q_tools"
+            ],
+            "install_type": "git-clone",
+            "description": "NODES: QLoadLatent, QLinearScheduler, QPreviewLatent, QGaussianLatent, QUniformLatent, QKSampler"
+        },
+        {
+            "author": "tmode-1960",
+            "title": "comfyui-ta-nodes-pack [REMOVED]",
+            "reference": "https://github.com/tmode-1960/comfyui-ta-nodes-pack",
+            "files": [
+                "https://github.com/tmode-1960/comfyui-ta-nodes-pack"
+            ],
+            "install_type": "git-clone",
+            "description": "Model loaders with an additional model name output"
+        },
+        {
+            "author": "Shadetail",
+            "title": "Eagleshadow Custom Nodes [REMOVED]",
+            "id": "eagleshadow",
+            "reference": "https://github.com/Shadetail/ComfyUI_Eagleshadow",
+            "files": [
+                "https://github.com/Shadetail/ComfyUI_Eagleshadow"
+            ],
+            "install_type": "git-clone",
+            "description": "Custom nodes for ComfyUI by Eagleshadow."
+        },
+        {
+            "author": "manycore-maas",
+            "title": "ComfyUI-SpatialGen [REMOVED]",
+            "reference": "https://github.com/manycore-maas/ComfyUI-SpatialGen",
+            "files": [
+                "https://github.com/manycore-maas/ComfyUI-SpatialGen"
+            ],
+            "install_type": "git-clone",
+            "description": "Scene Viewer of SpatialGen"
+        },
+        {
+            "author": "YinBailiang",
+            "title": "MergeBlockWeighted_fo_ComfyUI [REMOVED]",
+            "id": "mergeblockweighted_fo_comfyui",
+            "reference": "https://github.com/YinBailiang/MergeBlockWeighted_fo_ComfyUI",
+            "files": [
+                "https://github.com/YinBailiang/MergeBlockWeighted_fo_ComfyUI"
+            ],
+            "install_type": "git-clone",
+            "description": "Nodes: MergeBlockWeighted"
+        },
+        {
+            "author": "facok",
+            "title": "ComfyUI-FokToolset [REMOVED]",
+            "reference": "https://github.com/facok/ComfyUI-FokToolset",
+            "files": [
+                "https://github.com/facok/ComfyUI-FokToolset"
+            ],
+            "install_type": "git-clone",
+            "description": "NODES: Fok Preprocess Ref Image (Phantom)"
+        },
+        {
+            "author": "Elawphant",
+            "title": "ComfyUI-MusicGen [WIP]",
+            "id": "musicgen",
+            "reference": "https://github.com/Elawphant/ComfyUI-MusicGen",
+            "files": [
+                "https://github.com/Elawphant/ComfyUI-MusicGen"
+            ],
+            "install_type": "git-clone",
+            "description": "ComfyUI for Meta MusicGen."
+        },
+        {
+            "author": "isaac-mcfadyen",
+            "title": "ComfyUI-QwenClip [REMOVED]",
+            "reference": "https://github.com/isaac-mcfadyen/ComfyUI-QwenClip",
+            "files": [
+                "https://github.com/isaac-mcfadyen/ComfyUI-QwenClip"
+            ],
+            "install_type": "git-clone",
+            "description": "A variety of random text encoder tools intended for use with ComfyUI and Qwen Image/Qwen Image Edit. More (may) be added as I try out various modifications to Qwen Image."
+        },
+        {
+            "author": "Gaotian",
+            "title": "KLComfyUI-Nodes [REMOVED]",
+            "reference": "https://github.com/Gaotian-cpu/KLComfyUI-Nodes",
+            "files": [
+                "https://github.com/Gaotian-cpu/KLComfyUI-Nodes"
+            ],
+            "install_type": "git-clone",
+            "description": "NODES: Single Video_Img Callback"
+        },
+        {
+            "author": "geltz",
+            "title": "Momentum Guidance for ComfyUI [REMOVED]",
+            "reference": "https://github.com/geltz/ComfyUI-MomentumGuidance",
+            "files": [
+                "https://github.com/geltz/ComfyUI-MomentumGuidance"
+            ],
+            "install_type": "git-clone",
+            "description": "Momentum Guidance (MG) is a training-free guidance method that reduces computational cost by 40% compared to standard guidance techniques like CFG or PAG."
+        },
+        {
+            "author": "GeekyGhost",
+            "title": "Studio42 Image, Audio, and Video Editing Suite for ComfyUI [REMOVED]",
+            "reference": "https://github.com/GeekyGhost/24oiduts-ComfyUI",
+            "files": [
+                "https://github.com/GeekyGhost/24oiduts-ComfyUI"
+            ],
+            "install_type": "git-clone",
+            "description": "Studio42 is a comprehensive suite of advanced custom nodes that brings professional-grade image and video editing capabilities to ComfyUI. Designed for efficiency, quality, and creative flexibility, this suite provides cutting-edge background removal, layer composition, and patch manipulation tools used in modern VFX and content creation workflows."
+        },
+        {
+            "author": "rvage",
+            "title": "ComfyUI-RvTools-X [REMOVED]",
+            "reference": "https://github.com/r-vage/ComfyUI-RvTools-X",
+            "files": [
+                "https://github.com/r-vage/ComfyUI-RvTools-X"
+            ],
+            "install_type": "git-clone",
+            "description": "ComfyUI custom nodes and utilities for workflow building, type conversions, checkpoint/pipe loaders and file utilities."
+        },
+        {
+            "author": "heyburns",
+            "title": "LinxUtil [REMOVED]",
+            "reference": "https://github.com/heyburns/LinxUtil",
+            "files": [
+                "https://github.com/heyburns/LinxUtil"
+            ],
+            "install_type": "git-clone",
+            "description": "Utility nodes for ComfyUI. Created solely for my own use case, shared as a courtesy only.\nNOTE: The files in the repo are not organized."
+        },
+        {
+            "author": "fcanfora",
+            "title": "comfyui-camera-tools [REMOVED]",
+            "reference": "https://github.com/fcanfora/comfyui-camera-tools",
+            "files": [
+                "https://github.com/fcanfora/comfyui-camera-tools"
+            ],
+            "install_type": "git-clone",
+            "description": "NODES: Load Camera From File, Load 3D, Load 3D - Animation, Preview 3D, Preview 3D - Animation"
+        },
+        {
+            "author": "ziwang-com",
+            "title": "comfyui-deepseek-r1 [REMOVED]",
+            "reference": "https://github.com/ziwang-com/comfyui-deepseek-r1",
+            "files": [
+                "https://github.com/ziwang-com/comfyui-deepseek-r1"
+            ],
+            "install_type": "git-clone",
+            "description": "Comfyui-deepseek-r1 Node Plugin"
+        },
+        {
+            "author": "leeguandong",
+            "title": "ComfyUI nodes to use Xverse [REMOVED]",
+            "reference": "https://github.com/leeguandong/ComfyUI_Xverse",
+            "files": [
+                "https://github.com/leeguandong/ComfyUI_Xverse"
+            ],
+            "install_type": "git-clone",
+            "description": "The ComfyUI version of [a/XVerse](https://github.com/bytedance/XVerse)"
+        },
+        {
+            "author": "Dehypnotic",
+            "title": "Dehypnotic Save nodes [REMOVED]",
+            "reference": "https://github.com/Dehypnotic/comfyui-dehypnotic-save-nodes",
+            "files": [
+                "https://github.com/Dehypnotic/comfyui-dehypnotic-save-nodes"
+            ],
+            "install_type": "git-clone",
+            "description": "Save toolkit for audio, image, and video: MP3 audio export with VBR/CBR options, multi-format image saving with workflow/thumbnail metadata, and video + frame encoding (MP4/MKV/WEBM/MOV) — all sharing whitelist-safe paths and rich placeholder templating."
+        },
+        {
+            "author": "znuost10",
+            "title": "comfyui-multi-float-output [REMOVED]",
+            "reference": "https://github.com/znuost10/comfyui-multi-float-output",
+            "files": [
+                "https://github.com/znuost10/comfyui-multi-float-output"
+            ],
+            "install_type": "git-clone",
+            "description": "System monitoring API endpoints for ComfyUI by otoy SKW"
+        },
+        {
+            "author": "rakki194",
+            "title": "ComfyUI_WolfSigmas [UNSAFE/REMOVED]",
+            "reference": "https://github.com/rakki194/ComfyUI_WolfSigmas",
+            "files": [
+                "https://github.com/rakki194/ComfyUI_WolfSigmas"
+            ],
+            "install_type": "git-clone",
+            "description": "This custom nodepack for ComfyUI provides a suite of tools for generating and manipulating sigma schedules for diffusion models. These nodes are particularly useful for fine-tuning the sampling process, experimenting with different step counts, and adapting schedules for specific models.[w/Security Warning: Remote Code Execution]"
+        },
+        {
+            "author": "Maff3u",
+            "title": "MattiaNodes - Points Editor On Cropped [REMOVED]",
+            "reference": "https://github.com/Maff3u/MattiaNodes",
+            "files": [
+                "https://github.com/Maff3u/MattiaNodes"
+            ],
+            "install_type": "git-clone",
+            "description": "A standalone ComfyUI custom node for interactive coordinate editing with crop factor correction.\nNOTE: The files in the repo are not organized."
+        },
+        {
+            "author": "rakki194",
+            "title": "ComfyUI-ImageCompare [REMOVED]",
+            "reference": "https://github.com/rakki194/ComfyUI-ImageCompare",
+            "files": [
+                "https://github.com/rakki194/ComfyUI-ImageCompare"
+            ],
+            "install_type": "git-clone",
+            "description": "A simple custom node for ComfyUI that allows you to compare two images (or batches of images) side-by-side within the UI."
+        },
+        {
+            "author": "APZmedia",
+            "title": "NormalMapLightEstimator [REMOVED]",
+            "reference": "https://github.com/APZmedia/Comfyui-LightDirection-estimation",
+            "files": [
+                "https://github.com/APZmedia/Comfyui-LightDirection-estimation"
+            ],
+            "install_type": "git-clone",
+            "description": "A ComfyUI custom node for estimating light direction and quality from normal maps using luma masking. The system analyzes surface normals to infer lighting information for downstream tasks like adaptive relighting, directional masking, or stylized effects."
+        },
+        {
+            "author": "APZmedia",
+            "title": "ComfyUI APZmedia PSD Tools [REMOVED]",
+            "reference": "https://github.com/APZmedia/APZmedia-ComfyUI-PSDtools",
+            "files": [
+                "https://github.com/APZmedia/APZmedia-ComfyUI-PSDtools"
+            ],
+            "install_type": "git-clone",
+            "description": "This extension provides PSD layer saving functionalities with mask support for ComfyUI."
+        },
+        {
+            "author": "huixingyun",
+            "title": "ComfyUI-HX-Pimg [REMOVED]",
+            "reference": "https://github.com/huixingyun/ComfyUI-HX-Pimg",
+            "files": [
+                "https://github.com/huixingyun/ComfyUI-HX-Pimg"
+            ],
+            "install_type": "git-clone",
+            "description": "Some custom nodes used for pimg (a comfyui controller deployed in huixingyun)."
+        },
+        {
+            "author": "rvage",
+            "title": "ComfyUI-RvToolsX [REMOVED]",
+            "reference": "https://github.com/r-vage/ComfyUI-RvToolsX",
+            "files": [
+                "https://github.com/r-vage/ComfyUI-RvToolsX"
+            ],
+            "install_type": "git-clone",
+            "description": "ComfyUI custom nodes and utilities for workflow building, type conversions, checkpoint/pipe loaders and file utilities."
+        },
+        {
+            "author": "usman2003",
+            "title": "ComfyUI-RaceDetect [REMOVED]",
+            "reference": "https://github.com/usman2003/ComfyUI-RaceDetect",
+            "files": [
+                "https://github.com/usman2003/ComfyUI-RaceDetect"
+            ],
+            "install_type": "git-clone",
+            "description": "NODES: Race Detection V2"
+        },
+        {
+            "author": "lihaoyun6",
+            "title": "ComfyUI-CSV-Random-Picker [REMOVED]",
+            "reference": "https://github.com/lihaoyun6/ComfyUI-CSV-Random-Picker",
+            "files": [
+                "https://github.com/lihaoyun6/ComfyUI-CSV-Random-Picker"
+            ],
+            "install_type": "git-clone",
+            "description": "String random picker for ComfyUI"
+        },
+        {
+            "author": "r-vage",
+            "title": "ComfyUI-RvTools_v2 [REMOVED]",
+            "reference": "https://github.com/r-vage/ComfyUI-RvTools_v2",
+            "files": [
+                "https://github.com/r-vage/ComfyUI-RvTools_v2"
+            ],
+            "install_type": "git-clone",
+            "description": "this node contains a lot of small little helpers like switches, passers and selectors that i use a lot to build my workflows."
+        },
+        {
+            "author": "Yuxi Liu",
+            "title": "comfyui-ddu [REMOVED]",
+            "reference": "https://github.com/YL-Lyx/Comfyui-ddu-toolchain",
+            "files": [
+                "https://github.com/YL-Lyx/Comfyui-ddu-toolchain"
+            ],
+            "install_type": "git-clone",
+            "description": "ai-driven toolchain for digital design and fabrication "
+        },
+        {
+            "author": "lu64k",
+            "title": "SK-Nodes [REMOVED]",
+            "reference": "https://github.com/lu64k/SK-Nodes",
+            "files": [
+                "https://github.com/lu64k/SK-Nodes"
+            ],
+            "install_type": "git-clone",
+            "description": "NODES:image select, Load AnyLLM, Ask LLM, OpenAI DAlle Node, SK Text_String, SK Random File Name"
+        },
+        {
+            "author": "SiggEye",
+            "title": "FaceCanon — Consistent Faces at Any Resolution [REMOVED]",
+            "reference": "https://github.com/SiggEye/FaceCanon",
+            "files": [
+                "https://github.com/SiggEye/FaceCanon"
+            ],
+            "install_type": "git-clone",
+            "description": "FaceCanon scales a detected face to a canonical pixel size, lets you run your favorite face detailer at that sweet spot, then maps the result back into the original image with seamless blending. The payoff is consistent face style no matter the input resolution or framing."
+        },
+        {
+            "author": "AlfredClark",
+            "title": "ComfyUI-ModelSpec [REMOVED]",
+            "reference": "https://github.com/AlfredClark/ComfyUI-ModelSpec",
+            "files": [
+                "https://github.com/AlfredClark/ComfyUI-ModelSpec"
+            ],
+            "install_type": "git-clone",
+            "description": "ComfyUI model metadata editing nodes."
+        },
+        {
+            "author": "VraethrDalkr",
+            "title": "ComfyUI-ProgressiveBlend [REMOVED]",
+            "reference": "https://github.com/VraethrDalkr/ComfyUI-ProgressiveBlend",
+            "files": [
+                "https://github.com/VraethrDalkr/ComfyUI-ProgressiveBlend"
+            ],
+            "install_type": "git-clone",
+            "description": "A collection of custom nodes for ComfyUI that enable progressive blending and color matching effects across image batches/video frames."
+        },
+        {
+            "author": "xmarked-ai",
+            "title": "ComfyUI_misc [REMOVED]",
+            "reference": "https://github.com/xmarked-ai/ComfyUI_misc",
+            "files": [
+                "https://github.com/xmarked-ai/ComfyUI_misc"
+            ],
+            "install_type": "git-clone",
+            "description": "NODES: Ace IntegerX, Ace FloatX, Ace Color FixX, White Balance X, Depth Displace X, Empty Latent X, KSampler Combo X, ..."
+        },
+        {
+            "author": "sm079",
+            "title": "ComfyUI-Face-Detection [REMOVED]",
+            "reference": "https://github.com/sm079/ComfyUI-Face-Detection",
+            "files": [
+                "https://github.com/sm079/ComfyUI-Face-Detection"
+            ],
+            "install_type": "git-clone",
+            "description": "face detection nodes for comfyui"
+        },
+        {
+            "author": "42lux",
+            "title": "ComfyUI-42lux [REMOVED]",
+            "reference": "https://github.com/42lux/ComfyUI-42lux",
+            "files": [
+                "https://github.com/42lux/ComfyUI-42lux"
+            ],
+            "install_type": "git-clone",
+            "description": "A collection of custom nodes for ComfyUI focused on enhanced sampling, model optimization, and quality improvements."
+        },
+        {
+            "author": "lucak5s",
+            "title": "ComfyUI GFPGAN [REMOVED]",
+            "reference": "https://github.com/lucak5s/comfyui_gfpgan",
+            "files": [
+                "https://github.com/lucak5s/comfyui_gfpgan"
+            ],
+            "install_type": "git-clone",
+            "description": "Face restoration with GFPGAN."
+        },
+        {
+            "author": "impactframes",
+            "title": "IF_AI_tools [DEPRECATED]",
+            "id": "impactframes-tools",
+            "reference": "https://github.com/if-ai/ComfyUI-IF_AI_tools",
+            "files": [
+                "https://github.com/if-ai/ComfyUI-IF_AI_tools"
+            ],
+            "install_type": "git-clone",
+            "description": "Various AI tools to use in Comfy UI. Starting with VL and prompt making tools using Ollma as backend will evolve as I find time."
+        },
+        {
+            "author": "netroxin",
+            "title": "comfyui_netro [REMOVED]",
+            "reference": "https://github.com/netroxin/comfyui_netro",
+            "files": [
+                "https://github.com/netroxin/comfyui_netro"
+            ],
+            "install_type": "git-clone",
+            "description": "#Camera Movement Prompt Node for ComfyUI\nThis custom node script for ComfyUI generates descriptive camera movement prompts based on user-selected movement options for Wan2.2"
+        },
         {
             "author": "aistudynow",
             "title": "comfyui-HunyuanImage-2.1 [REMOVED]",

node_db/tutorial/custom-node-list.json

@@ -361,6 +361,16 @@
             ],
             "install_type": "git-clone",
             "description": "Vibe Coded ComfyUI Custom Nodes"
+        },
+        {
+            "author": "aiforhumans",
+            "title": "XDev Nodes - Complete Toolkit",
+            "reference": "https://github.com/aiforhumans/comfyui-xdev-nodes",
+            "files": [
+                "https://github.com/aiforhumans/comfyui-xdev-nodes"
+            ],
+            "install_type": "git-clone",
+            "description": "Complete ComfyUI development toolkit with 8 professional nodes including VAE tools, universal type testing, and comprehensive debugging infrastructure."
         }
     ]
 }

notebooks/comfyui_colab_with_manager.ipynb

@@ -0,0 +1,373 @@
+{
+ "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "id": "aaaaaaaaaa"
+   },
+   "source": [
+    "Git clone the repo and install the requirements. (ignore the pip errors about protobuf)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "id": "bbbbbbbbbb"
+   },
+   "outputs": [],
+   "source": [
+    "# #@title Environment Setup\n",
+    "\n",
+    "from pathlib import Path\n",
+    "\n",
+    "OPTIONS = {}\n",
+    "\n",
+    "USE_GOOGLE_DRIVE = True  #@param {type:\"boolean\"}\n",
+    "UPDATE_COMFY_UI = True  #@param {type:\"boolean\"}\n",
+    "USE_COMFYUI_MANAGER = True  #@param {type:\"boolean\"}\n",
+    "INSTALL_CUSTOM_NODES_DEPENDENCIES = True  #@param {type:\"boolean\"}\n",
+    "OPTIONS['USE_GOOGLE_DRIVE'] = USE_GOOGLE_DRIVE\n",
+    "OPTIONS['UPDATE_COMFY_UI'] = UPDATE_COMFY_UI\n",
+    "OPTIONS['USE_COMFYUI_MANAGER'] = USE_COMFYUI_MANAGER\n",
+    "OPTIONS['INSTALL_CUSTOM_NODES_DEPENDENCIES'] = INSTALL_CUSTOM_NODES_DEPENDENCIES\n",
+    "\n",
+    "current_dir = !pwd\n",
+    "WORKSPACE = f\"{current_dir[0]}/ComfyUI\"\n",
+    "\n",
+    "if OPTIONS['USE_GOOGLE_DRIVE']:\n",
+    "    !echo \"Mounting Google Drive...\"\n",
+    "    %cd /\n",
+    "\n",
+    "    from google.colab import drive\n",
+    "    drive.mount('/content/drive')\n",
+    "\n",
+    "    WORKSPACE = \"/content/drive/MyDrive/ComfyUI\"\n",
+    "    %cd /content/drive/MyDrive\n",
+    "\n",
+    "![ ! -d $WORKSPACE ] && echo -= Initial setup ComfyUI =- && git clone https://github.com/comfyanonymous/ComfyUI\n",
+    "%cd $WORKSPACE\n",
+    "\n",
+    "if OPTIONS['UPDATE_COMFY_UI']:\n",
+    "  !echo -= Updating ComfyUI =-\n",
+    "\n",
+    "  # Correction of the issue of permissions being deleted on Google Drive.\n",
+    "  ![ -f \".ci/nightly/update_windows/update_comfyui_and_python_dependencies.bat\" ] && chmod 755 .ci/nightly/update_windows/update_comfyui_and_python_dependencies.bat\n",
+    "  ![ -f \".ci/nightly/windows_base_files/run_nvidia_gpu.bat\" ] && chmod 755 .ci/nightly/windows_base_files/run_nvidia_gpu.bat\n",
+    "  ![ -f \".ci/update_windows/update_comfyui_and_python_dependencies.bat\" ] && chmod 755 .ci/update_windows/update_comfyui_and_python_dependencies.bat\n",
+    "  ![ -f \".ci/update_windows_cu118/update_comfyui_and_python_dependencies.bat\" ] && chmod 755 .ci/update_windows_cu118/update_comfyui_and_python_dependencies.bat\n",
+    "  ![ -f \".ci/update_windows/update.py\" ] && chmod 755 .ci/update_windows/update.py\n",
+    "  ![ -f \".ci/update_windows/update_comfyui.bat\" ] && chmod 755 .ci/update_windows/update_comfyui.bat\n",
+    "  ![ -f \".ci/update_windows/README_VERY_IMPORTANT.txt\" ] && chmod 755 .ci/update_windows/README_VERY_IMPORTANT.txt\n",
+    "  ![ -f \".ci/update_windows/run_cpu.bat\" ] && chmod 755 .ci/update_windows/run_cpu.bat\n",
+    "  ![ -f \".ci/update_windows/run_nvidia_gpu.bat\" ] && chmod 755 .ci/update_windows/run_nvidia_gpu.bat\n",
+    "\n",
+    "  !git pull\n",
+    "\n",
+    "!echo -= Install dependencies =-\n",
+    "!pip3 install accelerate\n",
+    "!pip3 install einops transformers>=4.28.1 safetensors>=0.4.2 aiohttp pyyaml Pillow scipy tqdm psutil tokenizers>=0.13.3\n",
+    "!pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu121\n",
+    "!pip3 install torchsde\n",
+    "!pip3 install kornia>=0.7.1 spandrel soundfile sentencepiece\n",
+    "\n",
+    "if OPTIONS['USE_COMFYUI_MANAGER']:\n",
+    "  %cd custom_nodes\n",
+    "\n",
+    "  # Correction of the issue of permissions being deleted on Google Drive.\n",
+    "  ![ -f \"ComfyUI-Manager/check.sh\" ] && chmod 755 ComfyUI-Manager/check.sh\n",
+    "  ![ -f \"ComfyUI-Manager/scan.sh\" ] && chmod 755 ComfyUI-Manager/scan.sh\n",
+    "  ![ -f \"ComfyUI-Manager/node_db/dev/scan.sh\" ] && chmod 755 ComfyUI-Manager/node_db/dev/scan.sh\n",
+    "  ![ -f \"ComfyUI-Manager/node_db/tutorial/scan.sh\" ] && chmod 755 ComfyUI-Manager/node_db/tutorial/scan.sh\n",
+    "  ![ -f \"ComfyUI-Manager/scripts/install-comfyui-venv-linux.sh\" ] && chmod 755 ComfyUI-Manager/scripts/install-comfyui-venv-linux.sh\n",
+    "  ![ -f \"ComfyUI-Manager/scripts/install-comfyui-venv-win.bat\" ] && chmod 755 ComfyUI-Manager/scripts/install-comfyui-venv-win.bat\n",
+    "\n",
+    "  ![ ! -d ComfyUI-Manager ] && echo -= Initial setup ComfyUI-Manager =- && git clone https://github.com/ltdrdata/ComfyUI-Manager\n",
+    "  %cd ComfyUI-Manager\n",
+    "  !git pull\n",
+    "\n",
+    "%cd $WORKSPACE\n",
+    "\n",
+    "if OPTIONS['INSTALL_CUSTOM_NODES_DEPENDENCIES']:\n",
+    "  !echo -= Install custom nodes dependencies =-\n",
+    "  !pip install GitPython\n",
+    "  !python custom_nodes/ComfyUI-Manager/cm-cli.py restore-dependencies\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "id": "cccccccccc"
+   },
+   "source": [
+    "Download some models/checkpoints/vae or custom comfyui nodes (uncomment the commands for the ones you want)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "id": "dddddddddd"
+   },
+   "outputs": [],
+   "source": [
+    "# Checkpoints\n",
+    "\n",
+    "### SDXL\n",
+    "### I recommend these workflow examples: https://comfyanonymous.github.io/ComfyUI_examples/sdxl/\n",
+    "\n",
+    "#!wget -c https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/resolve/main/sd_xl_base_1.0.safetensors -P ./models/checkpoints/\n",
+    "#!wget -c https://huggingface.co/stabilityai/stable-diffusion-xl-refiner-1.0/resolve/main/sd_xl_refiner_1.0.safetensors -P ./models/checkpoints/\n",
+    "\n",
+    "# SDXL ReVision\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/clip_vision_g/resolve/main/clip_vision_g.safetensors -P ./models/clip_vision/\n",
+    "\n",
+    "# SD1.5\n",
+    "!wget -c https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned-emaonly.ckpt -P ./models/checkpoints/\n",
+    "\n",
+    "# SD2\n",
+    "#!wget -c https://huggingface.co/stabilityai/stable-diffusion-2-1-base/resolve/main/v2-1_512-ema-pruned.safetensors -P ./models/checkpoints/\n",
+    "#!wget -c https://huggingface.co/stabilityai/stable-diffusion-2-1/resolve/main/v2-1_768-ema-pruned.safetensors -P ./models/checkpoints/\n",
+    "\n",
+    "# Some SD1.5 anime style\n",
+    "#!wget -c https://huggingface.co/WarriorMama777/OrangeMixs/resolve/main/Models/AbyssOrangeMix2/AbyssOrangeMix2_hard.safetensors -P ./models/checkpoints/\n",
+    "#!wget -c https://huggingface.co/WarriorMama777/OrangeMixs/resolve/main/Models/AbyssOrangeMix3/AOM3A1_orangemixs.safetensors -P ./models/checkpoints/\n",
+    "#!wget -c https://huggingface.co/WarriorMama777/OrangeMixs/resolve/main/Models/AbyssOrangeMix3/AOM3A3_orangemixs.safetensors -P ./models/checkpoints/\n",
+    "#!wget -c https://huggingface.co/Linaqruf/anything-v3.0/resolve/main/anything-v3-fp16-pruned.safetensors -P ./models/checkpoints/\n",
+    "\n",
+    "# Waifu Diffusion 1.5 (anime style SD2.x 768-v)\n",
+    "#!wget -c https://huggingface.co/waifu-diffusion/wd-1-5-beta3/resolve/main/wd-illusion-fp16.safetensors -P ./models/checkpoints/\n",
+    "\n",
+    "\n",
+    "# unCLIP models\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/illuminatiDiffusionV1_v11_unCLIP/resolve/main/illuminatiDiffusionV1_v11-unclip-h-fp16.safetensors -P ./models/checkpoints/\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/wd-1.5-beta2_unCLIP/resolve/main/wd-1-5-beta2-aesthetic-unclip-h-fp16.safetensors -P ./models/checkpoints/\n",
+    "\n",
+    "\n",
+    "# VAE\n",
+    "!wget -c https://huggingface.co/stabilityai/sd-vae-ft-mse-original/resolve/main/vae-ft-mse-840000-ema-pruned.safetensors -P ./models/vae/\n",
+    "#!wget -c https://huggingface.co/WarriorMama777/OrangeMixs/resolve/main/VAEs/orangemix.vae.pt -P ./models/vae/\n",
+    "#!wget -c https://huggingface.co/hakurei/waifu-diffusion-v1-4/resolve/main/vae/kl-f8-anime2.ckpt -P ./models/vae/\n",
+    "\n",
+    "\n",
+    "# Loras\n",
+    "#!wget -c https://civitai.com/api/download/models/10350 -O ./models/loras/theovercomer8sContrastFix_sd21768.safetensors #theovercomer8sContrastFix SD2.x 768-v\n",
+    "#!wget -c https://civitai.com/api/download/models/10638 -O ./models/loras/theovercomer8sContrastFix_sd15.safetensors #theovercomer8sContrastFix SD1.x\n",
+    "#!wget -c https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0/resolve/main/sd_xl_offset_example-lora_1.0.safetensors -P ./models/loras/ #SDXL offset noise lora\n",
+    "\n",
+    "\n",
+    "# T2I-Adapter\n",
+    "#!wget -c https://huggingface.co/TencentARC/T2I-Adapter/resolve/main/models/t2iadapter_depth_sd14v1.pth -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/TencentARC/T2I-Adapter/resolve/main/models/t2iadapter_seg_sd14v1.pth -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/TencentARC/T2I-Adapter/resolve/main/models/t2iadapter_sketch_sd14v1.pth -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/TencentARC/T2I-Adapter/resolve/main/models/t2iadapter_keypose_sd14v1.pth -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/TencentARC/T2I-Adapter/resolve/main/models/t2iadapter_openpose_sd14v1.pth -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/TencentARC/T2I-Adapter/resolve/main/models/t2iadapter_color_sd14v1.pth -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/TencentARC/T2I-Adapter/resolve/main/models/t2iadapter_canny_sd14v1.pth -P ./models/controlnet/\n",
+    "\n",
+    "# T2I Styles Model\n",
+    "#!wget -c https://huggingface.co/TencentARC/T2I-Adapter/resolve/main/models/t2iadapter_style_sd14v1.pth -P ./models/style_models/\n",
+    "\n",
+    "# CLIPVision model (needed for styles model)\n",
+    "#!wget -c https://huggingface.co/openai/clip-vit-large-patch14/resolve/main/pytorch_model.bin -O ./models/clip_vision/clip_vit14.bin\n",
+    "\n",
+    "\n",
+    "# ControlNet\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/resolve/main/control_v11e_sd15_ip2p_fp16.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/resolve/main/control_v11e_sd15_shuffle_fp16.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/resolve/main/control_v11p_sd15_canny_fp16.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/resolve/main/control_v11f1p_sd15_depth_fp16.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/resolve/main/control_v11p_sd15_inpaint_fp16.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/resolve/main/control_v11p_sd15_lineart_fp16.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/resolve/main/control_v11p_sd15_mlsd_fp16.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/resolve/main/control_v11p_sd15_normalbae_fp16.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/resolve/main/control_v11p_sd15_openpose_fp16.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/resolve/main/control_v11p_sd15_scribble_fp16.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/resolve/main/control_v11p_sd15_seg_fp16.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/resolve/main/control_v11p_sd15_softedge_fp16.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/resolve/main/control_v11p_sd15s2_lineart_anime_fp16.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/ControlNet-v1-1_fp16_safetensors/resolve/main/control_v11u_sd15_tile_fp16.safetensors -P ./models/controlnet/\n",
+    "\n",
+    "# ControlNet SDXL\n",
+    "#!wget -c https://huggingface.co/stabilityai/control-lora/resolve/main/control-LoRAs-rank256/control-lora-canny-rank256.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/stabilityai/control-lora/resolve/main/control-LoRAs-rank256/control-lora-depth-rank256.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/stabilityai/control-lora/resolve/main/control-LoRAs-rank256/control-lora-recolor-rank256.safetensors -P ./models/controlnet/\n",
+    "#!wget -c https://huggingface.co/stabilityai/control-lora/resolve/main/control-LoRAs-rank256/control-lora-sketch-rank256.safetensors -P ./models/controlnet/\n",
+    "\n",
+    "# Controlnet Preprocessor nodes by Fannovel16\n",
+    "#!cd custom_nodes && git clone https://github.com/Fannovel16/comfy_controlnet_preprocessors; cd comfy_controlnet_preprocessors && python install.py\n",
+    "\n",
+    "\n",
+    "# GLIGEN\n",
+    "#!wget -c https://huggingface.co/comfyanonymous/GLIGEN_pruned_safetensors/resolve/main/gligen_sd14_textbox_pruned_fp16.safetensors -P ./models/gligen/\n",
+    "\n",
+    "\n",
+    "# ESRGAN upscale model\n",
+    "#!wget -c https://github.com/xinntao/Real-ESRGAN/releases/download/v0.1.0/RealESRGAN_x4plus.pth -P ./models/upscale_models/\n",
+    "#!wget -c https://huggingface.co/sberbank-ai/Real-ESRGAN/resolve/main/RealESRGAN_x2.pth -P ./models/upscale_models/\n",
+    "#!wget -c https://huggingface.co/sberbank-ai/Real-ESRGAN/resolve/main/RealESRGAN_x4.pth -P ./models/upscale_models/\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "id": "kkkkkkkkkkkkkkk"
+   },
+   "source": [
+    "### Run ComfyUI with cloudflared (Recommended Way)\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "id": "jjjjjjjjjjjjjj"
+   },
+   "outputs": [],
+   "source": [
+    "!wget -P ~ https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb\n",
+    "!dpkg -i ~/cloudflared-linux-amd64.deb\n",
+    "\n",
+    "import subprocess\n",
+    "import threading\n",
+    "import time\n",
+    "import socket\n",
+    "import urllib.request\n",
+    "\n",
+    "def iframe_thread(port):\n",
+    "  while True:\n",
+    "      time.sleep(0.5)\n",
+    "      sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)\n",
+    "      result = sock.connect_ex(('127.0.0.1', port))\n",
+    "      if result == 0:\n",
+    "        break\n",
+    "      sock.close()\n",
+    "  print(\"\\nComfyUI finished loading, trying to launch cloudflared (if it gets stuck here cloudflared is having issues)\\n\")\n",
+    "\n",
+    "  p = subprocess.Popen([\"cloudflared\", \"tunnel\", \"--url\", \"http://127.0.0.1:{}\".format(port)], stdout=subprocess.PIPE, stderr=subprocess.PIPE)\n",
+    "  for line in p.stderr:\n",
+    "    l = line.decode()\n",
+    "    if \"trycloudflare.com \" in l:\n",
+    "      print(\"This is the URL to access ComfyUI:\", l[l.find(\"http\"):], end='')\n",
+    "    #print(l, end='')\n",
+    "\n",
+    "\n",
+    "threading.Thread(target=iframe_thread, daemon=True, args=(8188,)).start()\n",
+    "\n",
+    "!python main.py --dont-print-server"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "id": "kkkkkkkkkkkkkk"
+   },
+   "source": [
+    "### Run ComfyUI with localtunnel\n",
+    "\n",
+    "\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "id": "jjjjjjjjjjjjj"
+   },
+   "outputs": [],
+   "source": [
+    "!npm install -g localtunnel\n",
+    "\n",
+    "import subprocess\n",
+    "import threading\n",
+    "import time\n",
+    "import socket\n",
+    "import urllib.request\n",
+    "\n",
+    "def iframe_thread(port):\n",
+    "  while True:\n",
+    "      time.sleep(0.5)\n",
+    "      sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)\n",
+    "      result = sock.connect_ex(('127.0.0.1', port))\n",
+    "      if result == 0:\n",
+    "        break\n",
+    "      sock.close()\n",
+    "  print(\"\\nComfyUI finished loading, trying to launch localtunnel (if it gets stuck here localtunnel is having issues)\\n\")\n",
+    "\n",
+    "  print(\"The password/enpoint ip for localtunnel is:\", urllib.request.urlopen('https://ipv4.icanhazip.com').read().decode('utf8').strip(\"\\n\"))\n",
+    "  p = subprocess.Popen([\"lt\", \"--port\", \"{}\".format(port)], stdout=subprocess.PIPE)\n",
+    "  for line in p.stdout:\n",
+    "    print(line.decode(), end='')\n",
+    "\n",
+    "\n",
+    "threading.Thread(target=iframe_thread, daemon=True, args=(8188,)).start()\n",
+    "\n",
+    "!python main.py --dont-print-server"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "id": "gggggggggg"
+   },
+   "source": [
+    "### Run ComfyUI with colab iframe (use only in case the previous way with localtunnel doesn't work)\n",
+    "\n",
+    "You should see the ui appear in an iframe. If you get a 403 error, it's your firefox settings or an extension that's messing things up.\n",
+    "\n",
+    "If you want to open it in another window use the link.\n",
+    "\n",
+    "Note that some UI features like live image previews won't work because the colab iframe blocks websockets."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {
+    "id": "hhhhhhhhhh"
+   },
+   "outputs": [],
+   "source": [
+    "import threading\n",
+    "import time\n",
+    "import socket\n",
+    "def iframe_thread(port):\n",
+    "  while True:\n",
+    "      time.sleep(0.5)\n",
+    "      sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)\n",
+    "      result = sock.connect_ex(('127.0.0.1', port))\n",
+    "      if result == 0:\n",
+    "        break\n",
+    "      sock.close()\n",
+    "  from google.colab import output\n",
+    "  output.serve_kernel_port_as_iframe(port, height=1024)\n",
+    "  print(\"to open it in a window you can open this link here:\")\n",
+    "  output.serve_kernel_port_as_window(port)\n",
+    "\n",
+    "threading.Thread(target=iframe_thread, daemon=True, args=(8188,)).start()\n",
+    "\n",
+    "!python main.py --dont-print-server"
+   ]
+  }
+ ],
+ "metadata": {
+  "accelerator": "GPU",
+  "colab": {
+   "provenance": []
+  },
+  "gpuClass": "standard",
+  "kernelspec": {
+   "display_name": "Python 3",
+   "name": "python3"
+  },
+  "language_info": {
+   "name": "python"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 0
+}

prestartup_script.py

@@ -12,10 +12,13 @@ import ast
 import logging
 import traceback
 
-from .common import security_check
-from .common import manager_util
-from .common import cm_global
-from .common import manager_downloader
+glob_path = os.path.join(os.path.dirname(__file__), "glob")
+sys.path.append(glob_path)
+
+import security_check
+import manager_util
+import cm_global
+import manager_downloader
 import folder_paths
 
 manager_util.add_python_path_to_env()
@@ -63,14 +66,16 @@ def is_import_failed_extension(name):
 comfy_path = os.environ.get('COMFYUI_PATH')
 comfy_base_path = os.environ.get('COMFYUI_FOLDERS_BASE_PATH')
 
+if comfy_path is None:
+    # legacy env var
+    comfy_path = os.environ.get('COMFYUI_PATH')
+
 if comfy_path is None:
     comfy_path = os.path.abspath(os.path.dirname(sys.modules['__main__'].__file__))
-    os.environ['COMFYUI_PATH'] = comfy_path
 
 if comfy_base_path is None:
     comfy_base_path = comfy_path
 
-
 sys.__comfyui_manager_register_message_collapse = register_message_collapse
 sys.__comfyui_manager_is_import_failed_extension = is_import_failed_extension
 cm_global.register_api('cm.register_message_collapse', register_message_collapse)
@@ -86,6 +91,9 @@ manager_pip_blacklist_path = os.path.join(manager_files_path, "pip_blacklist.lis
 restore_snapshot_path = os.path.join(manager_files_path, "startup-scripts", "restore-snapshot.json")
 manager_config_path = os.path.join(manager_files_path, 'config.ini')
 
+cm_cli_path = os.path.join(comfyui_manager_path, "cm-cli.py")
+
+
 default_conf = {}
 
 def read_config():
@@ -392,11 +400,7 @@ try:
         def emit(self, record):
             global is_start_mode
 
-            try:
-                message = record.getMessage()
-            except Exception as e:
-                message = f"<<logging error>>: {record} - {e}"
-                original_stderr.write(message)
+            message = record.getMessage()
 
             if is_start_mode:
                 match = re.search(pat_import_fail, message)
@@ -439,6 +443,35 @@ except Exception as e:
     print(f"[ComfyUI-Manager] Logging failed: {e}")
 
 
+def ensure_dependencies():
+    try:
+        import git     # noqa: F401
+        import toml    # noqa: F401
+        import rich    # noqa: F401
+        import chardet # noqa: F401
+    except ModuleNotFoundError:
+        my_path = os.path.dirname(__file__)
+        requirements_path = os.path.join(my_path, "requirements.txt")
+
+        print("## ComfyUI-Manager: installing dependencies. (GitPython)")
+        try:
+            subprocess.check_output(manager_util.make_pip_cmd(['install', '-r', requirements_path]))
+        except subprocess.CalledProcessError:
+            print("## [ERROR] ComfyUI-Manager: Attempting to reinstall dependencies using an alternative method.")
+            try:
+                subprocess.check_output(manager_util.make_pip_cmd(['install', '--user', '-r', requirements_path]))
+            except subprocess.CalledProcessError:
+                print("## [ERROR] ComfyUI-Manager: Failed to install the GitPython package in the correct Python environment. Please install it manually in the appropriate environment. (You can seek help at https://app.element.io/#/room/%23comfyui_space%3Amatrix.org)")
+
+    try:
+        print("## ComfyUI-Manager: installing dependencies done.")
+    except:
+        # maybe we should sys.exit() here? there is at least two screens worth of error messages still being pumped after our error messages
+        print("## [ERROR] ComfyUI-Manager: GitPython package seems to be installed, but failed to load somehow. Make sure you have a working git client installed")
+
+ensure_dependencies()
+
+
 print("** ComfyUI startup time:", current_timestamp())
 print("** Platform:", platform.system())
 print("** Python version:", sys.version)
@@ -462,7 +495,7 @@ def read_downgrade_blacklist():
             items = [x.strip() for x in items if x != '']
             cm_global.pip_downgrade_blacklist += items
             cm_global.pip_downgrade_blacklist = list(set(cm_global.pip_downgrade_blacklist))
-    except Exception:
+    except:
         pass
 
 
@@ -568,10 +601,7 @@ if os.path.exists(restore_snapshot_path):
         if 'COMFYUI_FOLDERS_BASE_PATH' not in new_env:
             new_env["COMFYUI_FOLDERS_BASE_PATH"] = comfy_path
 
-        if 'COMFYUI_PATH' not in new_env:
-            new_env['COMFYUI_PATH'] = os.path.dirname(folder_paths.__file__)
-
-        cmd_str = [sys.executable, '-m', 'comfyui_manager.cm_cli', 'restore-snapshot', restore_snapshot_path]
+        cmd_str = [sys.executable, cm_cli_path, 'restore-snapshot', restore_snapshot_path]
         exit_code = process_wrap(cmd_str, custom_nodes_base_path, handler=msg_capture, env=new_env)
 
         if exit_code != 0:

pyproject.toml

@@ -1,65 +1,15 @@
-[build-system]
-requires = ["setuptools >= 61.0"]
-build-backend = "setuptools.build_meta"
-
 [project]
 name = "comfyui-manager"
-license = { text = "GPL-3.0-only" }
-version = "4.0.2"
-requires-python = ">= 3.9"
 description = "ComfyUI-Manager provides features to install and manage custom nodes for ComfyUI, as well as various functionalities to assist with ComfyUI."
-readme = "README.md"
-keywords = ["comfyui", "comfyui-manager"]
-
-maintainers = [
-  { name = "Dr.Lt.Data", email = "dr.lt.data@gmail.com" },
-  { name = "Yoland Yan", email = "yoland@comfy.org" },
-  { name = "James Kwon", email = "hongilkwon316@gmail.com" },
-  { name = "Robin Huang", email = "robin@comfy.org" },
-]
-
-classifiers = [
-  "Development Status :: 5 - Production/Stable",
-  "Intended Audience :: Developers",
-  "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
-]
-
-dependencies = [
-    "GitPython",
-    "PyGithub",
-#    "matrix-nio",
-    "transformers",
-    "huggingface-hub>0.20",
-    "typer",
-    "rich",
-    "typing-extensions",
-    "toml",
-    "uv",
-    "chardet"
-]
-
-[project.optional-dependencies]
-dev = ["pre-commit", "pytest", "ruff", "pytest-cov"]
+version = "3.37"
+license = { file = "LICENSE.txt" }
+dependencies = ["GitPython", "PyGithub", "matrix-nio", "transformers", "huggingface-hub>0.20", "typer", "rich", "typing-extensions", "toml", "uv", "chardet"]
 
 [project.urls]
 Repository = "https://github.com/ltdrdata/ComfyUI-Manager"
+#  Used by Comfy Registry https://comfyregistry.org
 
-[tool.setuptools.packages.find]
-where = ["."]
-include = ["comfyui_manager*"]
-
-[project.scripts]
-cm-cli = "comfyui_manager.cm_cli.__main__:main"
-
-[tool.ruff]
-line-length = 120
-target-version = "py39"
-
-[tool.ruff.lint]
-select = [
-  "E4", # default
-  "E7", # default
-  "E9", # default
-  "F",  # default
-  "I",  # isort-like behavior (import statement sorting)
-]
+[tool.comfy]
+PublisherId = "drltdata"
+DisplayName = "ComfyUI-Manager"
+Icon = ""

requirements.txt

@@ -1,8 +1,8 @@
 GitPython
 PyGithub
-# matrix-nio
+matrix-nio
 transformers
-huggingface-hub>0.20
+huggingface-hub
 typer
 rich
 typing-extensions

scanner.py

@@ -13,7 +13,7 @@ builtin_nodes = set()
 import sys
 
 from urllib.parse import urlparse
-from github import Github
+from github import Github, Auth
 
 
 def download_url(url, dest_folder, filename=None):
@@ -53,7 +53,8 @@ skip_update = '--skip-update' in sys.argv or '--skip-all' in sys.argv
 skip_stat_update = '--skip-stat-update' in sys.argv or '--skip-all' in sys.argv
 
 if not skip_stat_update:
-    g = Github(os.environ.get('GITHUB_TOKEN'))
+    auth = Auth.Token(os.environ.get('GITHUB_TOKEN'))
+    g = Github(auth=auth)
 else:
     g = None
 
@@ -94,7 +95,7 @@ def extract_nodes(code_text):
             return s
         else:
             return set()
-    except Exception:
+    except:
         return set()
 
 
@@ -396,7 +397,7 @@ def update_custom_nodes():
 
         try:
             download_url(url, temp_dir)
-        except Exception:
+        except:
             print(f"[ERROR] Cannot download '{url}'")
 
     with concurrent.futures.ThreadPoolExecutor(10) as executor:

scripts/colab-dependencies.py

@@ -0,0 +1,39 @@
+import os
+import subprocess
+
+
+def get_enabled_subdirectories_with_files(base_directory):
+    subdirs_with_files = []
+    for subdir in os.listdir(base_directory):
+        try:
+            full_path = os.path.join(base_directory, subdir)
+            if os.path.isdir(full_path) and not subdir.endswith(".disabled") and not subdir.startswith('.') and subdir != '__pycache__':
+                print(f"## Install dependencies for '{subdir}'")
+                requirements_file = os.path.join(full_path, "requirements.txt")
+                install_script = os.path.join(full_path, "install.py")
+
+                if os.path.exists(requirements_file) or os.path.exists(install_script):
+                    subdirs_with_files.append((full_path, requirements_file, install_script))
+        except Exception as e:
+            print(f"EXCEPTION During Dependencies INSTALL on '{subdir}':\n{e}")
+
+    return subdirs_with_files
+
+
+def install_requirements(requirements_file_path):
+    if os.path.exists(requirements_file_path):
+        subprocess.run(["pip", "install", "-r", requirements_file_path])
+
+
+def run_install_script(install_script_path):
+    if os.path.exists(install_script_path):
+        subprocess.run(["python", install_script_path])
+
+
+custom_nodes_directory = "custom_nodes"
+subdirs_with_files = get_enabled_subdirectories_with_files(custom_nodes_directory)
+
+
+for subdir, requirements_file, install_script in subdirs_with_files:
+    install_requirements(requirements_file)
+    run_install_script(install_script)

scripts/install-comfyui-venv-linux.sh

@@ -0,0 +1,21 @@
+git clone https://github.com/comfyanonymous/ComfyUI
+cd ComfyUI/custom_nodes
+git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager
+cd ..
+python -m venv venv
+source venv/bin/activate
+python -m pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu121
+python -m pip install -r requirements.txt
+python -m pip install -r custom_nodes/comfyui-manager/requirements.txt
+cd ..
+echo "#!/bin/bash" > run_gpu.sh
+echo "cd ComfyUI" >> run_gpu.sh
+echo "source venv/bin/activate" >> run_gpu.sh
+echo "python main.py --preview-method auto" >> run_gpu.sh
+chmod +x run_gpu.sh
+
+echo "#!/bin/bash" > run_cpu.sh
+echo "cd ComfyUI" >> run_cpu.sh
+echo "source venv/bin/activate" >> run_cpu.sh
+echo "python main.py --preview-method auto --cpu" >> run_cpu.sh
+chmod +x run_cpu.sh

scripts/install-comfyui-venv-win.bat

@@ -0,0 +1,17 @@
+git clone https://github.com/comfyanonymous/ComfyUI
+cd ComfyUI/custom_nodes
+git clone https://github.com/ltdrdata/ComfyUI-Manager comfyui-manager
+cd ..
+python -m venv venv
+call venv/Scripts/activate
+python -m pip install torch torchvision torchaudio --extra-index-url https://download.pytorch.org/whl/cu121
+python -m pip install -r requirements.txt
+python -m pip install -r custom_nodes/comfyui-manager/requirements.txt
+cd ..
+echo "cd ComfyUI" >> run_gpu.bat
+echo "call venv/Scripts/activate" >> run_gpu.bat
+echo "python main.py" >> run_gpu.bat
+
+echo "cd ComfyUI" >> run_cpu.bat
+echo "call venv/Scripts/activate" >> run_cpu.bat
+echo "python main.py --cpu" >> run_cpu.bat

scripts/install-manager-for-portable-version.bat

@@ -0,0 +1,3 @@
+.\python_embeded\python.exe -s -m pip install gitpython
+.\python_embeded\python.exe -c "import git; git.Repo.clone_from('https://github.com/ltdrdata/ComfyUI-Manager', './ComfyUI/custom_nodes/comfyui-manager')"
+.\python_embeded\python.exe -m pip install -r ./ComfyUI/custom_nodes/comfyui-manager/requirements.txt

tests/.gitignore

@@ -1,34 +0,0 @@
-# Test environment and artifacts
-
-# Virtual environment
-test_venv/
-venv/
-env/
-
-# pytest cache
-.pytest_cache/
-__pycache__/
-*.pyc
-*.pyo
-
-# Coverage reports (module-specific naming)
-.coverage
-.coverage.*
-htmlcov*/
-coverage*.xml
-*.cover
-
-# Test artifacts
-.tox/
-.hypothesis/
-
-# IDE
-.vscode/
-.idea/
-*.swp
-*.swo
-*~
-
-# OS
-.DS_Store
-Thumbs.db

tests/README.md

@@ -1,181 +0,0 @@
-# ComfyUI Manager Test Suite
-
-This directory contains all tests for the ComfyUI Manager project, organized by module structure.
-
-## Directory Structure
-
-```
-tests/
-├── setup_test_env.sh         # Setup isolated test environment
-├── requirements.txt          # Test dependencies
-├── pytest.ini               # Global pytest configuration
-├── .gitignore              # Ignore test artifacts
-│
-└── common/                 # Tests for comfyui_manager/common/
-    └── pip_util/          # Tests for pip_util.py
-        ├── README.md      # pip_util test documentation
-        ├── conftest.py    # pip_util test fixtures
-        ├── pytest.ini     # pip_util-specific pytest config
-        └── test_*.py      # Actual test files (to be created)
-```
-
-## Quick Start
-
-### 1. Setup Test Environment (One Time)
-
-```bash
-cd tests
-./setup_test_env.sh
-```
-
-This creates an isolated virtual environment with all test dependencies.
-
-### 2. Run Tests
-
-```bash
-# Activate test environment
-source test_venv/bin/activate
-
-# Run all tests from root
-cd tests
-pytest
-
-# Run specific module tests
-cd tests/common/pip_util
-pytest
-
-# Deactivate when done
-deactivate
-```
-
-## Test Organization
-
-Tests mirror the source code structure:
-
-| Source Code | Test Location |
-|-------------|---------------|
-| `comfyui_manager/common/pip_util.py` | `tests/common/pip_util/test_*.py` |
-| `comfyui_manager/common/other.py` | `tests/common/other/test_*.py` |
-| `comfyui_manager/module/file.py` | `tests/module/file/test_*.py` |
-
-## Writing Tests
-
-1. Create test directory matching source structure
-2. Add `conftest.py` for module-specific fixtures
-3. Add `pytest.ini` for module-specific configuration (optional)
-4. Create `test_*.py` files with actual tests
-5. Document in module-specific README
-
-## Test Categories
-
-Use pytest markers to categorize tests:
-
-```python
-@pytest.mark.unit
-def test_simple_function():
-    pass
-
-@pytest.mark.integration
-def test_complex_workflow():
-    pass
-
-@pytest.mark.e2e
-def test_full_system():
-    pass
-```
-
-Run by category:
-```bash
-pytest -m unit           # Only unit tests
-pytest -m integration    # Only integration tests
-pytest -m e2e           # Only end-to-end tests
-```
-
-## Coverage Reports
-
-Coverage reports are generated per module:
-
-```bash
-cd tests/common/pip_util
-pytest  # Generates htmlcov_pip_util/ and coverage_pip_util.xml
-```
-
-## Environment Isolation
-
-**Why use venv?**
-- ✅ Prevents test dependencies from corrupting main environment
-- ✅ Allows safe package installation/uninstallation during tests
-- ✅ Consistent test results across machines
-- ✅ Easy to recreate clean environment
-
-## Available Test Modules
-
-- **[common/pip_util](common/pip_util/)** - Policy-based pip package management system tests
-  - Unit tests for policy loading, parsing, condition evaluation
-  - Integration tests for policy application (60% of tests)
-  - End-to-end workflow tests
-
-## Adding New Test Modules
-
-1. Create directory structure: `tests/module_path/component_name/`
-2. Add `conftest.py` with fixtures
-3. Add `pytest.ini` if needed (optional)
-4. Add `README.md` documenting the tests
-5. Create `test_*.py` files
-
-Example:
-```bash
-mkdir -p tests/data_models/config
-cd tests/data_models/config
-touch conftest.py README.md test_config_loader.py
-```
-
-## CI/CD Integration
-
-Tests are designed to run in CI/CD pipelines:
-
-```yaml
-# Example GitHub Actions
-- name: Setup test environment
-  run: |
-    cd tests
-    ./setup_test_env.sh
-
-- name: Run tests
-  run: |
-    source tests/test_venv/bin/activate
-    pytest tests/
-```
-
-## Troubleshooting
-
-### Import errors
-```bash
-# Make sure venv is activated
-source test_venv/bin/activate
-
-# Verify Python path
-python -c "import sys; print(sys.path)"
-```
-
-### Tests not discovered
-```bash
-# Check pytest configuration
-pytest --collect-only
-
-# Verify test file naming (must start with test_)
-ls test_*.py
-```
-
-### Clean rebuild
-```bash
-# Remove and recreate test environment
-rm -rf test_venv/
-./setup_test_env.sh
-```
-
-## Resources
-
-- **pytest Documentation**: https://docs.pytest.org/
-- **Coverage.py**: https://coverage.readthedocs.io/
-- **Module-specific READMEs**: Check each test module directory

tests/common/pip_util/CONTEXT_FILES_GUIDE.md

@@ -1,423 +0,0 @@
-# Context Files Guide for pip_util Tests
-
-Quick reference for all context files created for extending pip_util tests.
-
----
-
-## 📋 File Overview
-
-| File | Purpose | When to Use |
-|------|---------|-------------|
-| **DEPENDENCY_TREE_CONTEXT.md** | Complete dependency trees with version analysis | Adding new test packages or updating scenarios |
-| **DEPENDENCY_ANALYSIS.md** | Analysis methodology and findings | Understanding why packages were chosen |
-| **TEST_SCENARIOS.md** | Detailed test specifications | Writing new tests or understanding existing ones |
-| **analyze_dependencies.py** | Interactive dependency analyzer | Exploring new packages before adding tests |
-| **requirements-test-base.txt** | Base test environment packages | Setting up or modifying test environment |
-
----
-
-## 🎯 Common Tasks
-
-### Task 1: Adding a New Test Package
-
-**Steps**:
-
-1. **Analyze the package**:
-   ```bash
-   python analyze_dependencies.py NEW_PACKAGE
-   ```
-
-2. **Check size and dependencies**:
-   ```bash
-   ./test_venv/bin/pip download --no-deps NEW_PACKAGE
-   ls -lh NEW_PACKAGE*.whl  # Check size
-   ```
-
-3. **Verify dependency tree**:
-   - Open **DEPENDENCY_TREE_CONTEXT.md**
-   - Follow "Adding New Test Scenarios" section
-   - Document findings in the file
-
-4. **Update requirements** (if pre-installation needed):
-   - Add to `requirements-test-base.txt`
-   - Run `./setup_test_env.sh` to recreate venv
-
-5. **Write test**:
-   - Follow patterns in `test_dependency_protection.py`
-   - Use `reset_test_venv` fixture
-   - Add scenario to **TEST_SCENARIOS.md**
-
-6. **Verify**:
-   ```bash
-   pytest test_YOUR_NEW_TEST.py -v --override-ini="addopts="
-   ```
-
----
-
-### Task 2: Understanding Existing Tests
-
-**Steps**:
-
-1. **Read test scenario**:
-   - Open **TEST_SCENARIOS.md**
-   - Find your scenario (1-6)
-   - Review initial state, action, expected result
-
-2. **Check dependency details**:
-   - Open **DEPENDENCY_TREE_CONTEXT.md**
-   - Look up package in table of contents
-   - Review dependency tree and version analysis
-
-3. **Run analysis**:
-   ```bash
-   python analyze_dependencies.py PACKAGE
-   ```
-
-4. **Examine test code**:
-   - Open relevant test file
-   - Check policy fixture
-   - Review assertions
-
----
-
-### Task 3: Updating for New Package Versions
-
-**When**: PyPI releases major version updates (e.g., urllib3 3.0)
-
-**Steps**:
-
-1. **Check current environment**:
-   ```bash
-   python analyze_dependencies.py --env
-   ```
-
-2. **Analyze new versions**:
-   ```bash
-   ./test_venv/bin/pip index versions PACKAGE | head -20
-   python analyze_dependencies.py PACKAGE
-   ```
-
-3. **Update context files**:
-   - Update version numbers in **DEPENDENCY_TREE_CONTEXT.md**
-   - Update "Version Analysis" section
-   - Document breaking changes
-
-4. **Test with new versions**:
-   - Update `requirements-test-base.txt` (if testing new base version)
-   - OR update test to verify protection from new version
-   - Run tests to verify behavior
-
-5. **Update scenarios**:
-   - Update **TEST_SCENARIOS.md** with new version numbers
-   - Update expected results if behavior changed
-
----
-
-### Task 4: Debugging Dependency Issues
-
-**Problem**: Test fails with unexpected dependency versions
-
-**Steps**:
-
-1. **Check what's installed**:
-   ```bash
-   ./test_venv/bin/pip freeze | grep -E "(urllib3|certifi|six|requests)"
-   ```
-
-2. **Analyze what would install**:
-   ```bash
-   python analyze_dependencies.py PACKAGE
-   ```
-
-3. **Compare with expected**:
-   - Open **DEPENDENCY_TREE_CONTEXT.md**
-   - Check "Install Scenarios" for the package
-   - Compare actual vs. expected
-
-4. **Check for PyPI changes**:
-   ```bash
-   ./test_venv/bin/pip index versions PACKAGE
-   ```
-
-5. **Verify test environment**:
-   ```bash
-   rm -rf test_venv && ./setup_test_env.sh
-   pytest test_FILE.py -v --override-ini="addopts="
-   ```
-
----
-
-## 📚 Context File Details
-
-### DEPENDENCY_TREE_CONTEXT.md
-
-**Contents**:
-- Current test environment snapshot
-- Complete dependency trees for all test packages
-- Version analysis (current vs. latest)
-- Upgrade scenarios matrix
-- Guidelines for adding new scenarios
-- Quick reference tables
-
-**Use when**:
-- Adding new test package
-- Understanding why a package was chosen
-- Checking version compatibility
-- Updating for new PyPI releases
-
-**Key sections**:
-- Package Dependency Trees → See what each package depends on
-- Version Analysis → Understand version gaps and breaking changes
-- Adding New Test Scenarios → Step-by-step guide
-
----
-
-### DEPENDENCY_ANALYSIS.md
-
-**Contents**:
-- Detailed analysis of each test scenario
-- Real dependency verification using `pip --dry-run`
-- Version difference analysis
-- Rejected scenarios (and why)
-- Package size verification
-- Recommendations for implementation
-
-**Use when**:
-- Understanding test design decisions
-- Evaluating new package candidates
-- Reviewing why certain packages were rejected
-- Learning the analysis methodology
-
-**Key sections**:
-- Test Scenarios with Real Dependencies → Detailed scenarios
-- Rejected Scenarios → What NOT to use (e.g., click+colorama)
-- Validation Commands → How to verify analysis
-
----
-
-### TEST_SCENARIOS.md
-
-**Contents**:
-- Complete specifications for scenarios 1-6
-- Exact package versions and states
-- Policy configurations (JSON)
-- Expected pip commands
-- Expected final states
-- Key points for each scenario
-
-**Use when**:
-- Writing new tests
-- Understanding test expectations
-- Debugging test failures
-- Documenting new scenarios
-
-**Key sections**:
-- Each scenario section → Complete specification
-- Summary tables → Quick reference
-- Policy types summary → Available policy options
-
----
-
-### analyze_dependencies.py
-
-**Features**:
-- Interactive package analysis
-- Dry-run simulation
-- Version comparison
-- Pin impact analysis
-
-**Use when**:
-- Exploring new packages
-- Verifying current environment
-- Checking upgrade impacts
-- Quick dependency checks
-
-**Commands**:
-```bash
-# Analyze specific package
-python analyze_dependencies.py requests
-
-# Analyze all test packages
-python analyze_dependencies.py --all
-
-# Show current environment
-python analyze_dependencies.py --env
-```
-
----
-
-### requirements-test-base.txt
-
-**Contents**:
-- Base packages for test environment
-- Version specifications
-- Comments explaining each package's purpose
-
-**Use when**:
-- Setting up test environment
-- Adding pre-installed packages
-- Modifying base versions
-- Recreating clean environment
-
-**Format**:
-```txt
-# Scenario X: Purpose
-package==version  # Comment explaining role
-```
-
----
-
-## 🔄 Workflow Examples
-
-### Example 1: Adding flask Test
-
-```bash
-# 1. Analyze flask
-python analyze_dependencies.py flask
-
-# Output shows:
-#   Would install: Flask, Jinja2, MarkupSafe, Werkzeug, blinker, click, itsdangerous
-
-# 2. Check sizes
-./test_venv/bin/pip download --no-deps flask jinja2 werkzeug
-ls -lh *.whl
-
-# 3. Document in DEPENDENCY_TREE_CONTEXT.md
-# Add section:
-### 3. flask → Dependencies
-**Package**: `flask==3.1.2`
-**Size**: ~100KB
-...
-
-# 4. Write test
-# Create test_flask_dependencies.py
-
-# 5. Test
-pytest test_flask_dependencies.py -v --override-ini="addopts="
-```
-
----
-
-### Example 2: Investigating Test Failure
-
-```bash
-# Test failed: "urllib3 version mismatch"
-
-# 1. Check installed
-./test_venv/bin/pip freeze | grep urllib3
-# Output: urllib3==2.5.0  (expected: 1.26.15)
-
-# 2. Analyze what happened
-python analyze_dependencies.py requests
-
-# 3. Check context
-# Open DEPENDENCY_TREE_CONTEXT.md
-# Section: "urllib3: Major Version Jump"
-# Confirms: 1.26.15 → 2.5.0 is expected without pin
-
-# 4. Verify test has pin
-# Check test_dependency_protection.py for pin_policy fixture
-
-# 5. Reset environment
-rm -rf test_venv && ./setup_test_env.sh
-
-# 6. Re-run test
-pytest test_dependency_protection.py -v --override-ini="addopts="
-```
-
----
-
-## 🎓 Best Practices
-
-### When Adding New Tests
-
-✅ **DO**:
-- Use `analyze_dependencies.py` first
-- Document in **DEPENDENCY_TREE_CONTEXT.md**
-- Add scenario to **TEST_SCENARIOS.md**
-- Verify with real pip operations
-- Keep packages lightweight (<500KB total)
-
-❌ **DON'T**:
-- Add packages without verifying dependencies
-- Use packages with optional dependencies only
-- Add heavy packages (>1MB)
-- Skip documentation
-- Mock subprocess for integration tests
-
----
-
-### When Updating Context
-
-✅ **DO**:
-- Re-run `analyze_dependencies.py --all`
-- Update version numbers throughout
-- Document breaking changes
-- Test after updates
-- Note update date
-
-❌ **DON'T**:
-- Update only one file
-- Skip verification
-- Forget to update TEST_SCENARIOS.md
-- Leave outdated version numbers
-
----
-
-## 🆘 Quick Troubleshooting
-
-| Problem | Check | Solution |
-|---------|-------|----------|
-| Test fails with version mismatch | `pip freeze` | Recreate venv with `./setup_test_env.sh` |
-| Package not found | `pip index versions PKG` | Check if package exists on PyPI |
-| Unexpected dependencies | `analyze_dependencies.py PKG` | Review dependency tree in context file |
-| Wrong test data | **TEST_SCENARIOS.md** | Verify against documented scenario |
-| Unclear why package chosen | **DEPENDENCY_ANALYSIS.md** | Read "Rejected Scenarios" section |
-
----
-
-## 📞 Need Help?
-
-1. **Check context files first**: Most answers are documented
-2. **Run analyze_dependencies.py**: Verify current state
-3. **Review test scenarios**: Understand expected behavior
-4. **Examine dependency trees**: Understand relationships
-5. **Check DEPENDENCY_ANALYSIS.md**: Learn the "why" behind decisions
-
----
-
-## 📝 Maintenance Checklist
-
-**Every 6 months or when major versions release**:
-
-- [ ] Run `python analyze_dependencies.py --all`
-- [ ] Check for new major versions: `pip index versions urllib3 certifi six`
-- [ ] Update **DEPENDENCY_TREE_CONTEXT.md** version numbers
-- [ ] Update **TEST_SCENARIOS.md** expected versions
-- [ ] Test all scenarios: `pytest -v --override-ini="addopts="`
-- [ ] Document any breaking changes
-- [ ] Update this guide if workflow changed
-
----
-
-## 🔗 File Relationships
-
-```
-requirements-test-base.txt
-    ↓ (defines)
-Current Test Environment
-    ↓ (analyzed by)
-analyze_dependencies.py
-    ↓ (documents)
-DEPENDENCY_TREE_CONTEXT.md
-    ↓ (informs)
-TEST_SCENARIOS.md
-    ↓ (implemented in)
-test_*.py files
-```
-
----
-
-**Last Updated**: 2025-10-01
-**Python Version**: 3.12.3
-**pip Version**: 25.2

tests/common/pip_util/DEPENDENCY_ANALYSIS.md

@@ -1,261 +0,0 @@
-# pip_util Test Package Dependency Analysis
-
-Real dependency analysis using `pip install --dry-run` to verify meaningful test scenarios.
-
-## Analysis Date
-
-Generated: 2025-10-01
-Tool: `pip install --dry-run --ignore-installed`
-
-## Test Scenarios with Real Dependencies
-
-### Scenario 1: Dependency Version Protection (requests + urllib3)
-
-**Purpose**: Verify pin_dependencies prevents unwanted upgrades
-
-**Initial Environment**:
-```
-urllib3==1.26.15
-certifi==2023.7.22
-charset-normalizer==3.2.0
-```
-
-**Without pin** (`pip install requests`):
-```bash
-Would install:
-  certifi-2025.8.3          # UPGRADED from 2023.7.22 (+2 years)
-  charset-normalizer-3.4.3  # UPGRADED from 3.2.0 (minor)
-  idna-3.10                 # NEW dependency
-  requests-2.32.5           # NEW package
-  urllib3-2.5.0             # UPGRADED from 1.26.15 (MAJOR 1.x→2.x!)
-```
-
-**With pin** (`pip install requests urllib3==1.26.15 certifi==2023.7.22 charset-normalizer==3.2.0`):
-```bash
-Would install:
-  idna-3.10          # NEW dependency (required by requests)
-  requests-2.32.5    # NEW package
-
-# Pinned packages stay at old versions:
-  urllib3==1.26.15              ✅ PROTECTED (prevented 1.x→2.x jump)
-  certifi==2023.7.22            ✅ PROTECTED
-  charset-normalizer==3.2.0     ✅ PROTECTED
-```
-
-**Key Finding**:
-- `urllib3` 1.26.15 → 2.5.0 is a **MAJOR version jump** (breaking changes!)
-- requests accepts both: `urllib3<3,>=1.21.1` (compatible with 1.x and 2.x)
-- Pin successfully prevents unwanted major upgrade
-
----
-
-### Scenario 2: Package with Dependency (python-dateutil + six)
-
-**Purpose**: Verify pin_dependencies with dependency chain
-
-**Analysis**:
-```bash
-$ pip install --dry-run python-dateutil
-
-Would install:
-  python-dateutil-2.9.0.post0
-  six-1.17.0  # DEPENDENCY
-```
-
-**Initial Environment**:
-```
-six==1.16.0  # Older version
-```
-
-**Without pin** (`pip install python-dateutil`):
-```bash
-Would install:
-  python-dateutil-2.9.0.post0
-  six-1.17.0  # UPGRADED from 1.16.0
-```
-
-**With pin** (`pip install python-dateutil six==1.16.0`):
-```bash
-Would install:
-  python-dateutil-2.9.0.post0
-
-# Pinned package:
-  six==1.16.0  ✅ PROTECTED
-```
-
----
-
-### Scenario 3: Package Deletion and Restore (six)
-
-**Purpose**: Verify restore policy reinstalls deleted packages
-
-**Initial Environment**:
-```
-six==1.16.0
-attrs==23.1.0
-packaging==23.1
-```
-
-**Action Sequence**:
-1. Delete six: `pip uninstall -y six`
-2. Verify deletion: `pip freeze | grep six` (empty)
-3. Restore: `batch.ensure_installed()` → `pip install six==1.16.0`
-
-**Expected Result**:
-```
-six==1.16.0  # ✅ RESTORED
-```
-
----
-
-### Scenario 4: Version Change and Restore (urllib3)
-
-**Purpose**: Verify restore policy reverts version changes
-
-**Initial Environment**:
-```
-urllib3==1.26.15
-```
-
-**Action Sequence**:
-1. Upgrade: `pip install urllib3==2.5.0`
-2. Verify change: `pip freeze | grep urllib3` → `urllib3==2.5.0`
-3. Restore: `batch.ensure_installed()` → `pip install urllib3==1.26.15`
-
-**Expected Result**:
-```
-urllib3==1.26.15  # ✅ RESTORED (downgraded from 2.5.0)
-```
-
-**Key Finding**:
-- Downgrade from 2.x to 1.x requires explicit version specification
-- pip allows downgrades with `pip install urllib3==1.26.15`
-
----
-
-## Rejected Scenarios
-
-### click + colorama (NO REAL DEPENDENCY)
-
-**Analysis**:
-```bash
-$ pip install --dry-run click
-Would install: click-8.3.0
-
-$ pip install --dry-run click colorama==0.4.6
-Would install: click-8.3.0  # colorama not installed!
-```
-
-**Finding**: click has **NO direct dependency** on colorama
-- colorama is **optional** and platform-specific (Windows only)
-- Not a good test case for dependency protection
-
-**Recommendation**: Use python-dateutil + six instead
-
----
-
-## Package Size Verification
-
-```bash
-Package                Size    Version    Purpose
--------------------------------------------------------
-urllib3               ~140KB  1.26.15    Protected dependency
-certifi               ~158KB  2023.7.22  SSL certificates
-charset-normalizer    ~46KB   3.2.0      Charset detection
-idna                  ~69KB   3.10       NEW dep from requests
-requests              ~100KB  2.32.5     Main package to install
-six                   ~11KB   1.16.0     Restore test
-python-dateutil       ~280KB  2.9.0      Depends on six
-attrs                 ~61KB   23.1.0     Bystander
-packaging             ~48KB   23.1       Bystander
--------------------------------------------------------
-Total                 ~913KB  (< 1MB)    ✅ All lightweight
-```
-
----
-
-## Dependency Graph
-
-```
-requests 2.32.5
-├── charset_normalizer<4,>=2  (have: 3.2.0)
-├── idna<4,>=2.5              (need: 3.10)  ← NEW
-├── urllib3<3,>=1.21.1        (have: 1.26.15, latest: 2.5.0)
-└── certifi>=2017.4.17        (have: 2023.7.22, latest: 2025.8.3)
-
-python-dateutil 2.9.0
-└── six>=1.5                  (have: 1.16.0, latest: 1.17.0)
-```
-
----
-
-## Version Compatibility Matrix
-
-| Package | Old Version | Latest | Spec | Compatible? |
-|---------|------------|--------|------|-------------|
-| urllib3 | 1.26.15 | 2.5.0 | <3,>=1.21.1 | ✅ Both work |
-| certifi | 2023.7.22 | 2025.8.3 | >=2017.4.17 | ✅ Both work |
-| charset-normalizer | 3.2.0 | 3.4.3 | <4,>=2 | ✅ Both work |
-| six | 1.16.0 | 1.17.0 | >=1.5 | ✅ Both work |
-| idna | (none) | 3.10 | <4,>=2.5 | ⚠️ Must install |
-
----
-
-## Test Data Justification
-
-### Why urllib3 1.26.15?
-1. **Real world scenario**: Many projects pin urllib3<2 to avoid breaking changes
-2. **Meaningful test**: 1.26.15 → 2.5.0 is a major version jump (API changes)
-3. **Compatibility**: requests accepts both 1.x and 2.x (good for testing)
-
-### Why certifi 2023.7.22?
-1. **Real world scenario**: Older environment with outdated SSL certificates
-2. **Meaningful test**: 2-year version gap (2023 → 2025)
-3. **Safety**: Still compatible with requests
-
-### Why six 1.16.0?
-1. **Lightweight**: Only 11KB
-2. **Real dependency**: python-dateutil actually depends on it
-3. **Stable**: six is mature and rarely changes
-
----
-
-## Recommendations for Test Implementation
-
-### ✅ Keep These Scenarios:
-1. **requests + urllib3 pin** - Real major version protection
-2. **python-dateutil + six** - Real dependency chain
-3. **six deletion/restore** - Real package management
-4. **urllib3 version change** - Real downgrade scenario
-
-### ❌ Remove These Scenarios:
-1. **click + colorama** - No real dependency (colorama is optional/Windows-only)
-
-### 📝 Update Required Files:
-1. `requirements-test-base.txt` - Add idna (new dependency from requests)
-2. `TEST_SCENARIOS.md` - Update with real dependency analysis
-3. `test_dependency_protection.py` - Remove click-colorama test
-4. `pip_util.design.en.md` - Update examples with verified dependencies
-
----
-
-## Validation Commands
-
-Run these to verify analysis:
-
-```bash
-# Check current environment
-./test_venv/bin/pip freeze
-
-# Simulate requests installation without pin
-./test_venv/bin/pip install --dry-run requests
-
-# Simulate requests installation with pin
-./test_venv/bin/pip install --dry-run requests urllib3==1.26.15 certifi==2023.7.22 charset-normalizer==3.2.0
-
-# Check python-dateutil dependencies
-./test_venv/bin/pip install --dry-run python-dateutil
-
-# Verify urllib3 version availability
-./test_venv/bin/pip index versions urllib3 | head -20
-```