Upload 1664 files

Custom nodes implemented thanks to @Agoodjoe2 on X.

.gitattributes

@@ -53,3 +53,13 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.jpg filter=lfs diff=lfs merge=lfs -text
 *.jpeg filter=lfs diff=lfs merge=lfs -text
 *.webp filter=lfs diff=lfs merge=lfs -text
+custom_nodes/comfyui_controlnet_aux/NotoSans-Regular.ttf filter=lfs diff=lfs merge=lfs -text
+custom_nodes/comfyui_controlnet_aux/src/custom_controlnet_aux/mesh_graphormer/hand_landmarker.task filter=lfs diff=lfs merge=lfs -text
+custom_nodes/comfyui-elegant-resource-monitor/web/assets/css/material.woff2 filter=lfs diff=lfs merge=lfs -text
+custom_nodes/comfyui-impact-pack/modules/impact/__pycache__/core.cpython-312.pyc filter=lfs diff=lfs merge=lfs -text
+custom_nodes/comfyui-impact-pack/modules/impact/__pycache__/impact_pack.cpython-312.pyc filter=lfs diff=lfs merge=lfs -text
+custom_nodes/comfyui-kjnodes/fonts/FreeMono.ttf filter=lfs diff=lfs merge=lfs -text
+custom_nodes/comfyui-kjnodes/fonts/FreeMonoBoldOblique.otf filter=lfs diff=lfs merge=lfs -text
+custom_nodes/comfyui-kjnodes/fonts/TTNorms-Black.otf filter=lfs diff=lfs merge=lfs -text
+custom_nodes/comfyui-kjnodes/nodes/__pycache__/image_nodes.cpython-312.pyc filter=lfs diff=lfs merge=lfs -text
+custom_nodes/comfyui-kjnodes/nodes/__pycache__/nodes.cpython-312.pyc filter=lfs diff=lfs merge=lfs -text

custom_nodes/ComfyUI-Crystools/.editorconfig

@@ -0,0 +1,20 @@
+# EditorConfig helps developers define and maintain consistent
+# coding styles between different editors and IDEs
+# editorconfig.org
+
+root = true
+
+[*]
+# Change these settings to your own preference
+indent_style = space
+indent_size = 2
+max_line_length = 120
+
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+max_line_length = off
+trim_trailing_whitespace = false

custom_nodes/ComfyUI-Crystools/.eslintrc.cjs

@@ -0,0 +1,164 @@
+module.exports = {
+  root: true,
+  env: { browser: true, es2020: true },
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:@typescript-eslint/recommended-type-checked',
+    'plugin:@typescript-eslint/stylistic-type-checked'
+  ],
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint', 'import'],
+  parserOptions: {
+    // tsconfigRootDir: __dirname,
+    sourceType: 'module',
+    ecmaVersion: 'latest',
+    ecmaFeatures: {
+      // experimentalObjectRestSpread: true,
+      modules: true,
+      legacyDecorators: true
+    },
+    project: ['./tsconfig.json'],
+  },
+  rules: {
+    // 'import/extensions': [
+    //   'error',
+    //   "ignorePackages",
+    //   {
+    //     "js": "always",
+    //     "ts": "never"
+    //   }
+    // ],
+    'import/no-unresolved': ['off'],
+    'class-methods-use-this': ['off'],
+    'radix': ['off'],
+    'import/prefer-default-export': ['off'],
+    'implicit-arrow-linebreak': ['off'],
+    'no-trailing-spaces': [
+      'error', {
+        'skipBlankLines': true,
+        'ignoreComments': true,
+      },
+    ],
+    'max-len': [
+      'error', {
+        'code': 120,
+      },
+    ],
+    'prefer-rest-params': ['off'],
+
+    'import/no-extraneous-dependencies': [
+      'error', {
+        'devDependencies': ['**/__tests__/*.ts', '**/__mocks__/*.ts'],
+      },
+    ],
+
+    'one-var': ['off'],
+
+    // false positive https://github.com/typescript-eslint/typescript-eslint/issues/2483
+    'no-shadow': 'off',
+    'object-curly-newline': ["error", {
+      "ObjectExpression": { "multiline": true, "minProperties": 8 },
+      "ObjectPattern": { "multiline": true, "minProperties": 8 },
+      "ImportDeclaration": {"multiline": true, "minProperties": 8 },
+      "ExportDeclaration": { "multiline": true, "minProperties": 8 }
+    }],
+    "@typescript-eslint/explicit-function-return-type": 'error',
+    '@typescript-eslint/triple-slash-reference': 'off',
+    '@typescript-eslint/no-shadow': 'error',
+    '@typescript-eslint/no-unsafe-argument': 'off',
+    '@typescript-eslint/no-unsafe-assignment': 'off',
+    '@typescript-eslint/no-unsafe-member-access': 'off',
+    '@typescript-eslint/no-unsafe-return': 'off',
+    '@typescript-eslint/no-unsafe-call': 'off',
+    '@typescript-eslint/prefer-nullish-coalescing': 'off',
+    '@typescript-eslint/consistent-type-definitions': 'off',
+    '@typescript-eslint/no-unused-expressions': [
+      'error',
+      {
+        'allowShortCircuit': true,
+        'allowTernary': true,
+      },
+    ],
+    '@typescript-eslint/no-use-before-define': ['off'],
+    '@typescript-eslint/no-unused-vars': [
+      'error',
+      {'argsIgnorePattern': '^_'},
+    ],
+    '@typescript-eslint/explicit-module-boundary-types': [
+      'off', {
+        allowArgumentsExplicitlyTypedAsAny: true,
+      },
+    ],
+    '@typescript-eslint/no-explicit-any': 'off',
+    '@typescript-eslint/ban-ts-comment': [
+      'off',
+      {'ts-expect-error': 'allow-with-description'},
+    ],
+    '@typescript-eslint/no-empty-function': [
+      'error',
+      {
+        'allow': [
+          'methods',
+          'asyncMethods',
+        ],
+      },
+    ],
+
+    'lines-between-class-members': 'off',
+    '@typescript-eslint/lines-between-class-members': 'off',
+
+    'curly': ['error', 'multi-line', 'consistent'],
+    'no-unused-vars': 'off',
+    'jest/no-test-prefixes': 'off',
+    'jest/no-focused-tests': 'off',
+    'comma-dangle': ['error', 'only-multiline'],
+    'linebreak-style': ['error', 'unix'],
+    'quotes': ['error', 'single'],
+    'semi': ['error', 'always'],
+    'eqeqeq': ['error', 'always'],
+    'complexity': [
+      'error', {
+        max: 8,
+      },
+    ],
+    'block-scoped-var': 'error',
+    'no-else-return': [
+      'error', {
+        allowElseIf: true,
+      },
+    ],
+    'no-debugger': 'off',
+    'no-eval': 'error',
+    'no-lone-blocks': 'error',
+    'no-multi-spaces': 'error',
+    'no-useless-return': 'error',
+    'no-var': 'error',
+    'no-console': [
+      // 'error', {
+      //   allow: ['warn', 'error'],
+      // },
+      'off',
+    ],
+    'no-throw-literal': 'error',
+    'newline-per-chained-call': [
+      'error', {
+        ignoreChainWithDepth: 4,
+      },
+    ],
+    'no-extra-boolean-cast': [
+      'error', {
+        enforceForLogicalOperands: true,
+      },
+    ],
+    'no-fallthrough': 'error',
+    'no-use-before-define': 'off',
+    'no-case-declarations': 'off',
+  },
+  ignorePatterns: [
+    'node_modules',
+    'web/**/*.d.ts',
+    'web/**/*.js'
+  ],
+  globals: {},
+}

custom_nodes/ComfyUI-Crystools/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,47 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Describe the bug**  
+A clear and concise description of what the bug is.
+
+**To Reproduce**  
+__Please attach a workflow file to make it easier for others to reproduce the error!__
+
+**Expected behavior**  
+A clear and concise description of what you expected to happen.
+
+**Screenshots**  
+If applicable, add screenshots to help explain your problem.
+
+**Error in console:**  
+If applicable, add the error message from the console.
+
+**Versions:**  
+Copy the output of the console (4 parts), like this:
+```
+** Python version: 3.10.11 (tags/v3.10.11:7d4cc5a, Apr  5 2023, 00:38:17) [MSC v.1929 64 bit (AMD64)]
+```
+```
+Total VRAM 12287 MB, total RAM 130996 MB
+Set vram state to: NORMAL_VRAM
+```
+```
+[Crystools INFO] Crystools version: 1.9.2
+[Crystools INFO] CPU: AMD Ryzen 9 5950X 16-Core Processor - Arch: AMD64 - OS: Windows 10
+[Crystools INFO] GPU/s:
+[Crystools INFO] 0) NVIDIA GeForce RTX 3080 Ti
+[Crystools INFO] NVIDIA Driver: 546.33
+```
+```
+### Loading: ComfyUI-Manager (V1.25.3)
+### ComfyUI Revision: 1886 [6a10640f] | Released on '2024-01-08'
+```
+
+**Additional context**  
+Add any other context about the problem here.

custom_nodes/ComfyUI-Crystools/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

custom_nodes/ComfyUI-Crystools/.github/workflows/publish.yml

@@ -0,0 +1,24 @@
+name: Publish to Comfy registry
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+    paths:
+      - "pyproject.toml"
+
+permissions:
+  issues: write
+
+jobs:
+  publish-node:
+    name: Publish Custom Node to registry
+    runs-on: ubuntu-latest
+    if: ${{ github.repository_owner == 'crystian' }}
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+      - name: Publish Custom Node
+        uses: Comfy-Org/publish-node-action@v1
+        with:
+          personal_access_token: ${{ secrets.REGISTRY_ACCESS_TOKEN }}

custom_nodes/ComfyUI-Crystools/.gitignore

@@ -0,0 +1,156 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintainted in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+*.pyc
+
+.idea
+/node_modules
+/node.zip

custom_nodes/ComfyUI-Crystools/.others/ComfyUI.run.xml

@@ -0,0 +1,25 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="ComfyUI" type="PythonConfigurationType" factoryName="Python">
+    <module name="ComfyUI" />
+    <option name="ENV_FILES" value="" />
+    <option name="INTERPRETER_OPTIONS" value="" />
+    <option name="PARENT_ENVS" value="true" />
+    <envs>
+      <env name="PYTHONUNBUFFERED" value="1" />
+      <env name="CRYSTOOLS_LOGLEVEL" value="10" />
+    </envs>
+    <option name="SDK_HOME" value="" />
+    <option name="WORKING_DIRECTORY" value="X:\comfy\ComfyUI" />
+    <option name="IS_MODULE_SDK" value="true" />
+    <option name="ADD_CONTENT_ROOTS" value="true" />
+    <option name="ADD_SOURCE_ROOTS" value="true" />
+    <option name="SCRIPT_NAME" value="$PROJECT_DIR$/main.py" />
+    <option name="PARAMETERS" value="--extra-model-paths-config ..\extra_model_paths.yaml --output-directory ..\..\comfyUI.output --input-directory ..\..\comfyUI.input --disable-auto-launch --preview-size 1024 --front-end-version aComfy-Org/ComfyUI_frontend@latest" />
+    <option name="SHOW_COMMAND_LINE" value="false" />
+    <option name="EMULATE_TERMINAL" value="false" />
+    <option name="MODULE_MODE" value="false" />
+    <option name="REDIRECT_INPUT" value="false" />
+    <option name="INPUT_FILE" value="" />
+    <method v="2" />
+  </configuration>
+</component>

custom_nodes/ComfyUI-Crystools/.others/lint.run.xml

@@ -0,0 +1,12 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="lint" type="js.build_tools.npm">
+    <package-json value="$PROJECT_DIR$/custom_nodes/comfyui-crystools/package.json" />
+    <command value="run" />
+    <scripts>
+      <script value="lint" />
+    </scripts>
+    <node-interpreter value="project" />
+    <envs />
+    <method v="2" />
+  </configuration>
+</component>

custom_nodes/ComfyUI-Crystools/.others/pre-commit

@@ -0,0 +1,33 @@
+#!/bin/bash
+# REMEMBER TO COPY THIS FILE INTO .git/hooks/pre-commit
+
+cd ../comfy/ComfyUI
+rm ./custom_nodes/comfyui-crystools/web/*.js -f
+
+LOCAL_COMMAND="npm --prefix ./custom_nodes/comfyui-crystools run validate"
+OUTPUT=$($LOCAL_COMMAND 2>&1)
+EXIT_CODE=$?
+
+if [ $EXIT_CODE -eq 0 ]; then
+    echo "Validate ok"
+    cd ../../comfyui-crystools
+else
+    echo "Validate KO!"
+    echo $OUTPUT
+    exit 1
+fi
+
+LOCAL_COMMAND="python .others/version.py"
+
+OUTPUT=$($LOCAL_COMMAND 2>&1)
+EXIT_CODE=$?
+
+if [ $EXIT_CODE -eq 0 ]; then
+    echo "Version changed"
+else
+    echo "Can't change the version! check the .other/version.py"
+    echo $OUTPUT
+    exit 1
+fi
+
+git add version pyproject.toml __init__.py core/version.py web/*.js

custom_nodes/ComfyUI-Crystools/.others/typescript.run.xml

@@ -0,0 +1,12 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="typescript" type="js.build_tools.npm">
+    <package-json value="$PROJECT_DIR$/package.json" />
+    <command value="run" />
+    <scripts>
+      <script value="start" />
+    </scripts>
+    <node-interpreter value="W:/!Workstation/nodejs/node" />
+    <envs />
+    <method v="2" />
+  </configuration>
+</component>

custom_nodes/ComfyUI-Crystools/.others/version.py

@@ -0,0 +1,60 @@
+import os
+
+print("-- Setting up the version --")
+
+versionLabel = "@version:"
+version_file = os.path.join(os.path.dirname(__file__), "../version")
+
+with open(version_file, "r") as f:
+    version = f.read().strip()
+
+if version is None or version == "":
+    raise RuntimeError(f"File without version: {version_file}")
+
+print(f"Version to set: {version}")
+
+# modify the __init__.py file with @version
+file1 = os.path.join(os.path.dirname(__file__), "../__init__.py")
+print(f"> File1: {file1}")
+
+file1VersionFound = False
+# lines = None
+with open(file1, "r") as f:
+    lines = f.readlines()
+    for line in lines:
+        if versionLabel in line:
+            file1VersionFound = True
+            lines[lines.index(line)] = f"{versionLabel} {version}\n"
+
+if not file1VersionFound:
+    raise RuntimeError(f"Version label not found in file: {file1}")
+
+with open(file1, "w") as f2:
+    f2.writelines(lines)
+
+file2 = os.path.join(os.path.dirname(__file__), "../core/version.py")
+print(f"> File2 {file2}")
+
+with open(file2, "w") as f2:
+    f2.writelines([f"version = \"{version}\"\n"])
+
+
+# modify pyproject.toml file with @version
+file3 = os.path.join(os.path.dirname(__file__), "../pyproject.toml")
+print(f"> File3: {file3}")
+
+file3VersionFound = False
+# lines = None
+with open(file3, "r") as f:
+    lines = f.readlines()
+    for line in lines:
+
+        if "version = " in line:
+            file3VersionFound = True
+            lines[lines.index(line)] = f"version = \"{version}\"\n"
+
+if not file3VersionFound:
+    raise RuntimeError(f"Version label not found in file: {file3}")
+
+with open(file3, "w") as f3:
+    f3.writelines(lines)

custom_nodes/ComfyUI-Crystools/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Crystian
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

custom_nodes/ComfyUI-Crystools/README.md

@@ -0,0 +1,672 @@
+# comfyui-crystools [![Donate](https://img.shields.io/badge/Donate-PayPal-blue.svg)](https://paypal.me/crystian77) <a src="https://colab.research.google.com/assets/colab-badge.svg" href="https://colab.research.google.com/drive/1xiTiPmZkcIqNOsLQPO1UNCdJZqgK3U5k?usp=sharing"><img src="https://colab.research.google.com/assets/colab-badge.svg" alt="Open in Colab"></a>
+
+**_🪛 A powerful set of tools for your belt when you work with ComfyUI 🪛_**
+
+With this suit, you can see the resources monitor, progress bar & time elapsed, metadata and compare between two images, compare between two JSONs, show any value to console/display, pipes, and more!
+This provides better nodes to load/save images, previews, etc, and see "hidden" data without loading a new workflow.
+
+![Show metadata](./docs/jake.gif)
+
+# Table of contents
+- [General](#general)
+- [Metadata](#metadata)
+- [Debugger](#debugger)
+- [Image](#image)
+- [Pipe](#pipe)
+- [Utils](#utils)
+- [Primitives](#primitives)
+- [List](#list)
+- [Switch](#switch)
+- Others: [About](#about), [To do](#to-do), [Changelog](#changelog), [Installation](#installation), [Use](#use)
+
+---
+
+## General
+
+### Resources monitor
+
+**🎉Finally, you can see the resources used by ComfyUI (CPU, GPU, RAM, VRAM, GPU Temp and space) on the menu in real-time!**
+
+Horizontal:  
+![Monitors](./docs/monitor1.webp)
+
+Vertical:  
+![Monitors](./docs/monitor3.webp)
+
+Now you can identify the bottlenecks in your workflow and know when it's time to restart the server, unload models or even close some tabs!
+
+You can configure the refresh rate which resources to show:
+
+![Monitors](./docs/monitor-settings.png)
+
+> **Notes:**
+> - The GPU data is only available when you use CUDA (only NVIDIA cards, sorry AMD users).
+> - This extension needs ComfyUI 1915 (or higher).
+> - The cost of the monitor is low (0.1 to 0.5% of utilization), you can disable it from settings (`Refres rate` to `0`).
+> - Data comes from these libraries:
+>   - [psutil](https://pypi.org/project/psutil/)
+>   - [torch](https://pytorch.org/)
+>   - [pynvml](https://pypi.org/project/pynvml/) (official NVIDIA library)
+
+
+### Progress bar
+
+You can see the progress of your workflow with a progress bar on the menu!
+
+![Progress bar](./docs/progress-bar.png)
+
+https://github.com/crystian/comfyui-crystools/assets/3886806/35cc1257-2199-4b85-936e-2e31d892959c
+
+Additionally, it shows the time elapsed at the end of the workflow, and you can `click` on it to see the **current working node.** 
+
+> **Notes:**
+> - If you don't want to see it, you can turn it off from settings (`Show progress bar in menu`)
+
+
+## Metadata
+
+### Node: Metadata extractor
+
+This node is used to extract the metadata from the image and handle it as a JSON source for other nodes.  
+You can see **all information**, even metadata from other sources (like Photoshop, see sample).
+
+The input comes from the [load image with metadata](#node-load-image-with-metadata) or [preview from image](#node-preview-from-image) nodes (and others in the future).
+
+![Metadata extractor](./docs/metadata-extractor.png)
+
+**Sample:** [metadata-extractor.json](./samples/metadata-extractor.json)
+
+><details>
+>  <summary>Other metadata sample (photoshop)</summary>
+> 
+> With metadata from Photoshop
+![Metadata extractor](./docs/metadata-extractor-photoshop.png)
+></details>
+
+><details>
+>  <summary><i>Parameters</i></summary>
+>
+> - input: 
+>   - metadata_raw: The metadata raw from the image or preview node
+> - Output:
+>   - prompt: The prompt used to produce the image.
+>   - workflow: The workflow used to produce the image (all information about nodes, values, etc).
+>   - file info: The file info of the image/metadata (resolution, size, etc) is human readable.
+>   - raw to JSON: The entire metadata is raw but formatted/readable.
+>   - raw to property: The entire metadata is raw in "properties" format.
+>   - raw to csv: The entire metadata is raw in "csv" format.
+></details>
+
+<br />
+
+### Node: Metadata comparator
+
+This node is so useful for comparing two metadata and seeing the differences (**the main reason why I created this extension!**)
+
+You can compare 3 inputs: "Prompt", "Workflow" and "Fileinfo"
+
+There are three potential "outputs": `values_changed`, `dictionary_item_added`, and `dictionary_item_removed` (in this order of priority).
+
+![Metadata extractor](./docs/metadata-comparator.png)
+
+**Sample:** [metadata-comparator.json](./samples/metadata-comparator.json)
+
+**Notes:**  
+- I use [DeepDiff](https://pypi.org/project/deepdiff) for that. For more info check the link.  
+- If you want to compare two JSONs, you can use the [JSON comparator](#node-JSON-comparator) node.
+
+
+><details>
+>  <summary><i>Parameters</i></summary>
+>
+> - options:
+>   - what: What to compare, you can choose between "Prompt", "Workflow" and "Fileinfo"  
+> - input: 
+>   - metadata_raw_old: The metadata raw to start comparing
+>   - metadata_raw_new: The metadata raw to compare
+> - Output:
+> - diff: This is the same output you can see in the display of the node; you can use it on other nodes.
+></details>
+
+<br />
+
+---
+
+## Debugger
+
+### Node: Show Metadata
+
+With this node, you will be able to see the JSON produced from your entire prompt and workflow so that you can know all the values (and more) of your prompt quickly without opening the file (PNG or JSON).
+
+![Show metadata](./docs/debugger-show-metadata.png)
+
+**Sample:** [debugger-metadata.json](./samples/debugger-metadata.json)
+
+><details>
+>  <summary><i>Parameters</i></summary>
+>
+> - Options:
+>   - Active: Enable/disable the node  
+>   - Parsed: Show the parsed JSON or plain text  
+>   - What: Show the prompt or workflow (prompt are values to produce the image, and workflow is the entire workflow of ComfyUI)
+></details>
+
+<br /> 
+
+### Node: Show any
+
+You can see on the console or display any text or data from the nodes. Connect it to what you want to inspect, and you will see it.
+
+![Show any](./docs/debugger-show-any.png)
+
+**Sample:** [debugger-any.json](./samples/debugger-any.json)
+
+><details>
+>  <summary><i>Parameters</i></summary>
+>
+> - Input:
+>   - any_value: Any value to show, which can be a string, number, etc.
+> - Options:
+>   - Console: Enable/disable write to console  
+>   - Display: Enable/disable write on this node  
+>   - Prefix: Prefix to console
+></details>
+
+<br />
+
+### Node: Show any to JSON
+
+It is the same as the previous one, but it formatted the value to JSON (only display).
+
+![Show any](./docs/debugger-show-json.png)
+
+**Sample:** [debugger-json.json](./samples/debugger-json.json)
+
+><details>
+>  <summary><i>Parameters</i></summary>
+>
+> - Input:
+>   - any_value: Any value to try to convert to JSON
+> - Output:
+>   - string: The same string is shown on the display
+></details>
+
+<br />
+
+---
+
+## Image
+
+### Node: Load image with metadata
+This node is the same as the default one, but it adds three features: Prompt, Metadata, and supports **subfolders** of the "input" folder.
+
+![Load image with metadata](./docs/image-load.png)
+
+**Sample:** [image-load.json](./samples/image-load.json)
+
+><details>
+>  <summary><i>Parameters</i></summary>
+>
+> - Input:
+>   - image: Read the images from the input folder (and subfolder) (you can drop the image here or even paste an image from the clipboard)
+> - Output:
+>   - Image/Mask: The same as the default node  
+>   - Prompt: The prompt used to produce the image (not the workflow)  
+>   - Metadata RAW: The metadata raw of the image (full workflow) as string
+></details>
+
+**Note:** The subfolders support inspired on: [comfyui-imagesubfolders](https://github.com/catscandrive/comfyui-imagesubfolders)
+
+<br />
+
+### Node: Save image with extra metadata
+This node is the same as the default one, but it adds two features: Save the workflow in the png or not, and you can add any piece of metadata (as JSON).
+
+This saves custom data on the image, so you can share it with others, and they can see the workflow and metadata (see [preview from metadata](#node-preview-from-metadata)), even your custom data.
+
+It can be any type of information that supports text and JSON.
+
+![Save image with extra metadata](./docs/image-save.png)
+
+**Sample:** [image-save.json](./samples/image-save.json)
+
+><details>
+>  <summary><i>Parameters</i></summary>
+>
+> - options:
+>   - with_workflow: If you want to save into the image workflow (special to share the workflow with others)
+> - Input:
+>   - image: The image to save (same as the default node)
+> - Output:
+>   - Metadata RAW: The metadata raw of the image (full workflow) as string
+></details>
+
+**Note:** The data is saved as special "exif" (as ComfyUI does) in the png file; you can read it with [Load image with metadata](#node-load-image-with-metadata).
+
+> **Important:**
+> - If you want to save your workflow with a particular name and your data as creator, you need to use the [ComfyUI-Crystools-save](https://github.com/crystian/ComfyUI-Crystools-save) extension; try it!
+![Crystools-save](./docs/crystools-save.png)
+
+
+<br />
+
+### Node: Preview from image
+
+This node is used to preview the image with the **current prompt** and additional features.  
+
+![Preview from image](./docs/image-preview.png)
+
+**Feature:** It supports cache (shows as "CACHED") (not permanent yet!), so you can disconnect the node and still see the image and data, so you can use it to compare with others!
+
+![Preview from image](./docs/image-preview-diff.png)
+
+As you can see the seed, steps, and cfg were changed
+
+**Sample:** [image-preview-image.json](./samples/image-preview-image.json)
+
+><details>
+>  <summary><i>Parameters</i></summary>
+>
+> - Input:
+>   - image: Any kind of image link
+> - Output:
+>   - Metadata RAW: The metadata raw of the image and full workflow.  
+>     - You can use it to **compare with others** (see [metadata comparator](#node-metadata-comparator))
+>     - The file info like filename, resolution, datetime and size with **the current prompt, not the original one!** (see important note)
+></details>
+
+> **Important:**
+> - If you want to read the metadata of the image, you need to use the [load image with metadata](#node-load-image-with-metadata) and use the output "metadata RAW" not the image link.
+> - To do a preview, it is necessary to save it first on the temporal folder, and the data shown is from the temporal image, **not the original one** even **the prompt!**
+
+<br />
+
+### Node: Preview from metadata
+
+This node is used to preview the image from the metadata and shows additional data (all around this one).  
+It supports the same features as [preview from image](#node-preview-from-image) (cache, metadata raw, etc.). But the important difference is you see **real data from the image** (not the temporal one or the current prompt).
+ 
+![Preview from metadata](./docs/image-preview-metadata.png)
+
+**Sample:** [image-preview-metadata.json](./samples/image-preview-metadata.json)
+
+<br />
+
+### Node: Show resolution
+
+This node is used to show the resolution of an image.
+
+> Can be used with any image link.
+
+![Show resolution](./docs/image-resolution.png)
+
+**Sample:** [image-resolution.json](./samples/image-resolution.json)
+
+><details>
+>  <summary><i>Parameters</i></summary>
+>
+> - Input:
+>   - image: Any kind of image link
+> - Output:
+>   - Width: The width of the image  
+>   - Height: The height of the image
+></details>
+
+<br />
+
+---
+
+## Pipe
+
+### Nodes: Pipe to/edit any, Pipe from any
+
+This powerful set of nodes is used to better organize your pipes.  
+
+The "Pipe to/edit any" node is used to encapsulate multiple links into a single one. It includes support for editing and easily adding the modified content back to the same pipe number.
+
+The "Pipe from any" node is used to extract the content of a pipe.  
+ 
+Typical example:
+
+![Pipes](./docs/pipe-0.png)
+
+With pipes:
+
+![Pipes](./docs/pipe-1.png)
+
+**Sample:** [pipe-1.json](./samples/pipe-1.json)
+
+Editing pipes:
+
+![Pipes](./docs/pipe-2.png)
+
+**Sample:** [pipe-2.json](./samples/pipe-2.json)
+
+><details>
+>  <summary><i>Parameters</i></summary>
+>
+> - Input:
+>   - CPipeAny: This is the type of this pipe you can use to edit (see the sample)
+>   - any_*: 6 possible inputs to use
+> - Output:
+>   - CPipeAny: You can continue the pipe with this output; you can use it to bifurcate the pipe (see the sample)
+></details>
+
+>**Important:**
+> - Please note that it supports "any," meaning it does not validate (not yet!) the correspondence of input nodes with the output ones. When creating the link, it is recommended to link consciously number by number.
+> - "RecursionError" It's crucial to note that the flow of links **must be in the same direction**, and they cannot be mixed with other flows that use the result of this one. Otherwise, this may lead to recursion and block the server (you need to restart it!)
+
+
+><details>
+>  <summary><i>Bad example with "RecursionError: maximum recursion depth exceeded"</i></summary>
+>
+> If you see something like this on your console, you need to check your pipes. That is bad sample of pipes, you can't mix the flows.
+![Pipes](./docs/pipe-3.png)
+></details>
+
+<br />
+
+---
+
+## Utils
+
+Some useful nodes to use in your workflow.
+
+### Node: JSON comparator
+
+This node is so useful to compare two JSONs and see the differences.
+
+![JSON comparator](./docs/utils-json-comparator.png)
+
+**Sample:** [utils-json-comparator.json](./samples/utils-json-comparator.json)
+
+
+><details>
+>  <summary><i>Parameters</i></summary>
+>
+> - input: 
+>   - json_old: The first JSON to start compare
+>   - json_new: The JSON to compare
+> - Output:
+>   - diff: A new JSON with the differences
+></details>
+
+
+**Notes:**  
+As you can see, it is the same as the [metadata comparator](#node-metadata-comparator) but with JSONs.  
+The other is intentionally simple to compare two images metadata; this is more generic.  
+The main difference is that you can compare any JSON, not only metadata.
+
+<br />
+
+### Node: Stats system
+
+This node is used to show the system stats (RAM, VRAM, and Space).  
+It **should** connect as a pipe.
+
+![JSON comparator](./docs/utils-stats.png)
+
+**Sample:** [utils-stats.json](./samples/utils-stats.json)
+
+><details>
+>  <summary><i>Parameters</i></summary>
+>
+> - input: 
+>   - latent: The latent to use to measure the stats
+> - Output:
+>   - latent: Return the same latent to continue the pipe
+></details>
+
+**Notes:** The original is in [WAS](https://github.com/WASasquatch/was-node-suite-comfyui), I only show it on the display.
+
+<br />
+
+---
+
+## Primitives
+
+### Nodes: Primitive boolean, Primitive integer, Primitive float, Primitive string, Primitive string multiline
+
+A set of nodes with primitive values to use in your prompts.
+
+![Primitives](./docs/primitives.png)
+
+<br />
+
+---
+
+## List
+A set of nodes with a list of values (any or strings/texts) for any proposal (news nodes to use it coming soon!).
+
+> **Important:** You can use other nodes like "Show any" to see the values of the list
+
+### Node: List of strings
+
+**Feature:** You can concatenate them.
+
+![Lists](./docs/list-string.png)
+
+**Sample:** [list-strings.json](./samples/list-strings.json)
+
+><details>
+>  <summary><i>Parameters</i></summary>
+>
+> - Input:
+>   - string_*: 8 possible inputs to use
+>   - delimiter: Use to concatenate the values on the output
+> - Output:
+>   - concatenated: A string with all values concatenated
+>   - list_string: The list of strings (only with values)
+></details>
+
+<br />
+
+### Node: List of any
+
+You can concatenate any value (it will try to convert it to a string and show the value), so it is util to see several values at the same time.
+
+![Lists](./docs/list-any.png)
+
+**Sample:** [list-any.json](./samples/list-any.json)
+
+><details>
+>  <summary><i>Parameters</i></summary>
+>
+> - Input:
+>   - any_*: 8 possible inputs to use
+> - Output:
+>   - list_any: The list of any elements (only with values)
+></details>
+
+<br />
+
+---
+
+## Switch
+A set of nodes to switch between flows.  
+
+All switches are boolean; you can switch between flows by simply changing the value of the switch.  
+You have predefined switches (string, latent, image, conditioning) but you can use "Switch any" for any value/type.
+
+![Switches](./docs/switches.png)
+
+**Sample:** [switch.json](./samples/switch.json)
+
+<br />
+
+---
+
+## About
+
+**Notes from the author:**
+- This is my first project in python ¯\\_(ツ)_/¯ (PR are welcome!)
+- I'm a software engineer but in other languages (web technologies)
+- My Instagram is: https://www.instagram.com/crystian.ia I'll publish my works on it, so consider following me for news! :)
+- I'm not a native English speaker, so sorry for my English :P
+
+---
+
+## To do
+- [ ] Several unit tests
+- [ ] Add permanent cache for preview/metadata image (to survive to F5! or restart the server)
+
+---
+
+## Changelog
+
+### Crystools
+
+### 1.27.0 (17/08/2025)
+- revert the lower case on name, cannot change on registry ¯\_(ツ)_/¯
+- zluda check removed, it is not necessary anymore
+
+### 1.25.3 (27/07/2025)
+- change the name to lower case
+
+### 1.25.1 (02/06/2025)
+- fix issues with switches on settings menu
+- node: "Switch from any" added
+- load image with metadata: filtered (exclude hidden folders an typically metadata files)
+- other fixes
+
+### 1.24.0 (02/06/2025)
+- PRs by community merged
+- Improved VRAM usage/readout
+- HDD error handling
+- Lazy switches
+
+### 1.23.0 (02/06/2025)
+- Jetson support added by @johnnynunez
+- some ui fixes
+
+### 1.20.0 (21/10/2024)
+- BETA of JSON file reader and extractor, to allow you to read your own JSON files and extract the values to use in your workflow 
+
+### 1.19.0 (06/10/2024)
+- HORIZONTAL UI! New version is ready! 🎉
+
+### 1.18.0 (21/09/2024)
+- HORIZONTAL UI! 🎉
+- Configurable size of monitors on settings menu
+
+### 1.17.0 (21/09/2024)
+- Settings menu reorganized
+- Preparing for horizontal UI
+- Update from ComfyUI (typescript and new features)
+
+### 1.16.0 (31/07/2024)
+- Rollback of AMD support by manager does not support other repository parameter (https://test.pypi.org/simple by pyrsmi)
+
+### 1.15.0 (21/07/2024)
+- AMD Branch merged to the main branch, should work for AMD users on **Linux**
+
+### 1.14.0 (15/07/2024)
+- Tried to use AMD info, but it breaks installation on windows, so I removed it ¯\_(ツ)_/¯
+- AMD Branch added, if you use AMD and Linux, you can try it (not tested for me)
+
+### 1.13.0 (01/07/2024)
+- Integrate with new ecosystem of ComfyUI
+- Webp support added on load image with metadata node
+
+### 1.12.0 (27/03/2024)
+- GPU Temperature added
+
+### 1.10.0 (17/01/2024)
+- Multi-gpu added
+
+### 1.9.2 (15/01/2024)
+- Big refactor on hardwareInfo and monitor.ts, gpu was separated on another file, preparing for multi-gpu support
+
+### 1.8.0 (14/01/2024) - internal
+- HDD monitor selector on settings
+
+### 1.7.0 (11/01/2024) - internal
+- Typescript added!
+
+### 1.6.0 (11/01/2024)
+- Fix issue [#7](https://github.com/crystian/comfyui-crystools/issues/7) to the thread deadlock on concurrency
+
+### 1.5.0 (10/01/2024)
+- Improvements on the resources monitor and how handle the threads
+- Some fixes 
+
+### 1.3.0 (08/01/2024)
+- Added in general Resources monitor (CPU, GPU, RAM, VRAM, and space)
+- Added this icon to identify this set of tools: 🪛 
+
+### 1.2.0 (05/01/2024)
+- progress bar added
+ 
+### 1.1.0 (29/12/2023)
+- Node added: "Save image with extra metadata"
+- Support to **read** Jpeg metadata added (not save)
+
+### 1.0.0 (26/12/2023)
+- First release
+
+
+### Crystools-save - DEPRECATED (01/06/2025)
+
+### 1.1.0 (07/01/2024)
+- Labeling updated according to the new version of Crystools (this project)
+
+### 1.0.0 (29/12/2023)
+- Created another extension to save the info about the author on workflow: [ComfyUI-Crystools-save](https://github.com/crystian/ComfyUI-Crystools-save)
+
+---
+
+## Installation
+
+### Install from GitHub
+1. Install [ComfyUi](https://github.com/comfyanonymous/ComfyUI).
+2. Clone this repo into `custom_nodes`:
+    ```
+    cd ComfyUI/custom_nodes
+    git clone https://github.com/crystian/comfyui-crystools.git
+    cd comfyui-crystools
+    pip install -r requirements.txt
+    ```
+3. Start up ComfyUI.
+
+#### For AMD users
+If you are an AMD user with Linux, you can try the AMD branch:
+
+**ATTENTION:** Don't install with the manager, you need to install manually:
+
+  ```
+  cd ComfyUI/custom_nodes
+  git clone -b AMD https://github.com/crystian/comfyui-crystools.git
+  cd comfyui-crystools
+  pip install -r requirements.txt
+  ```
+
+### Install from manager
+
+Search for `crystools` in the [manager](https://github.com/ltdrdata/ComfyUI-Manager.git) and install it.
+
+### Using on Google Colab
+
+You can use it on Google Colab, but you need to install it manually:
+
+[Google Colab](https://colab.research.google.com/drive/1xiTiPmZkcIqNOsLQPO1UNCdJZqgK3U5k?usp=sharing)
+
+* Run the first cell to install ComfyUI and launch the server
+* After it finishes, use the link to open the a new tab, looking a line like this:
+```
+This is the URL to access ComfyUI: https://identifying-complications-fw-some.trycloudflare.com    
+```
+
+---
+
+## Use
+
+You can use it as any other node, just using the menu in the category `crystools` or double clicking on the canvas (I recommended using the "oo" to fast filter), all nodes were post fixing with `[Crystools]`.
+
+![Menu](./docs/menu.png)
+![shortcut](./docs/shortcut.png)
+
+If for some reason you need to see the logs, you can define the environment variable `CRYSTOOLS_LOGLEVEL` and set the [value](https://docs.python.org/es/3/howto/logging.html).
+
+---
+
+Made with ❤️ by Crystian.

custom_nodes/ComfyUI-Crystools/__init__.py

@@ -0,0 +1,108 @@
+"""
+@author: Crystian
+@title: Crystools
+@nickname: Crystools
+@version: 1.27.3
+@project: "https://github.com/crystian/comfyui-crystools",
+@description: Plugins for multiples uses, mainly for debugging, you need them! IG: https://www.instagram.com/crystian.ia
+"""
+
+from .core import version, logger
+logger.info(f'Crystools version: {version}')
+
+from .nodes._names import CLASSES
+from .nodes.primitive import CBoolean, CText, CTextML, CInteger, CFloat
+from .nodes.switch import CSwitchBooleanAny, CSwitchBooleanLatent, CSwitchBooleanConditioning, CSwitchBooleanImage, \
+  CSwitchBooleanString, CSwitchBooleanMask, CSwitchFromAny
+from .nodes.debugger import CConsoleAny, CConsoleAnyToJson
+from .nodes.image import CImagePreviewFromImage, CImageLoadWithMetadata, CImageGetResolution, CImagePreviewFromMetadata, \
+    CImageSaveWithExtraMetadata
+from .nodes.list import CListAny, CListString
+from .nodes.pipe import CPipeToAny, CPipeFromAny
+from .nodes.utils import CUtilsCompareJsons, CUtilsStatSystem
+from .nodes.metadata import CMetadataExtractor, CMetadataCompare
+from .nodes.parameters import CJsonFile, CJsonExtractor
+from .server import *
+from .general import *
+
+NODE_CLASS_MAPPINGS = {
+    CLASSES.CBOOLEAN_NAME.value: CBoolean,
+    CLASSES.CTEXT_NAME.value: CText,
+    CLASSES.CTEXTML_NAME.value: CTextML,
+    CLASSES.CINTEGER_NAME.value: CInteger,
+    CLASSES.CFLOAT_NAME.value: CFloat,
+
+    CLASSES.CDEBUGGER_CONSOLE_ANY_NAME.value: CConsoleAny,
+    CLASSES.CDEBUGGER_CONSOLE_ANY_TO_JSON_NAME.value: CConsoleAnyToJson,
+
+    CLASSES.CLIST_ANY_NAME.value: CListAny,
+    CLASSES.CLIST_STRING_NAME.value: CListString,
+
+    CLASSES.CSWITCH_FROM_ANY_NAME.value: CSwitchFromAny,
+    CLASSES.CSWITCH_ANY_NAME.value: CSwitchBooleanAny,
+    CLASSES.CSWITCH_LATENT_NAME.value: CSwitchBooleanLatent,
+    CLASSES.CSWITCH_CONDITIONING_NAME.value: CSwitchBooleanConditioning,
+    CLASSES.CSWITCH_IMAGE_NAME.value: CSwitchBooleanImage,
+    CLASSES.CSWITCH_MASK_NAME.value: CSwitchBooleanMask,
+    CLASSES.CSWITCH_STRING_NAME.value: CSwitchBooleanString,
+
+    CLASSES.CPIPE_TO_ANY_NAME.value: CPipeToAny,
+    CLASSES.CPIPE_FROM_ANY_NAME.value: CPipeFromAny,
+
+    CLASSES.CIMAGE_LOAD_METADATA_NAME.value: CImageLoadWithMetadata,
+    CLASSES.CIMAGE_GET_RESOLUTION_NAME.value: CImageGetResolution,
+    CLASSES.CIMAGE_PREVIEW_IMAGE_NAME.value: CImagePreviewFromImage,
+    CLASSES.CIMAGE_PREVIEW_METADATA_NAME.value: CImagePreviewFromMetadata,
+    CLASSES.CIMAGE_SAVE_METADATA_NAME.value: CImageSaveWithExtraMetadata,
+
+    CLASSES.CMETADATA_EXTRACTOR_NAME.value: CMetadataExtractor,
+    CLASSES.CMETADATA_COMPARATOR_NAME.value: CMetadataCompare,
+    CLASSES.CUTILS_JSON_COMPARATOR_NAME.value: CUtilsCompareJsons,
+    CLASSES.CUTILS_STAT_SYSTEM_NAME.value: CUtilsStatSystem,
+    CLASSES.CJSONFILE_NAME.value: CJsonFile,
+    CLASSES.CJSONEXTRACTOR_NAME.value: CJsonExtractor,
+}
+
+NODE_DISPLAY_NAME_MAPPINGS = {
+    CLASSES.CBOOLEAN_NAME.value: CLASSES.CBOOLEAN_DESC.value,
+    CLASSES.CTEXT_NAME.value: CLASSES.CTEXT_DESC.value,
+    CLASSES.CTEXTML_NAME.value: CLASSES.CTEXTML_DESC.value,
+    CLASSES.CINTEGER_NAME.value: CLASSES.CINTEGER_DESC.value,
+    CLASSES.CFLOAT_NAME.value: CLASSES.CFLOAT_DESC.value,
+
+    CLASSES.CDEBUGGER_CONSOLE_ANY_NAME.value: CLASSES.CDEBUGGER_ANY_DESC.value,
+    CLASSES.CDEBUGGER_CONSOLE_ANY_TO_JSON_NAME.value: CLASSES.CDEBUGGER_CONSOLE_ANY_TO_JSON_DESC.value,
+
+    CLASSES.CLIST_ANY_NAME.value: CLASSES.CLIST_ANY_DESC.value,
+    CLASSES.CLIST_STRING_NAME.value: CLASSES.CLIST_STRING_DESC.value,
+
+    CLASSES.CSWITCH_FROM_ANY_NAME.value: CLASSES.CSWITCH_FROM_ANY_DESC.value,
+    CLASSES.CSWITCH_ANY_NAME.value: CLASSES.CSWITCH_ANY_DESC.value,
+    CLASSES.CSWITCH_LATENT_NAME.value: CLASSES.CSWITCH_LATENT_DESC.value,
+    CLASSES.CSWITCH_CONDITIONING_NAME.value: CLASSES.CSWITCH_CONDITIONING_DESC.value,
+    CLASSES.CSWITCH_IMAGE_NAME.value: CLASSES.CSWITCH_IMAGE_DESC.value,
+    CLASSES.CSWITCH_MASK_NAME.value: CLASSES.CSWITCH_MASK_DESC.value,
+    CLASSES.CSWITCH_STRING_NAME.value: CLASSES.CSWITCH_STRING_DESC.value,
+
+    CLASSES.CPIPE_TO_ANY_NAME.value: CLASSES.CPIPE_TO_ANY_DESC.value,
+    CLASSES.CPIPE_FROM_ANY_NAME.value: CLASSES.CPIPE_FROM_ANY_DESC.value,
+
+    CLASSES.CIMAGE_LOAD_METADATA_NAME.value: CLASSES.CIMAGE_LOAD_METADATA_DESC.value,
+    CLASSES.CIMAGE_GET_RESOLUTION_NAME.value: CLASSES.CIMAGE_GET_RESOLUTION_DESC.value,
+    CLASSES.CIMAGE_PREVIEW_IMAGE_NAME.value: CLASSES.CIMAGE_PREVIEW_IMAGE_DESC.value,
+    CLASSES.CIMAGE_PREVIEW_METADATA_NAME.value: CLASSES.CIMAGE_PREVIEW_METADATA_DESC.value,
+    CLASSES.CIMAGE_SAVE_METADATA_NAME.value: CLASSES.CIMAGE_SAVE_METADATA_DESC.value,
+
+    CLASSES.CMETADATA_EXTRACTOR_NAME.value: CLASSES.CMETADATA_EXTRACTOR_DESC.value,
+    CLASSES.CMETADATA_COMPARATOR_NAME.value: CLASSES.CMETADATA_COMPARATOR_DESC.value,
+
+    CLASSES.CUTILS_JSON_COMPARATOR_NAME.value: CLASSES.CUTILS_JSON_COMPARATOR_DESC.value,
+    CLASSES.CUTILS_STAT_SYSTEM_NAME.value: CLASSES.CUTILS_STAT_SYSTEM_DESC.value,
+
+    CLASSES.CJSONFILE_NAME.value: CLASSES.CJSONFILE_DESC.value,
+    CLASSES.CJSONEXTRACTOR_NAME.value: CLASSES.CJSONEXTRACTOR_DESC.value,
+}
+
+
+WEB_DIRECTORY = "./web"
+__all__ = ["NODE_CLASS_MAPPINGS", "NODE_DISPLAY_NAME_MAPPINGS", "WEB_DIRECTORY"]

custom_nodes/ComfyUI-Crystools/core/__init__.py

@@ -0,0 +1,6 @@
+from .logger import *
+from .keys import *
+from .types import *
+from .config import *
+from .common import *
+from .version import *

custom_nodes/ComfyUI-Crystools/core/common.py

@@ -0,0 +1,119 @@
+import os
+import json
+import torch
+from deepdiff import DeepDiff
+from ..core import CONFIG, logger
+
+
+# just a helper function to set the widget values (or clear them)
+def setWidgetValues(value=None, unique_id=None, extra_pnginfo=None) -> None:
+    if unique_id and extra_pnginfo:
+        workflow = extra_pnginfo["workflow"]
+        node = next((x for x in workflow["nodes"] if str(x["id"]) == unique_id), None)
+
+        if node:
+            node["widgets_values"] = value
+
+    return None
+
+
+# find difference between two jsons
+def findJsonStrDiff(json1, json2):
+    msgError = "Could not compare jsons"
+    returnJson = {"error": msgError}
+    try:
+        # TODO review this
+        # dict1 = json.loads(json1)
+        # dict2 = json.loads(json2)
+
+        returnJson = findJsonsDiff(json1, json2)
+
+        returnJson = json.dumps(returnJson, indent=CONFIG["indent"])
+    except Exception as e:
+        logger.warn(f"{msgError}: {e}")
+
+    return returnJson
+
+
+def findJsonsDiff(json1, json2):
+    msgError = "Could not compare jsons"
+    returnJson = {"error": msgError}
+
+    try:
+        diff = DeepDiff(json1, json2, ignore_order=True, verbose_level=2)
+
+        returnJson = {k: v for k, v in diff.items() if
+                   k in ('dictionary_item_added', 'dictionary_item_removed', 'values_changed')}
+
+        # just for print "values_changed" at first
+        returnJson = dict(reversed(returnJson.items()))
+
+    except Exception as e:
+        logger.warn(f"{msgError}: {e}")
+
+    return returnJson
+
+
+# powered by:
+# https://github.com/WASasquatch/was-node-suite-comfyui/blob/main/WAS_Node_Suite.py
+# class: WAS_Samples_Passthrough_Stat_System
+def get_system_stats():
+    import psutil
+
+    # RAM
+    ram = psutil.virtual_memory()
+    ram_used = ram.used / (1024 ** 3)
+    ram_total = ram.total / (1024 ** 3)
+    ram_stats = f"Used RAM: {ram_used:.2f} GB / Total RAM: {ram_total:.2f} GB"
+
+    # VRAM (with PyTorch)
+    device = torch.device("cuda" if torch.cuda.is_available() else "cpu")
+    vram_used = torch.cuda.memory_allocated(device) / (1024 ** 3)
+    vram_total = torch.cuda.get_device_properties(device).total_memory / (1024 ** 3)
+    vram_stats = f"Used VRAM: {vram_used:.2f} GB / Total VRAM: {vram_total:.2f} GB"
+
+    # Hard Drive Space
+    hard_drive = psutil.disk_usage("/")
+    used_space = hard_drive.used / (1024 ** 3)
+    total_space = hard_drive.total / (1024 ** 3)
+    hard_drive_stats = f"Used Space: {used_space:.2f} GB / Total Space: {total_space:.2f} GB"
+
+    return [ram_stats, vram_stats, hard_drive_stats]
+
+
+# return x and y resolution of an image (torch tensor)
+def getResolutionByTensor(image=None) -> dict:
+    res = {"x": 0, "y": 0}
+
+    if image is not None:
+        img = image.movedim(-1, 1)
+
+        res["x"] = img.shape[3]
+        res["y"] = img.shape[2]
+
+    return res
+
+
+# by https://stackoverflow.com/questions/6080477/how-to-get-the-size-of-tar-gz-in-mb-file-in-python
+def get_size(path):
+    size = os.path.getsize(path)
+    if size < 1024:
+        return f"{size} bytes"
+    elif size < pow(1024, 2):
+        return f"{round(size / 1024, 2)} KB"
+    elif size < pow(1024, 3):
+        return f"{round(size / (pow(1024, 2)), 2)} MB"
+    elif size < pow(1024, 4):
+        return f"{round(size / (pow(1024, 3)), 2)} GB"
+
+
+def get_nested_value(data, dotted_key, default=None):
+  keys = dotted_key.split('.')
+  for key in keys:
+    if isinstance(data, str):
+        data = json.loads(data)
+    if isinstance(data, dict) and key in data:
+      data = data[key]
+    else:
+      return default
+  return data

custom_nodes/ComfyUI-Crystools/core/config.py

@@ -0,0 +1,7 @@
+import os
+import logging
+
+CONFIG = {
+    "loglevel": int(os.environ.get("CRYSTOOLS_LOGLEVEL", logging.INFO)),
+    "indent": int(os.environ.get("CRYSTOOLS_INDENT", 2))
+}

custom_nodes/ComfyUI-Crystools/core/keys.py

@@ -0,0 +1,29 @@
+from enum import Enum
+
+
+class TEXTS(Enum):
+    CUSTOM_NODE_NAME = "Crystools"
+    LOGGER_PREFIX = "Crystools"
+    CONCAT = "concatenated"
+    INACTIVE_MSG = "inactive"
+    INVALID_METADATA_MSG = "Invalid metadata raw"
+    FILE_NOT_FOUND = "File not found!"
+
+
+class CATEGORY(Enum):
+    TESTING = "_for_testing"
+    MAIN = "crystools 🪛"
+    PRIMITIVE = "/Primitive"
+    DEBUGGER = "/Debugger"
+    LIST = "/List"
+    SWITCH = "/Switch"
+    PIPE = "/Pipe"
+    IMAGE = "/Image"
+    UTILS = "/Utils"
+    METADATA = "/Metadata"
+
+
+# remember, all keys should be in lowercase!
+class KEYS(Enum):
+    LIST = "list_string"
+    PREFIX = "prefix"

custom_nodes/ComfyUI-Crystools/core/logger.py

@@ -0,0 +1,39 @@
+# by https://github.com/Kosinkadink/ComfyUI-Advanced-ControlNet/blob/main/control/logger.py
+import sys
+import copy
+import logging
+from .keys import TEXTS
+from .config import CONFIG
+
+
+class ColoredFormatter(logging.Formatter):
+    COLORS = {
+        "DEBUG": "\033[0;36m",  # CYAN
+        "INFO": "\033[0;32m",  # GREEN
+        "WARNING": "\033[0;33m",  # YELLOW
+        "ERROR": "\033[0;31m",  # RED
+        "CRITICAL": "\033[0;37;41m",  # WHITE ON RED
+        "RESET": "\033[0m",  # RESET COLOR
+    }
+
+    def format(self, record):
+        colored_record = copy.copy(record)
+        levelname = colored_record.levelname
+        seq = self.COLORS.get(levelname, self.COLORS["RESET"])
+        colored_record.levelname = f"{seq}{levelname}{self.COLORS['RESET']}"
+        return super().format(colored_record)
+
+
+# Create a new logger
+logger = logging.getLogger(TEXTS.LOGGER_PREFIX.value)
+logger.propagate = False
+
+# Add handler if we don't have one.
+if not logger.handlers:
+    handler = logging.StreamHandler(sys.stdout)
+    handler.setFormatter(ColoredFormatter("[%(name)s %(levelname)s] %(message)s"))
+    logger.addHandler(handler)
+
+# Configure logger
+loglevel = CONFIG["loglevel"]
+logger.setLevel(loglevel)

custom_nodes/ComfyUI-Crystools/core/types.py

@@ -0,0 +1,36 @@
+import sys
+
+FLOAT = ("FLOAT", {"default": 1,
+                   "min": -sys.float_info.max,
+                   "max": sys.float_info.max,
+                   "step": 0.01})
+
+BOOLEAN = ("BOOLEAN", {"default": True})
+BOOLEAN_FALSE = ("BOOLEAN", {"default": False})
+
+INT = ("INT", {"default": 1,
+               "min": -sys.maxsize,
+               "max": sys.maxsize,
+               "step": 1})
+
+STRING = ("STRING", {"default": ""})
+
+STRING_ML = ("STRING", {"multiline": True, "default": ""})
+
+STRING_WIDGET = ("STRING", {"forceInput": True})
+
+JSON_WIDGET = ("JSON", {"forceInput": True})
+
+METADATA_RAW = ("METADATA_RAW", {"forceInput": True})
+
+class AnyType(str):
+    """A special class that is always equal in not equal comparisons. Credit to pythongosssss"""
+
+    def __eq__(self, _) -> bool:
+        return True
+
+    def __ne__(self, __value: object) -> bool:
+        return False
+
+
+any = AnyType("*")

custom_nodes/ComfyUI-Crystools/core/version.py

@@ -0,0 +1 @@
+version = "1.27.3"