Merge pull request #106 from ComfyAssets/test/pinned-comfyui-ci

test(ci): automate real ComfyUI checks and prepare 1.2.0

.comfyignore

@@ -0,0 +1,29 @@
+# Files excluded from the Comfy Registry archive (gitignore syntax).
+# Everything here is development-only; the published node needs
+# __init__.py, kikotools/, web/, examples/, README, LICENSE, pyproject.toml.
+
+# Test suite and tooling
+tests/
+scripts/
+.github/
+Makefile
+pytest.ini
+mypy.ini
+.flake8
+.pre-commit-config.yaml
+.secrets.baseline
+requirements-dev.txt
+
+# Reference / scratch code not imported by the node
+example.py
+
+# Agent and contributor docs
+CLAUDE.md
+CONTRIBUTING.md
+CODE_OF_CONDUCT.md
+
+tools/
+.ci-comfyui/
+coverage/
+TESTING.md
+AGENTS.md

.flake8

@@ -0,0 +1,37 @@
+[flake8]
+max-line-length = 127
+max-complexity = 10
+exclude =
+    node_modules,
+    .git,
+    __pycache__,
+    .mypy_cache,
+    .pytest_cache,
+    venv,
+    env,
+    build,
+    dist,
+    *.egg-info,
+    .tox,
+    referance
+ignore =
+    # W503: line break before binary operator (conflicts with Black)
+    W503,
+    # E203: whitespace before ':' (conflicts with Black)
+    E203,
+    # E501: line too long (we use max-line-length)
+    E501
+
+per-file-ignores =
+    # Allow unused imports in __init__.py files
+    __init__.py:F401,F403
+    # Allow assertions in tests
+    tests/*:S101
+    # Allow higher complexity for Gemini prompt module
+    kikotools/tools/gemini_prompt/logic.py:C901
+    kikotools/tools/gemini_prompt/models.py:C901
+    kikotools/tools/gemini_prompt/node.py:C901
+
+# Statistics
+count = True
+statistics = True

.gitattributes

@@ -0,0 +1,41 @@
+# Auto detect text files and perform LF normalization
+* text=auto
+
+# Python files
+*.py text eol=lf
+*.pyi text eol=lf
+
+# Configuration files
+*.json text eol=lf
+*.yaml text eol=lf
+*.yml text eol=lf
+*.toml text eol=lf
+*.ini text eol=lf
+*.cfg text eol=lf
+
+# Documentation
+*.md text eol=lf
+*.rst text eol=lf
+*.txt text eol=lf
+
+# Scripts
+*.sh text eol=lf
+*.bash text eol=lf
+
+# Git files
+.gitignore text eol=lf
+.gitattributes text eol=lf
+
+# ComfyUI specific
+*.workflow text eol=lf
+
+# Binary files
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.webp binary
+*.safetensors binary
+*.ckpt binary
+*.pt binary
+*.pth binary

.github/ISSUE_TEMPLATE/bug_report.md

@@ -45,4 +45,4 @@ Paste any error messages or stack traces here
 If possible, attach the ComfyUI workflow file (.json) that reproduces the issue.
 
 **Additional context**
-Add any other context about the problem here.
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -37,7 +37,7 @@ Describe how the tool should process inputs and generate outputs.
 
 **Model Compatibility:**
 - [ ] SDXL optimized
-- [ ] FLUX optimized  
+- [ ] FLUX optimized
 - [ ] General purpose
 - [ ] Specific model requirements: [describe]
 
@@ -64,4 +64,4 @@ Are there existing ComfyUI nodes that do something similar? How would this be di
 - [ ] Yes, I can help with implementation
 - [ ] Yes, I can help with testing
 - [ ] Yes, I can help with documentation
-- [ ] No, but I'd be happy to test it
+- [ ] No, but I'd be happy to test it

.github/branch-protection.json

@@ -0,0 +1,16 @@
+{
+  "required_status_checks": {
+    "strict": true,
+    "contexts": [
+      "py3.10 on ubuntu-latest", "py3.11 on ubuntu-latest", "py3.12 on ubuntu-latest", "py3.13 on ubuntu-latest",
+      "py3.10 on windows-latest", "py3.11 on windows-latest", "py3.12 on windows-latest", "py3.13 on windows-latest",
+      "py3.10 on macos-latest", "py3.11 on macos-latest", "py3.12 on macos-latest", "py3.13 on macos-latest",
+      "coverage gate (85%)", "frontend syntax", "frontend workflows and coverage", "real ComfyUI compatibility", "code-quality"
+    ]
+  },
+  "enforce_admins": true,
+  "required_pull_request_reviews": null,
+  "restrictions": null,
+  "allow_force_pushes": false,
+  "allow_deletions": false
+}

.github/dependabot.yml

@@ -0,0 +1,14 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "npm"
+    directory: "/tools/testing"
+    schedule:
+      interval: "weekly"

.github/workflows/code-quality.yml

@@ -1,4 +1,6 @@
 name: Code Quality
+permissions:
+  contents: read
 
 on:
   push:
@@ -11,15 +13,15 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v7
 
     - name: Set up Python 3.10
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v7
       with:
         python-version: '3.10'
 
     - name: Cache pip dependencies
-      uses: actions/cache@v3
+      uses: actions/cache@v6
       with:
         path: ~/.cache/pip
         key: ${{ runner.os }}-pip-quality-${{ hashFiles('**/requirements-dev.txt') }}
@@ -29,6 +31,7 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
+        pip install torch --index-url https://download.pytorch.org/whl/cpu
         pip install -r requirements-dev.txt
 
     - name: Format check with Black
@@ -59,7 +62,7 @@ jobs:
         import sys
         import os
         sys.path.insert(0, os.getcwd())
-        
+
         # Test that all imports work correctly
         try:
             from kikotools import NODE_CLASS_MAPPINGS, NODE_DISPLAY_NAME_MAPPINGS
@@ -67,57 +70,82 @@ jobs:
         except ImportError as e:
             print(f'Warning: Package-level imports failed: {e}')
             # This is expected since we don't have ComfyUI installed
-        
+
         # Test individual module imports
         from kikotools.base import ComfyAssetsBaseNode
         from kikotools.tools.resolution_calculator import ResolutionCalculatorNode
         from kikotools.tools.resolution_calculator.logic import extract_dimensions
         from kikotools.tools.resolution_calculator.node import ResolutionCalculatorNode as NodeClass
-        
+
+        # Test Width Height Selector imports
+        from kikotools.tools.width_height_selector import WidthHeightSelectorNode
+        from kikotools.tools.width_height_selector.logic import get_preset_dimensions
+        from kikotools.tools.width_height_selector.presets import PRESET_OPTIONS, PRESET_METADATA
+
+        # Test Sampler Combo imports
+        from kikotools.tools.sampler_combo import SamplerComboNode
+        from kikotools.tools.sampler_combo.logic import get_sampler_combo, SAMPLERS, SCHEDULERS
+
+        # Test Seed History imports
+        from kikotools.tools.seed_history import SeedHistoryNode
+        from kikotools.tools.seed_history.logic import generate_random_seed, validate_seed_value
+
+        # Test Kiko Save Image imports
+        from kikotools.tools.kiko_save_image import KikoSaveImageNode
+        from kikotools.tools.kiko_save_image.logic import process_image_batch, validate_save_inputs
+
+        # Test Model Downloader imports
+        from kikotools.tools.model_downloader import ModelDownloaderNode
+        from kikotools.tools.model_downloader.detector import URLDetector, DownloaderType
+        from kikotools.tools.model_downloader.base import BaseDownloader
+
+        # Test Text Input imports
+        from kikotools.tools.text_input import TextInputNode
+
         print('✓ All module imports successful')
         "
 
     - name: Check code style consistency
       run: |
         echo "Checking code style consistency..."
-        
+
         # Check for consistent naming
         find kikotools/ -name "*.py" -exec grep -l "class.*Node" {} \; | while read file; do
           if ! grep -q "ComfyAssetsBaseNode" "$file" && ! grep -q "class ComfyAssetsBaseNode" "$file"; then
             echo "Checking $file for ComfyUI node inheritance..."
           fi
         done
-        
+
         # Check for proper docstrings
         python -c "
         import ast
         import os
-        
+
         def check_docstrings(filepath):
             with open(filepath, 'r') as f:
                 tree = ast.parse(f.read())
-            
+
             for node in ast.walk(tree):
                 if isinstance(node, (ast.FunctionDef, ast.ClassDef)):
                     if not ast.get_docstring(node) and not node.name.startswith('_'):
                         print(f'Warning: {filepath}:{node.lineno} - {node.name} missing docstring')
-        
+
         for root, dirs, files in os.walk('kikotools'):
             for file in files:
                 if file.endswith('.py') and not file.startswith('__'):
                     filepath = os.path.join(root, file)
                     check_docstrings(filepath)
-        
+
         print('✓ Docstring check completed')
         "
 
   security:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v7
 
     - name: Set up Python 3.10
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v7
       with:
         python-version: '3.10'
 
@@ -134,7 +162,7 @@ jobs:
     - name: Check for hardcoded secrets
       run: |
         echo "Checking for potential secrets..."
-        
+
         # Check for common secret patterns
         if grep -r -i "password\|secret\|key\|token" kikotools/ --include="*.py" | grep -v "# " | grep -v "def " | grep -v "class "; then
           echo "Warning: Potential hardcoded secrets found"
@@ -145,16 +173,17 @@ jobs:
   architecture:
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v7
 
     - name: Set up Python 3.10
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v7
       with:
         python-version: '3.10'
 
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
+        pip install torch --index-url https://download.pytorch.org/whl/cpu
         pip install -r requirements-dev.txt
 
     - name: Check architecture compliance
@@ -163,61 +192,161 @@ jobs:
         import sys
         import os
         sys.path.insert(0, os.getcwd())
-        
+
         print('Checking architecture compliance...')
-        
+
         # Test separation of concerns
         from kikotools.tools.resolution_calculator import logic, node
-        
+
         # Logic module should not import node-specific things
         import inspect
         logic_source = inspect.getsource(logic)
-        
+
         if 'ComfyUI' in logic_source and 'INPUT_TYPES' not in logic_source:
             print('⚠️  Warning: Logic module contains ComfyUI-specific code')
         else:
             print('✓ Logic module properly separated')
-        
+
         # Node module should inherit from base
         from kikotools.tools.resolution_calculator.node import ResolutionCalculatorNode
         from kikotools.base import ComfyAssetsBaseNode
-        
+
         if issubclass(ResolutionCalculatorNode, ComfyAssetsBaseNode):
             print('✓ Node properly inherits from base class')
         else:
             print('❌ Node does not inherit from base class')
             sys.exit(1)
-        
+
         # Check that nodes have proper ComfyUI interface
         required_attrs = ['INPUT_TYPES', 'RETURN_TYPES', 'RETURN_NAMES', 'FUNCTION', 'CATEGORY']
+
+        # Test Resolution Calculator Node
         for attr in required_attrs:
             if not hasattr(ResolutionCalculatorNode, attr):
-                print(f'❌ Node missing required attribute: {attr}')
+                print(f'❌ ResolutionCalculatorNode missing required attribute: {attr}')
                 sys.exit(1)
-        
-        print('✓ All architecture checks passed')
+
+        # Test Width Height Selector Node
+        from kikotools.tools.width_height_selector.node import WidthHeightSelectorNode
+
+        if issubclass(WidthHeightSelectorNode, ComfyAssetsBaseNode):
+            print('✓ WidthHeightSelectorNode properly inherits from base class')
+        else:
+            print('❌ WidthHeightSelectorNode does not inherit from base class')
+            sys.exit(1)
+
+        for attr in required_attrs:
+            if not hasattr(WidthHeightSelectorNode, attr):
+                print(f'❌ WidthHeightSelectorNode missing required attribute: {attr}')
+                sys.exit(1)
+
+        # Test Sampler Combo Node
+        from kikotools.tools.sampler_combo.node import SamplerComboNode
+
+        if issubclass(SamplerComboNode, ComfyAssetsBaseNode):
+            print('✓ SamplerComboNode properly inherits from base class')
+        else:
+            print('❌ SamplerComboNode does not inherit from base class')
+            sys.exit(1)
+
+        for attr in required_attrs:
+            if not hasattr(SamplerComboNode, attr):
+                print(f'❌ SamplerComboNode missing required attribute: {attr}')
+                sys.exit(1)
+
+        # Test Seed History Node
+        from kikotools.tools.seed_history.node import SeedHistoryNode
+
+        if issubclass(SeedHistoryNode, ComfyAssetsBaseNode):
+            print('✓ SeedHistoryNode properly inherits from base class')
+        else:
+            print('❌ SeedHistoryNode does not inherit from base class')
+            sys.exit(1)
+
+        for attr in required_attrs:
+            if not hasattr(SeedHistoryNode, attr):
+                print(f'❌ SeedHistoryNode missing required attribute: {attr}')
+                sys.exit(1)
+
+        # Test Kiko Save Image Node
+        from kikotools.tools.kiko_save_image.node import KikoSaveImageNode
+
+        if issubclass(KikoSaveImageNode, ComfyAssetsBaseNode):
+            print('✓ KikoSaveImageNode properly inherits from base class')
+        else:
+            print('❌ KikoSaveImageNode does not inherit from base class')
+            sys.exit(1)
+
+        # KikoSaveImage is an output node, so it doesn't have RETURN_TYPES/RETURN_NAMES
+        save_required_attrs = ['INPUT_TYPES', 'FUNCTION', 'CATEGORY']
+        for attr in save_required_attrs:
+            if not hasattr(KikoSaveImageNode, attr):
+                print(f'❌ KikoSaveImageNode missing required attribute: {attr}')
+                sys.exit(1)
+
+        # Check that it's properly marked as an output node
+        if not hasattr(KikoSaveImageNode, 'OUTPUT_NODE') or not KikoSaveImageNode.OUTPUT_NODE:
+            print('❌ KikoSaveImageNode missing OUTPUT_NODE = True')
+            sys.exit(1)
+
+        # Test Model Downloader Node
+        from kikotools.tools.model_downloader.node import ModelDownloaderNode
+
+        if issubclass(ModelDownloaderNode, ComfyAssetsBaseNode):
+            print('✓ ModelDownloaderNode properly inherits from base class')
+        else:
+            print('❌ ModelDownloaderNode does not inherit from base class')
+            sys.exit(1)
+
+        # ModelDownloader is an output node, so it doesn't have RETURN_TYPES/RETURN_NAMES
+        download_required_attrs = ['INPUT_TYPES', 'FUNCTION', 'CATEGORY']
+        for attr in download_required_attrs:
+            if not hasattr(ModelDownloaderNode, attr):
+                print(f'❌ ModelDownloaderNode missing required attribute: {attr}')
+                sys.exit(1)
+
+        # Check that it's properly marked as an output node
+        if not hasattr(ModelDownloaderNode, 'OUTPUT_NODE') or not ModelDownloaderNode.OUTPUT_NODE:
+            print('❌ ModelDownloaderNode missing OUTPUT_NODE = True')
+            sys.exit(1)
+
+        # Test Text Input Node
+        from kikotools.tools.text_input.node import TextInputNode
+
+        if issubclass(TextInputNode, ComfyAssetsBaseNode):
+            print('✓ TextInputNode properly inherits from base class')
+        else:
+            print('❌ TextInputNode does not inherit from base class')
+            sys.exit(1)
+
+        for attr in required_attrs:
+            if not hasattr(TextInputNode, attr):
+                print(f'❌ TextInputNode missing required attribute: {attr}')
+                sys.exit(1)
+
+        print('✓ All architecture checks passed for all tools')
         "
 
     - name: Check test coverage expectations
       run: |
         python -c "
         import os
-        
+
         # Count test files vs implementation files
         test_files = 0
         impl_files = 0
-        
+
         for root, dirs, files in os.walk('tests'):
             test_files += len([f for f in files if f.startswith('test_') and f.endswith('.py')])
-        
+
         for root, dirs, files in os.walk('kikotools'):
             impl_files += len([f for f in files if f.endswith('.py') and not f.startswith('__')])
-        
+
         print(f'Implementation files: {impl_files}')
         print(f'Test files: {test_files}')
-        
+
         if test_files >= impl_files * 0.5:  # At least 50% test coverage by file count
             print('✓ Adequate test file coverage')
         else:
             print('⚠️  Warning: Low test file coverage')
-        "
+        "

.github/workflows/publish.yml

@@ -0,0 +1,28 @@
+name: Publish to Comfy registry
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+      - master
+    paths:
+      - "pyproject.toml"
+
+permissions:
+  issues: write
+
+jobs:
+  publish-node:
+    name: Publish Custom Node to registry
+    runs-on: ubuntu-latest
+    if: ${{ github.repository_owner == 'ComfyAssets' }}
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v7
+        with:
+          submodules: true
+      - 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 }}

.github/workflows/release.yml

@@ -1,5 +1,8 @@
 name: Release
 
+permissions:
+  contents: read
+
 on:
   push:
     tags:
@@ -7,53 +10,28 @@ on:
 
 jobs:
   create-release:
+    outputs:
+      version: ${{ steps.get_version.outputs.version }}
     runs-on: ubuntu-latest
-    
+    permissions:
+      contents: write
+
     steps:
-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v7
 
     - name: Set up Python 3.10
-      uses: actions/setup-python@v4
+      uses: actions/setup-python@v7
       with:
         python-version: '3.10'
 
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
+        pip install torch --index-url https://download.pytorch.org/whl/cpu
         pip install -r requirements-dev.txt
 
-    - name: Run full test suite
-      run: |
-        python -c "
-        import sys
-        import os
-        sys.path.insert(0, os.getcwd())
-        
-        # Run comprehensive tests before release
-        from kikotools.base import ComfyAssetsBaseNode
-        from kikotools.tools.resolution_calculator.logic import extract_dimensions, calculate_scaled_dimensions
-        from kikotools.tools.resolution_calculator.node import ResolutionCalculatorNode
-        import torch
-        
-        print('Running pre-release validation...')
-        
-        # Test all major functionality
-        node = ResolutionCalculatorNode()
-        
-        # Test various scenarios
-        test_cases = [
-            (torch.randn(1, 512, 512, 3), 2.0),
-            (torch.randn(1, 1024, 1024, 3), 1.5),
-            (torch.randn(1, 1216, 832, 3), 1.53),  # User scenario
-        ]
-        
-        for i, (image, scale) in enumerate(test_cases):
-            width, height = node.calculate_resolution(scale, image=image)
-            print(f'✓ Test case {i+1}: {image.shape[2]}×{image.shape[1]} → {width}×{height} (scale: {scale})')
-            assert width % 8 == 0 and height % 8 == 0
-        
-        print('🎉 All pre-release tests passed!')
-        "
+    - name: Run full test suite and coverage gate
+      run: python -m pytest tests --cov=kikotools --cov-report=term-missing
 
     - name: Extract version from tag
       id: get_version
@@ -64,22 +42,22 @@ jobs:
       run: |
         cat > release_notes.md << 'EOF'
         ## ComfyUI-KikoTools ${{ steps.get_version.outputs.version }}
-        
+
         ### 🎉 What's New
-        
+
         #### Resolution Calculator Tool
         - **Smart Input Handling**: Works with both IMAGE and LATENT tensors
-        - **Model Optimized**: Specific optimizations for SDXL and FLUX models  
+        - **Model Optimized**: Specific optimizations for SDXL and FLUX models
         - **Constraint Enforcement**: Automatically ensures dimensions divisible by 8
         - **Flexible Scaling**: Supports scale factors from 1.0x to 8.0x
-        
+
         ### 📦 Installation
-        
+
         #### ComfyUI Manager
         1. Search for "ComfyUI-KikoTools"
         2. Click Install
         3. Restart ComfyUI
-        
+
         #### Manual Installation
         ```bash
         cd ComfyUI/custom_nodes/
@@ -87,29 +65,29 @@ jobs:
         cd ComfyUI-KikoTools
         pip install -r requirements-dev.txt
         ```
-        
+
         ### 🚀 Quick Start
-        
+
         Look for **ComfyAssets** nodes in your ComfyUI node browser!
-        
+
         ### 📊 Technical Details
-        
+
         - **Nodes**: 1 (Resolution Calculator)
-        - **Test Coverage**: 100%
+        - **Python Coverage Gate**: 85% combined statement/branch coverage
         - **Python Support**: 3.8+
         - **ComfyUI Compatibility**: Latest
-        
+
         ### 🐛 Bug Reports
-        
+
         Found an issue? Please report it [here](https://github.com/ComfyAssets/ComfyUI-KikoTools/issues).
-        
+
         ---
-        
+
         **Full Changelog**: https://github.com/ComfyAssets/ComfyUI-KikoTools/compare/v0.0.0...${{ steps.get_version.outputs.version }}
         EOF
 
     - name: Create GitHub Release
-      uses: softprops/action-gh-release@v1
+      uses: softprops/action-gh-release@v3
       with:
         tag_name: ${{ steps.get_version.outputs.version }}
         name: ComfyUI-KikoTools ${{ steps.get_version.outputs.version }}
@@ -128,18 +106,18 @@ jobs:
     runs-on: ubuntu-latest
     needs: create-release
     if: success()
-    
+
     steps:
     - name: Community notification placeholder
       run: |
         echo "🎉 Release ${{ needs.create-release.outputs.version }} created!"
         echo "Consider posting to:"
         echo "- ComfyUI Discord"
-        echo "- Reddit r/ComfyUI"  
+        echo "- Reddit r/ComfyUI"
         echo "- ComfyUI-Manager database"
         echo ""
         echo "Release includes:"
         echo "- Resolution Calculator tool"
         echo "- Complete documentation"
         echo "- Example workflows"
-        echo "- 100% test coverage"
+        echo "- Enforced Python coverage and frontend regression checks"

.github/workflows/tests.yml

@@ -1,5 +1,8 @@
 name: Tests
 
+permissions:
+  contents: read
+
 on:
   push:
     branches: [main, develop]
@@ -8,187 +11,191 @@ on:
 
 jobs:
   test:
-    runs-on: ubuntu-latest
+    name: py${{ matrix.python-version }} on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
-        python-version: [3.8, 3.9, "3.10", "3.11", "3.12"]
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
 
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v7
         with:
           python-version: ${{ matrix.python-version }}
+          cache: pip
+          cache-dependency-path: requirements-dev.txt
 
-      - name: Cache pip dependencies
-        uses: actions/cache@v3
-        with:
-          path: ~/.cache/pip
-          key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements-dev.txt') }}
-          restore-keys: |
-            ${{ runner.os }}-pip-
+      # The default Linux torch wheel bundles CUDA (~2.5 GB); tests only need CPU.
+      # Windows and macOS default wheels are already CPU-only.
+      - name: Install CPU torch (Linux)
+        if: runner.os == 'Linux'
+        run: |
+          python -m pip install --upgrade pip
+          pip install torch --index-url https://download.pytorch.org/whl/cpu
 
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
           pip install -r requirements-dev.txt
 
-      - name: Run core functionality tests
-        run: |
-          python -c "
-          import sys
-          import os
-          sys.path.insert(0, os.getcwd())
+      - name: Run tests
+        run: python -m pytest tests --junitxml=test-results/pytest.xml
 
-          # Test imports
-          from kikotools.base import ComfyAssetsBaseNode
-          from kikotools.tools.resolution_calculator.logic import extract_dimensions, calculate_scaled_dimensions
-          from kikotools.tools.resolution_calculator.node import ResolutionCalculatorNode
-          import torch
-
-          print('✓ All imports successful')
-
-          # Test base node
-          assert ComfyAssetsBaseNode.CATEGORY == 'ComfyAssets'
-          print('✓ Base node tests passed')
-
-          # Test dimension extraction
-          mock_image = torch.randn(1, 1216, 832, 3)
-          width, height = extract_dimensions(image=mock_image)
-          assert width == 832 and height == 1216
-          print('✓ Dimension extraction tests passed')
-
-          # Test scaling
-          new_width, new_height = calculate_scaled_dimensions(832, 1216, 1.5)
-          assert new_width % 8 == 0 and new_height % 8 == 0
-          print('✓ Scaling tests passed')
-
-          # Test node interface
-          node = ResolutionCalculatorNode()
-          result_width, result_height = node.calculate_resolution(1.5, image=mock_image)
-          assert isinstance(result_width, int) and isinstance(result_height, int)
-          assert result_width % 8 == 0 and result_height % 8 == 0
-          print('✓ Node interface tests passed')
-
-          # Test user scenario
-          width, height = node.calculate_resolution(1.53, image=mock_image)
-          print(f'✓ User scenario test: 832×1216 → {width}×{height} (1.53x scale)')
-
-          print('🎉 All tests passed!')
-          "
-
-      - name: Test error handling
-        run: |
-          python -c "
-          import sys
-          import os
-          sys.path.insert(0, os.getcwd())
-
-          from kikotools.tools.resolution_calculator.node import ResolutionCalculatorNode
-
-          node = ResolutionCalculatorNode()
-
-          # Test error handling
-          try:
-              node.calculate_resolution(2.0)  # No input provided
-              assert False, 'Should have raised ValueError'
-          except ValueError:
-              print('✓ Error handling test passed')
-
-          # Test invalid scale factor
-          try:
-              node.calculate_resolution(0.0)  # Invalid scale
-              assert False, 'Should have raised ValueError'
-          except ValueError:
-              print('✓ Scale factor validation test passed')
-
-          print('✓ All error handling tests passed')
-          "
-
-      - name: Test ComfyUI integration readiness
-        run: |
-          python -c "
-          import sys
-          import os
-          sys.path.insert(0, os.getcwd())
-
-          from kikotools.tools.resolution_calculator.node import ResolutionCalculatorNode
-
-          # Test ComfyUI interface requirements
-          node_class = ResolutionCalculatorNode
-
-          # Check required class attributes
-          assert hasattr(node_class, 'INPUT_TYPES')
-          assert hasattr(node_class, 'RETURN_TYPES')
-          assert hasattr(node_class, 'RETURN_NAMES')
-          assert hasattr(node_class, 'FUNCTION')
-          assert hasattr(node_class, 'CATEGORY')
-
-          # Check INPUT_TYPES structure
-          input_types = node_class.INPUT_TYPES()
-          assert 'required' in input_types
-          assert 'optional' in input_types
-          assert 'scale_factor' in input_types['required']
-          assert 'image' in input_types['optional']
-          assert 'latent' in input_types['optional']
-
-          # Check return types
-          assert node_class.RETURN_TYPES == ('INT', 'INT')
-          assert node_class.RETURN_NAMES == ('width', 'height')
-          assert node_class.CATEGORY == 'ComfyAssets'
-
-          print('✓ ComfyUI integration readiness tests passed')
-          "
-
-  test-package-structure:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Python 3.10
-        uses: actions/setup-python@v4
+      - name: Upload test results
+        if: always()
+        uses: actions/upload-artifact@v7
         with:
-          python-version: "3.10"
+          name: python-${{ matrix.os }}-${{ matrix.python-version }}
+          path: test-results/
+          if-no-files-found: ignore
+          retention-days: 14
 
-      - name: Test package structure
+  comfyui:
+    name: real ComfyUI compatibility
+    runs-on: ubuntu-latest
+    timeout-minutes: 25
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          persist-credentials: false
+      - uses: actions/setup-node@v7
+        with:
+          node-version: "24"
+          cache: npm
+          cache-dependency-path: tools/testing/package-lock.json
+      - name: Read the reviewed runtime pins
+        id: runtime
         run: |
-          # Check required files exist
-          test -f README.md || (echo "README.md missing" && exit 1)
-          test -f LICENSE || (echo "LICENSE missing" && exit 1)
-          test -f requirements-dev.txt || (echo "requirements-dev.txt missing" && exit 1)
+          node --input-type=module <<'JS' >> "$GITHUB_OUTPUT"
+          import runtime from './tools/testing/comfyui-runtime.json' with { type: 'json' };
+          for (const [key, value] of Object.entries(runtime)) console.log(`${key}=${value}`);
+          JS
+      - name: Check out pinned ComfyUI
+        uses: actions/checkout@v7
+        with:
+          repository: ${{ steps.runtime.outputs.repository }}
+          ref: ${{ steps.runtime.outputs.revision }}
+          path: .ci-comfyui
+          persist-credentials: false
+      - uses: actions/setup-python@v7
+        with:
+          python-version: ${{ steps.runtime.outputs.pythonVersion }}
+          cache: pip
+          cache-dependency-path: |
+            requirements-dev.txt
+            .ci-comfyui/requirements.txt
+            tools/testing/comfyui-runtime.json
+      - name: Install CPU runtime and test dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install "torch==${{ steps.runtime.outputs.torchVersion }}" "torchvision==${{ steps.runtime.outputs.torchvisionVersion }}" --index-url https://download.pytorch.org/whl/cpu
+          pip install -r .ci-comfyui/requirements.txt -r requirements-dev.txt "torch==${{ steps.runtime.outputs.torchVersion }}" "torchvision==${{ steps.runtime.outputs.torchvisionVersion }}"
+      - run: npm ci --prefix tools/testing --ignore-scripts
+      - run: npx --prefix tools/testing playwright install --with-deps chromium
+      - name: Classic and Nodes 2.0 startup and compatibility
+        env:
+          KIKO_COMFY_ROOT: ${{ github.workspace }}/.ci-comfyui
+          KIKO_TEST_PYTHON: python
+        run: npm run --prefix tools/testing test:comfyui
+      - name: Upload real-host reports and startup logs
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: real-comfyui-reports
+          path: tools/testing/test-results/
+          if-no-files-found: ignore
+          retention-days: 14
 
-          # Check directory structure
-          test -d kikotools || (echo "kikotools directory missing" && exit 1)
-          test -d kikotools/base || (echo "kikotools/base directory missing" && exit 1)
-          test -d kikotools/tools || (echo "kikotools/tools directory missing" && exit 1)
-          test -d kikotools/tools/resolution_calculator || (echo "resolution_calculator directory missing" && exit 1)
-          test -d tests || (echo "tests directory missing" && exit 1)
-          test -d examples || (echo "examples directory missing" && exit 1)
-
-          # Check key files
-          test -f kikotools/__init__.py || (echo "kikotools/__init__.py missing" && exit 1)
-          test -f kikotools/base/base_node.py || (echo "base_node.py missing" && exit 1)
-          test -f kikotools/tools/resolution_calculator/node.py || (echo "node.py missing" && exit 1)
-          test -f kikotools/tools/resolution_calculator/logic.py || (echo "logic.py missing" && exit 1)
-
-          echo "✓ Package structure tests passed"
-
-  test-documentation:
+  coverage:
+    name: coverage gate (85%)
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v7
 
-      - name: Test documentation completeness
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: requirements-dev.txt
+
+      - name: Install dependencies
         run: |
-          # Check documentation files
-          test -f examples/documentation/resolution_calculator.md || (echo "Resolution calculator docs missing" && exit 1)
-          test -f examples/workflows/resolution_calculator_example.json || (echo "Example workflow missing" && exit 1)
+          python -m pip install --upgrade pip
+          pip install torch --index-url https://download.pytorch.org/whl/cpu
+          pip install -r requirements-dev.txt
 
-          # Check README has key sections
-          grep -q "Installation" README.md || (echo "README missing Installation section" && exit 1)
-          grep -q "Quick Start" README.md || (echo "README missing Quick Start section" && exit 1)
-          grep -q "Development" README.md || (echo "README missing Development section" && exit 1)
-          grep -q "Contributing" README.md || (echo "README missing Contributing section" && exit 1)
+      # fail_under = 85 lives in pyproject.toml [tool.coverage.report]
+      - name: Measure coverage
+        run: python -m pytest tests --cov=kikotools --cov-report=term-missing --cov-report=html --cov-report=xml
 
-          echo "✓ Documentation tests passed"
+      - name: Upload coverage reports
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: python-coverage
+          path: |
+            htmlcov/
+            coverage.xml
+          if-no-files-found: ignore
+          retention-days: 14
+
+  js-check:
+    name: frontend syntax
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+
+      - uses: actions/setup-node@v7
+        with:
+          node-version: "24"
+
+      # Check every shipped module, including files without behavioral tests.
+      - name: Check all shipped JavaScript modules parse
+        run: |
+          shopt -s globstar nullglob
+          for f in web/**/*.js web/**/*.mjs; do
+            node --input-type=module --check < "$f" || { echo "Syntax error in $f"; exit 1; }
+          done
+
+  frontend:
+    name: frontend workflows and coverage
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: "3.12"
+          cache: pip
+          cache-dependency-path: requirements-dev.txt
+      - name: Install Python test dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install torch --index-url https://download.pytorch.org/whl/cpu
+          pip install -r requirements-dev.txt
+      - uses: actions/setup-node@v7
+        with:
+          node-version: "24"
+          cache: npm
+          cache-dependency-path: tools/testing/package-lock.json
+      - run: npm ci --prefix tools/testing --ignore-scripts
+      - run: npx --prefix tools/testing playwright install --with-deps chromium firefox webkit
+      - name: JavaScript regressions, Chromium workflows, and coverage gate
+        run: npm run --prefix tools/testing test:coverage
+      - name: Firefox and WebKit workflows
+        run: npm run --prefix tools/testing test:browser -- --project firefox --project webkit
+      - name: Upload frontend reports
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: frontend-test-reports
+          path: |
+            tools/testing/test-results/
+            coverage/js/
+            !coverage/js/raw/
+          if-no-files-found: ignore
+          retention-days: 14

.gitignore

@@ -158,4 +158,23 @@ input/
 test_images/
 test_outputs/
 experiments/
-.claude/
+.claude/
+.serena
+
+# Gemini model cache
+.gemini_models_cache.json
+referance/
+
+# Runtime state written inside the package (repo is symlinked into custom_nodes)
+kikotools/tools/local_image_loader/config.json
+kikotools/tools/local_image_loader/selections.json
+gemini_config.json
+
+# Frontend test tooling and reports
+node_modules/
+coverage/
+playwright-report/
+test-results/
+
+# Disposable pinned host checkout used by CI
+.ci-comfyui/

.pre-commit-config.yaml

@@ -0,0 +1,101 @@
+# Pre-commit hooks configuration for ComfyUI-KikoTools
+# This ensures code quality checks are run before each commit
+
+repos:
+  # Python code formatting with Black
+  - repo: https://github.com/psf/black
+    rev: 26.10.1
+    hooks:
+      - id: black
+        args: ['--line-length=88']  # Match CI configuration
+
+  # Python linting with flake8
+  - repo: https://github.com/pycqa/flake8
+    rev: 7.3.0
+    hooks:
+      - id: flake8
+        args: ['--max-line-length=88', '--max-complexity=10']
+        exclude: '^tests/'
+
+  # Python type checking with mypy
+  # Note: Mypy is disabled in pre-commit due to package name issue
+  # Run manually with: mypy kikotools/
+  # - repo: https://github.com/pre-commit/mirrors-mypy
+  #   rev: v1.8.0
+  #   hooks:
+  #     - id: mypy
+  #       args: ['--config-file=mypy.ini']
+  #       files: '^kikotools/'
+  #       exclude: '^tests/'
+  #       additional_dependencies: ['types-requests']
+
+  # Security checks with bandit
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.8.6
+    hooks:
+      - id: bandit
+        args: ['-ll', '-r']
+        files: '^kikotools/'
+
+  # General file checks
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files
+        args: ['--maxkb=1000']
+      - id: check-case-conflict
+      - id: check-merge-conflict
+      - id: check-docstring-first
+      - id: debug-statements
+      - id: mixed-line-ending
+
+  # Check for hardcoded secrets
+  - repo: https://github.com/Yelp/detect-secrets
+    rev: v1.5.0
+    hooks:
+      - id: detect-secrets
+        args: ['--baseline', '.secrets.baseline']
+        exclude: '^(tests/|\.git/)'
+
+  - repo: local
+    hooks:
+      - id: python-regressions
+        name: Python regression suite
+        entry: python -m pytest tests
+        language: system
+        pass_filenames: false
+        always_run: true
+        stages: [pre-push]
+      - id: frontend-regressions
+        name: JavaScript regression suite
+        entry: npm test --prefix tools/testing
+        language: system
+        pass_filenames: false
+        always_run: true
+        stages: [pre-push]
+
+# Configuration for specific hooks
+default_stages: [pre-commit]
+default_language_version:
+  python: python3
+
+# Run hooks on all files by default
+fail_fast: false
+
+# Exclude patterns
+exclude: |
+  (?x)^(
+    \.git/|
+    \.mypy_cache/|
+    \.pytest_cache/|
+    __pycache__/|
+    build/|
+    dist/|
+    \.eggs/|
+    .*\.egg-info/|
+    venv/|
+    env/
+  )

.secrets.baseline

@@ -0,0 +1,164 @@
+{
+  "version": "1.5.0",
+  "plugins_used": [
+    {
+      "name": "ArtifactoryDetector"
+    },
+    {
+      "name": "AWSKeyDetector"
+    },
+    {
+      "name": "AzureStorageKeyDetector"
+    },
+    {
+      "name": "Base64HighEntropyString",
+      "limit": 4.5
+    },
+    {
+      "name": "BasicAuthDetector"
+    },
+    {
+      "name": "CloudantDetector"
+    },
+    {
+      "name": "DiscordBotTokenDetector"
+    },
+    {
+      "name": "GitHubTokenDetector"
+    },
+    {
+      "name": "GitLabTokenDetector"
+    },
+    {
+      "name": "HexHighEntropyString",
+      "limit": 3.0
+    },
+    {
+      "name": "IbmCloudIamDetector"
+    },
+    {
+      "name": "IbmCosHmacDetector"
+    },
+    {
+      "name": "IPPublicDetector"
+    },
+    {
+      "name": "JwtTokenDetector"
+    },
+    {
+      "name": "KeywordDetector",
+      "keyword_exclude": ""
+    },
+    {
+      "name": "MailchimpDetector"
+    },
+    {
+      "name": "NpmDetector"
+    },
+    {
+      "name": "OpenAIDetector"
+    },
+    {
+      "name": "PrivateKeyDetector"
+    },
+    {
+      "name": "PypiTokenDetector"
+    },
+    {
+      "name": "SendGridDetector"
+    },
+    {
+      "name": "SlackDetector"
+    },
+    {
+      "name": "SoftlayerDetector"
+    },
+    {
+      "name": "SquareOAuthDetector"
+    },
+    {
+      "name": "StripeDetector"
+    },
+    {
+      "name": "TelegramBotTokenDetector"
+    },
+    {
+      "name": "TwilioKeyDetector"
+    }
+  ],
+  "filters_used": [
+    {
+      "path": "detect_secrets.filters.allowlist.is_line_allowlisted"
+    },
+    {
+      "path": "detect_secrets.filters.common.is_ignored_due_to_verification_policies",
+      "min_level": 2
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_indirect_reference"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_likely_id_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_lock_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_not_alphanumeric_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_potential_uuid"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_prefixed_with_dollar_sign"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_sequential_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_swagger_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_templated_secret"
+    }
+  ],
+  "results": {
+    "examples/workflows/resolution_calculator_example.json": [
+      {
+        "type": "Hex High Entropy String",
+        "filename": "examples/workflows/resolution_calculator_example.json",
+        "hashed_secret": "5264b0f1a47aeafad88f33511dda3191b32dbf38",
+        "is_verified": false,
+        "line_number": 57
+      }
+    ],
+    "examples/workflows/sampler_combo_example.json": [
+      {
+        "type": "Hex High Entropy String",
+        "filename": "examples/workflows/sampler_combo_example.json",
+        "hashed_secret": "e3c1848dd1141985e412fa39922ac9ba37c4714d",
+        "is_verified": false,
+        "line_number": 348
+      }
+    ],
+    "examples/workflows/seed_history_example.json": [
+      {
+        "type": "Hex High Entropy String",
+        "filename": "examples/workflows/seed_history_example.json",
+        "hashed_secret": "e3c1848dd1141985e412fa39922ac9ba37c4714d",
+        "is_verified": false,
+        "line_number": 408
+      }
+    ],
+    "examples/workflows/width_height_selector_example.json": [
+      {
+        "type": "Hex High Entropy String",
+        "filename": "examples/workflows/width_height_selector_example.json",
+        "hashed_secret": "e3c1848dd1141985e412fa39922ac9ba37c4714d",
+        "is_verified": false,
+        "line_number": 425
+      }
+    ]
+  },
+  "generated_at": "2025-07-31T23:51:20Z"
+}

AGENTS.md

@@ -0,0 +1,46 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+`kikotools/tools/<tool>/logic.py` contains reusable logic; `node.py` defines the
+ComfyUI node. Shared classes live in `kikotools/base/`. Register nodes in
+`kikotools/__init__.py`; the root `__init__.py` exposes the plugin and API routes.
+`web/` contains browser extensions. Tests live in `tests/unit/`, `tests/js/`, and
+`tests/browser/`. Examples are in `examples/`.
+
+## Development Commands
+
+Install Python dependencies with `python -m pip install -r requirements-dev.txt`.
+Run `python -m pytest tests` or `make test` for the complete Python suite.
+Use `python -m pytest tests --cov=kikotools` for the 85% statement/branch gate.
+Format with `black .`; use `flake8 .` for lint findings.
+
+Frontend tooling needs Node.js 24 and `npm ci --prefix tools/testing
+--ignore-scripts`. Run `npm test --prefix tools/testing` for JavaScript tests,
+`npm run --prefix tools/testing test:coverage` for coverage and Chromium workflows,
+and `npm run --prefix tools/testing test:browser` for all browser projects.
+See `TESTING.md` for browser installation, environment overrides, and artifacts.
+
+## Coding Style & Naming
+
+Use four-space Python indentation and Black's 88-character formatting.
+Use `snake_case` for Python functions/modules, `PascalCase` for classes, and
+`UPPER_CASE` for constants. Keep node interfaces separate from logic. Preserve
+existing ComfyUI lifecycle hooks when extending widgets and clean up timers,
+listeners, and observers when nodes are removed.
+
+## Testing Guidelines
+
+Write regression tests first and verify failure before implementing fixes.
+Name Python tests `test_*.py` and JavaScript tests `*.test.mjs`; put browser
+workflows in `tests/browser/*.spec.mjs`. Test behavior and persistence, including
+failure recovery. Keep fixtures disposable and external services mocked.
+Never lower coverage floors to make a change pass.
+
+## Commits & Pull Requests
+
+Use Conventional Commits, such as `fix(local_image_loader): preserve error
+status`. Link the tracked issue, describe observable behavior, and report the
+commands and results used for validation. Include screenshots for visual changes.
+Required checks must pass before merging. Keep credentials and runtime files out
+of commits; restart ComfyUI after installing Python changes.

CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+## 1.2.0
+
+### Unified ComfyAssets UI
+
+- Consistent blue controls and strong red destructive actions that follow
+  ComfyUI's light/dark theme.
+- Updated Local Image Loader, Save Image viewer, Seed History, Workflow Timer,
+  dimension swaps, Node Dimensions, Display Text/Any and Embedding Autocomplete.
+- Larger adjustable gallery thumbnails and saved-image previews that use the
+  available space; responsive layouts, keyboard controls and lifecycle cleanup.
+- Shared Custom Colors picker with hex entry, HSV sliders and presets.
+- Restored autocomplete tag management, four-column CSV parsing, worker-based
+  imports and persistent tag caching. Tag packs remain a separate download;
+  see [tag-pack provenance and terms](docs/tag-packs/README.md).
+- Follow Execution honors live enablement, avoids duplicate subscriptions and
+  safely groups navigation menus.
+
+### Compatibility and testing
+
+- Classic and Nodes 2.0 coverage includes fresh startup in each renderer,
+  switching both ways, themes, saved workflows and removal cleanup.
+- Required CPU-only real-ComfyUI CI joins the existing Python, JavaScript,
+  Chromium, touch, Firefox and WebKit suites. Runtime pins and failure artifacts
+  make compatibility checks repeatable.
+- Retained [screenshots](docs/screenshots/README.md) and documented
+  [testing commands](TESTING.md).
+
+### Deprecation and upgrade
+
+Gemini Prompt Engineer is deprecated and hidden from normal new-node discovery.
+Its registration, schema and execution remain available for saved workflows;
+ongoing Google API/model compatibility maintenance has ended.
+
+Restart ComfyUI and hard-refresh the browser after upgrading. Existing node
+interfaces, workflow values and setting IDs are retained. No workflow conversion
+is required. Follow Execution remains opt-in through its Enable setting.

CLAUDE.md

@@ -0,0 +1,288 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+ComfyUI-KikoTools is a planned modular collection of custom ComfyUI nodes that will provide essential tools missing from the standard ComfyUI release. All nodes will be grouped under "ComfyAssets" in the ComfyUI interface. The project is designed for extensibility, allowing new tools to be added easily while maintaining clean separation of concerns.
+
+**Current Status**: Project is in initial planning phase. Only documentation and licensing files exist.
+
+## Architecture
+
+### Design Principles
+- **Modular Design**: Each tool is a separate, self-contained module
+- **ComfyAssets Grouping**: All nodes appear under the "ComfyAssets" category
+- **Test-Driven Development**: Every tool includes comprehensive tests
+- **Clean Interfaces**: Standardized input/output patterns across tools
+
+### Core Components
+- **Tool Registry**: Central registration system for all KikoTools nodes
+- **Base Classes**: Shared functionality for consistent tool behavior
+- **Individual Tools**: Self-contained modules for specific functionality
+
+### Current Tools
+
+#### 1. Resolution Calculator (First Tool)
+- **Purpose**: Calculate upscale resolution from image or latent inputs
+- **Inputs**: 
+  - Image or Latent tensor
+  - Scale factor (1, 2, 3, 1.2, 1.5, 2.0)
+- **Outputs**: 
+  - Width (INT)
+  - Height (INT)
+- **Target Models**: Flux and SDXL optimized
+- **Use Case**: Connect calculated dimensions to upscaler nodes
+
+## Technology Stack
+
+- **Backend**: Python with ComfyUI node patterns
+- **Node Framework**: ComfyUI INPUT_TYPES, RETURN_TYPES, execute() patterns
+- **Testing**: pytest with ComfyUI test fixtures
+- **Code Quality**: black, flake8, mypy
+- **Integration**: ComfyUI execution queue and tensor systems
+
+## Development Commands
+
+**Note**: These commands are planned for when the project structure is implemented.
+
+### Initial Setup
+```bash
+# Create basic project structure
+mkdir -p kikotools/{base,tools} tests/{unit,integration,fixtures} scripts examples
+
+# Create entry point files
+touch __init__.py kikotools/__init__.py
+```
+
+### Code Quality (Future)
+```bash
+# Format Python code
+black .
+
+# Python linting
+flake8 .
+
+# Type checking
+mypy .
+```
+
+### Testing (Future TDD Workflow)
+```bash
+# Run all tests
+pytest tests/
+
+# Run tests for specific tool
+pytest tests/unit/tools/test_{tool_name}.py
+
+# Test coverage
+pytest --cov=kikotools tests/
+```
+
+## Project Structure (Planned)
+
+**Current State**: Only `CLAUDE.md` and `LICENSE` files exist.
+
+**Planned Structure**:
+```
+├── __init__.py                 # ComfyUI node registration entry point
+├── kikotools/                  # Main package
+│   ├── __init__.py            # Package initialization and tool registry
+│   ├── base/                  # Base classes and shared utilities
+│   │   ├── __init__.py
+│   │   ├── base_node.py       # Base node class with ComfyAssets grouping
+│   │   └── utils.py           # Shared utility functions
+│   ├── tools/                 # Individual tool implementations
+│   │   ├── __init__.py
+│   │   ├── resolution_calculator/  # First planned tool
+│   │   │   ├── __init__.py
+│   │   │   ├── node.py        # ResolutionCalculatorNode implementation
+│   │   │   └── logic.py       # Core calculation logic
+│   │   └── template/          # Template for new tools
+│   │       ├── __init__.py
+│   │       ├── node.py
+│   │       └── logic.py
+├── tests/                     # Comprehensive test suite (TDD approach)
+│   ├── __init__.py
+│   ├── conftest.py           # pytest fixtures and ComfyUI test setup
+│   ├── unit/                 # Unit tests for individual components
+│   │   ├── test_base_node.py
+│   │   └── tools/
+│   │       └── test_resolution_calculator.py
+│   ├── integration/          # ComfyUI integration tests
+│   │   ├── test_node_registration.py
+│   │   └── test_workflow_execution.py
+│   └── fixtures/             # Test data and workflow files
+│       ├── workflows/        # .json workflow files for testing
+│       ├── images/          # Test images
+│       └── latents/         # Test latent tensors
+├── scripts/                  # Development automation
+│   ├── create_tool.py       # Tool template generator
+│   ├── register_tool.py     # Tool registration helper
+│   └── validate_nodes.py    # Node validation script
+├── examples/                 # Usage examples and demonstrations
+│   ├── workflows/           # Example workflow .json files
+│   └── documentation/       # Usage documentation per tool
+└── requirements-dev.txt     # Development dependencies
+```
+
+## Key ComfyUI Integration Points
+
+### Node Registration Pattern
+```python
+# Each tool follows this pattern in kikotools/tools/{tool_name}/node.py
+class ResolutionCalculatorNode:
+    @classmethod
+    def INPUT_TYPES(cls):
+        return {
+            "required": {
+                "scale_factor": ("FLOAT", {"default": 2.0, "min": 1.0, "max": 8.0, "step": 0.1}),
+            },
+            "optional": {
+                "image": ("IMAGE",),
+                "latent": ("LATENT",),
+            }
+        }
+    
+    RETURN_TYPES = ("INT", "INT")
+    RETURN_NAMES = ("width", "height")
+    FUNCTION = "calculate_resolution"
+    CATEGORY = "ComfyAssets"  # All tools use this category
+    
+    def calculate_resolution(self, scale_factor, image=None, latent=None):
+        # Implementation here
+        pass
+```
+
+### Base Node Class
+- Provides consistent "ComfyAssets" categorization
+- Standardizes error handling and logging
+- Implements common validation patterns
+- Ensures consistent return type handling
+
+### Tool Registry System
+- Automatic discovery of tools in `kikotools/tools/`
+- Dynamic node registration during ComfyUI startup
+- Version compatibility checking
+- Dependency validation
+
+## Test-Driven Development (TDD) Workflow
+
+### 1. Write Tests First
+```python
+# tests/unit/tools/test_resolution_calculator.py
+def test_resolution_calculator_with_image():
+    """Test resolution calculation with image input."""
+    # Arrange
+    node = ResolutionCalculatorNode()
+    test_image = create_test_image(512, 512)  # fixture
+    scale_factor = 2.0
+    
+    # Act
+    width, height = node.calculate_resolution(scale_factor, image=test_image)
+    
+    # Assert
+    assert width == 1024
+    assert height == 1024
+
+def test_resolution_calculator_with_latent():
+    """Test resolution calculation with latent input."""
+    # Similar pattern for latent inputs
+    pass
+```
+
+### 2. Run Tests (Should Fail)
+```bash
+pytest tests/unit/tools/test_resolution_calculator.py -v
+```
+
+### 3. Implement Minimal Code
+```python
+# kikotools/tools/resolution_calculator/logic.py
+def calculate_upscale_resolution(input_tensor, scale_factor):
+    """Calculate new resolution based on input and scale factor."""
+    # Minimal implementation to pass tests
+    pass
+```
+
+### 4. Refactor and Expand
+- Add error handling
+- Optimize for Flux/SDXL specific requirements
+- Add comprehensive validation
+- Implement edge case handling
+
+### 5. Integration Testing
+```python
+# tests/integration/test_workflow_execution.py
+def test_resolution_calculator_in_workflow():
+    """Test resolution calculator in full ComfyUI workflow."""
+    workflow = load_test_workflow("resolution_calculator_example.json")
+    result = execute_comfyui_workflow(workflow)
+    assert result.success
+```
+
+## Tool-Specific Implementation Notes
+
+### Resolution Calculator
+- **Input Validation**: Handle both image and latent tensors
+- **Scale Factors**: Support integer (1, 2, 3) and float (1.2, 1.5, 2.0) multipliers
+- **Model Optimization**: Consider Flux and SDXL specific resolution requirements
+- **Output Format**: Integer width/height suitable for upscaler node connections
+- **Error Handling**: Graceful handling of invalid inputs or edge cases
+
+### Future Tools (Planned)
+- Batch Image Processor
+- Advanced Prompt Utilities
+- Model Management Tools
+- Custom Sampling Methods
+
+## Development Workflow
+
+### Adding a New Tool
+1. **Plan**: Define tool purpose, inputs, outputs, and test cases
+2. **Generate**: Use `python scripts/create_tool.py --name "NewTool"`
+3. **Test**: Write comprehensive tests following TDD principles
+4. **Implement**: Build tool logic with proper ComfyUI integration
+5. **Register**: Add tool to registry and validate registration
+6. **Document**: Update examples and documentation
+7. **Validate**: Test in real ComfyUI environment with actual workflows
+
+### Code Quality Standards
+- **Type Hints**: Full type annotation for all functions
+- **Documentation**: Docstrings for all public methods and classes
+- **Testing**: Minimum 90% test coverage for all tools
+- **Linting**: Pass all flake8 and mypy checks
+- **Formatting**: Auto-formatted with black
+
+### Release Process
+1. Run full test suite: `pytest tests/`
+2. Validate in ComfyUI: `python scripts/validate_nodes.py`
+3. Update version numbers and changelog
+4. Create example workflows demonstrating new features
+5. Update ComfyUI-Manager compatibility metadata
+
+## Critical Implementation Notes
+
+### ComfyUI Compatibility
+- Follow ComfyUI tensor format conventions
+- Implement proper memory management for large tensors
+- Handle ComfyUI execution context correctly
+- Ensure compatibility with ComfyUI's automatic typing system
+
+### Performance Considerations
+- Optimize for real-time workflow execution
+- Minimize memory allocation during processing
+- Cache expensive computations when appropriate
+- Profile performance with typical Flux/SDXL workflows
+
+### User Experience
+- Clear, descriptive node names and parameter labels
+- Helpful tooltips and parameter descriptions
+- Consistent visual styling within ComfyAssets group
+- Robust error messages with actionable guidance
+
+### Extensibility
+- Plugin architecture for easy tool addition
+- Shared utilities for common operations
+- Consistent API patterns across all tools
+- Future-proof design for ComfyUI updates

CODE_OF_CONDUCT.md

@@ -0,0 +1,128 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.0, available at
+https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

CONTRIBUTING.md

@@ -357,9 +357,12 @@ Brief description of changes.
 
 ### Review Process
 
+See [TESTING.md](TESTING.md) for automated suites, coverage gates, required merge
+checks, and the remaining ComfyUI/GPU/service boundaries.
+
 1. **Automated Checks**: CI runs tests and quality checks
 2. **Code Review**: Maintainer reviews code and provides feedback
-3. **Testing**: Manual testing in ComfyUI environment
+3. **Testing**: Run relevant automated suites; use live ComfyUI checks for host, GPU, service, or visual changes
 4. **Merge**: After approval, changes are merged to main
 
 ## 🎨 Code Style Guidelines

Makefile

@@ -1,6 +1,22 @@
 # ComfyUI-KikoTools Development Makefile
 
-.PHONY: help install test test-fast lint format type-check quality-check clean setup dev-test release-test
+.PHONY: coverage frontend-test browser-test frontend-coverage help install test test-fast lint format type-check quality-check clean setup dev-test release-test
+
+# Python and virtual environment setup
+PYTHON := python3
+VENV_DIR := venv
+VENV_BIN := $(VENV_DIR)/bin
+VENV_PYTHON := $(VENV_BIN)/python
+VENV_PIP := $(VENV_BIN)/pip
+
+# Check if we're in a virtual environment, if not use venv
+ifeq ($(VIRTUAL_ENV),)
+	PYTHON_CMD := $(VENV_PYTHON)
+	PIP_CMD := $(VENV_PIP)
+else
+	PYTHON_CMD := python
+	PIP_CMD := pip
+endif
 
 # Default target
 help:
@@ -18,7 +34,11 @@ help:
 	@echo "  quality-check  - Run all quality checks"
 	@echo ""
 	@echo "Testing:"
-	@echo "  test           - Run comprehensive tests"
+	@echo "  test           - Run the complete pytest suite"
+	@echo "  coverage       - Python statement/branch coverage (85% gate)"
+	@echo "  frontend-test  - JavaScript regression tests"
+	@echo "  browser-test   - Extension workflows in four browser configurations"
+	@echo "  frontend-coverage - JavaScript tests, browser tests, and coverage gate"
 	@echo "  test-fast      - Run core functionality tests"
 	@echo "  dev-test       - Quick development test"
 	@echo "  release-test   - Full release validation"
@@ -28,44 +48,48 @@ help:
 	@echo "  help           - Show this help message"
 
 # Setup and installation
-setup:
-	@echo "Setting up ComfyUI-KikoTools development environment..."
-	python -m venv venv
-	@echo "Virtual environment created. Activate with:"
-	@echo "  source venv/bin/activate  (Linux/Mac)"
-	@echo "  venv\\Scripts\\activate     (Windows)"
-	@echo "Then run: make install"
+setup: $(VENV_DIR)
+	@echo "✅ ComfyUI-KikoTools development environment ready"
+	@echo "Virtual environment created. Dependencies installed."
 
-install:
+$(VENV_DIR):
+	@echo "Creating virtual environment..."
+	$(PYTHON) -m venv $(VENV_DIR)
 	@echo "Installing development dependencies..."
-	pip install --upgrade pip
-	pip install -r requirements-dev.txt
+	$(VENV_PIP) install --upgrade pip
+	$(VENV_PIP) install -r requirements-dev.txt
+	@echo "✅ Virtual environment created and dependencies installed"
+
+install: $(VENV_DIR)
+	@echo "Installing/updating development dependencies..."
+	$(PIP_CMD) install --upgrade pip
+	$(PIP_CMD) install -r requirements-dev.txt
 	@echo "✅ Dependencies installed"
 
 # Code quality
-format:
+format: $(VENV_DIR)
 	@echo "Formatting code with black..."
-	black .
+	$(PYTHON_CMD) -m black .
 	@echo "✅ Code formatted"
 
-lint:
+lint: $(VENV_DIR)
 	@echo "Linting with flake8..."
-	flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
-	flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+	$(PYTHON_CMD) -m flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics --exclude=venv
+	$(PYTHON_CMD) -m flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics --exclude=venv
 	@echo "✅ Linting completed"
 
-type-check:
+type-check: $(VENV_DIR)
 	@echo "Type checking with mypy..."
-	mypy kikotools/ --ignore-missing-imports --no-strict-optional || true
+	$(PYTHON_CMD) -m mypy kikotools/ --ignore-missing-imports --no-strict-optional || true
 	@echo "✅ Type checking completed"
 
 quality-check: format lint type-check
 	@echo "✅ All quality checks completed"
 
 # Testing
-dev-test:
+dev-test: $(VENV_DIR)
 	@echo "Running quick development test..."
-	@python -c "\
+	@$(PYTHON_CMD) -c "\
 	import sys, os; \
 	sys.path.insert(0, os.getcwd()); \
 	from kikotools.tools.resolution_calculator.node import ResolutionCalculatorNode; \
@@ -75,9 +99,9 @@ dev-test:
 	print(f'✅ Development test passed! Result: {result[0]}x{result[1]}'); \
 	"
 
-test-fast:
+test-fast: $(VENV_DIR)
 	@echo "Running core functionality tests..."
-	@python -c "\
+	@$(PYTHON_CMD) -c "\
 	import sys, os; \
 	sys.path.insert(0, os.getcwd()); \
 	from kikotools.base import ComfyAssetsBaseNode; \
@@ -100,13 +124,20 @@ test-fast:
 	print('🎉 All core tests passed!'); \
 	"
 
-test: test-fast
-	@echo "Running comprehensive test suite..."
-	@echo "✅ Test case 1: 512×512 → 1024×1024 (scale: 2.0)"
-	@echo "✅ Test case 2: 1024×1024 → 1536×1536 (scale: 1.5)"  
-	@echo "✅ Test case 3: 832×1216 → 1272×1864 (scale: 1.53)"
-	@echo "✅ Error handling test passed"
-	@echo "🎉 All comprehensive tests passed!"
+test: $(VENV_DIR)
+	@$(PYTHON_CMD) -m pytest tests
+
+coverage: $(VENV_DIR)
+	@$(PYTHON_CMD) -m pytest tests --cov=kikotools --cov-report=term-missing --cov-report=html
+
+frontend-test:
+	npm test --prefix tools/testing
+
+browser-test:
+	npm run --prefix tools/testing test:browser
+
+frontend-coverage:
+	npm run --prefix tools/testing test:coverage
 
 release-test: quality-check test
 	@echo "Running release validation..."
@@ -146,13 +177,13 @@ ci: quality-check test
 	@echo "✅ CI checks passed!"
 
 # Tool-specific commands (can be extended for new tools)
-test-resolution-calculator:
+test-resolution-calculator: $(VENV_DIR)
 	@echo "Testing Resolution Calculator specifically..."
-	@python -c "import sys, os; sys.path.insert(0, os.getcwd()); from kikotools.tools.resolution_calculator.node import ResolutionCalculatorNode; import torch; node = ResolutionCalculatorNode(); scenarios = [('SDXL Portrait', torch.randn(1, 1216, 832, 3), 1.5), ('FLUX Square', torch.randn(1, 1024, 1024, 3), 2.0), ('User Scenario', torch.randn(1, 1216, 832, 3), 1.53)]; [print(f'✅ {name}: {image.shape[2]}×{image.shape[1]} → {node.calculate_resolution(scale, image=image)[0]}×{node.calculate_resolution(scale, image=image)[1]} ({scale}x)') for name, image, scale in scenarios]; print('🎉 Resolution Calculator tests completed!')"
+	@$(PYTHON_CMD) -c "import sys, os; sys.path.insert(0, os.getcwd()); from kikotools.tools.resolution_calculator.node import ResolutionCalculatorNode; import torch; node = ResolutionCalculatorNode(); scenarios = [('SDXL Portrait', torch.randn(1, 1216, 832, 3), 1.5), ('FLUX Square', torch.randn(1, 1024, 1024, 3), 2.0), ('User Scenario', torch.randn(1, 1216, 832, 3), 1.53)]; [print(f'✅ {name}: {image.shape[2]}×{image.shape[1]} → {node.calculate_resolution(scale, image=image)[0]}×{node.calculate_resolution(scale, image=image)[1]} ({scale}x)') for name, image, scale in scenarios]; print('🎉 Resolution Calculator tests completed!')"
 
-test-width-height-selector:
+test-width-height-selector: $(VENV_DIR)
 	@echo "Testing Width Height Selector specifically..."
-	@python -c "\
+	@$(PYTHON_CMD) -c "\
 	import sys, os; \
 	sys.path.insert(0, os.getcwd()); \
 	from kikotools.tools.width_height_selector.node import WidthHeightSelectorNode; \
@@ -176,4 +207,4 @@ test-width-height-selector:
 	"
 
 test-all-tools: test-resolution-calculator test-width-height-selector
-	@echo "🎉 All tool-specific tests completed!"
+	@echo "🎉 All tool-specific tests completed!"

SECURITY.md

@@ -0,0 +1,66 @@
+# Security Policy
+
+## Supported Versions
+
+ComfyUI-KikoTools is actively maintained. We provide security updates for the following versions:
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 1.x.x   | :white_check_mark: |
+| < 1.0   | :x:                |
+
+## Reporting a Vulnerability
+
+We take the security of ComfyUI-KikoTools seriously. If you believe you have found a security vulnerability, please report it to us as described below.
+
+### How to Report
+
+Please report security vulnerabilities by [opening a new issue](https://github.com/ComfyAssets/ComfyUI-KikoTools/issues/new) with the following:
+
+- Use the title prefix `[SECURITY]`
+- Provide a clear description of the vulnerability
+- Include steps to reproduce the issue
+- Specify the version(s) affected
+- If possible, suggest a fix or mitigation
+
+### What to Expect
+
+- **Response Time**: We aim to acknowledge receipt within 48 hours
+- **Investigation**: We will investigate and validate the reported vulnerability
+- **Updates**: We will keep you informed about the progress
+- **Resolution**: Once verified, we will work on a fix and release it as soon as possible
+- **Credit**: We will acknowledge your contribution in the release notes (unless you prefer to remain anonymous)
+
+### Scope
+
+Security vulnerabilities in scope include:
+
+- Code execution vulnerabilities in node implementations
+- Path traversal or file system access issues
+- API key or credential exposure
+- Dependency vulnerabilities that affect the project
+- Any issue that could compromise user data or system security
+
+### Out of Scope
+
+The following are generally not considered security vulnerabilities:
+
+- Issues in ComfyUI core (report these to the ComfyUI project)
+- Performance issues
+- Bugs that don't have security implications
+- Feature requests
+
+## Security Best Practices
+
+When using ComfyUI-KikoTools:
+
+- Keep your installation up to date
+- Store API keys (like Gemini API keys) securely using environment variables
+- Review generated files before sharing them
+- Be cautious with custom prompts that might expose sensitive information
+
+## Contact
+
+For urgent security matters, you can also reach out to the maintainers directly through GitHub.
+
+Thank you for helping keep ComfyUI-KikoTools secure!

TESTING.md

@@ -0,0 +1,166 @@
+# Testing and merge confidence
+
+Use regression tests before fixing a bug. Confirm that the test fails on the
+original implementation, then run the relevant suites after the fix.
+
+## What runs
+
+| Layer | Real components | Replaced boundaries |
+| --- | --- | --- |
+| Python | Tool logic, tensors, image files, API validation | ComfyUI services and external models where needed |
+| JavaScript | Production extension hooks and callback behavior | Minimal host objects; controlled timers for focused regressions |
+| Browser fixtures | All shipped extension imports and lifecycle registration; real plugin startup, HTTP routes, PNG thumbnails, selection persistence, and image loading | ComfyUI graph/widgets/settings/event interfaces and its saved-image serving endpoint |
+| Real ComfyUI | Pinned server/frontend, LiteGraph, native menus, DOM widgets, initial renderers, switching and workflow serialization | Disposable media routes; simulated execution/progress events; model/service boundaries |
+
+Browser workflows cover swaps, local image browsing/selection, pagination,
+sorting, hidden folders, directory autocomplete, saved paths,
+denied paths and network recovery, display output, seed persistence/cleanup, and
+workflow timing, autocomplete insertion, and saved-image previews. They run in Chromium, Firefox, WebKit, and touch Chromium.
+The harness binds to localhost and writes configuration, selections, and fixture
+images only inside a temporary directory. External browser requests fail tests;
+custom-word downloads are disabled in the fixture. No credentials, model
+weights, running ComfyUI, or GPU are required.
+
+## Run locally
+
+Use Python 3.10–3.13 and Node.js 24. Install the CPU PyTorch wheel on Linux if you
+do not need CUDA, then install the development dependencies:
+
+```sh
+python -m pip install torch --index-url https://download.pytorch.org/whl/cpu
+python -m pip install -r requirements-dev.txt
+python -m pytest tests
+python -m pytest tests --cov=kikotools --cov-report=term-missing
+npm ci --prefix tools/testing --ignore-scripts
+npx --prefix tools/testing playwright install --with-deps chromium firefox webkit
+npm test --prefix tools/testing
+npm run --prefix tools/testing test:coverage
+npm run --prefix tools/testing test:browser -- --project firefox --project webkit
+```
+
+`make test` runs the full pytest suite and propagates failures. `make coverage`,
+`make frontend-test`, `make browser-test`, and `make frontend-coverage` provide
+shortcuts. The Python Make targets use the existing virtual-environment setup.
+Install local commit and push hooks with `pre-commit install --hook-type
+pre-commit --hook-type pre-push`. The push hooks run Python and JavaScript
+regressions; CI additionally runs all browser workflows and coverage gates.
+For a quick browser check, use `test:browser -- --project chromium`.
+`KIKO_TEST_PYTHON` selects a Python executable with the development dependencies;
+`KIKO_TEST_PORT` changes the default port 8766. Servers are never reused.
+Unsupported Linux distributions may lack WebKit libraries; Ubuntu CI validates
+all engines.
+
+## Coverage and diagnosis
+
+Python CI checks all twelve Python/OS combinations and enforces 85% combined
+statement/branch coverage. Every production `web/*.js` file appears in frontend
+coverage, including code without behavioral coverage. V8 unit coverage and
+Chromium desktop/touch coverage are merged through c8. The committed per-file
+floors are an honest starting point, not a claim that every feature is tested.
+
+`npm run --prefix tools/testing coverage:update` reruns the suites and raises
+floors with two percentage points of runtime allowance. It cannot lower existing
+floors; new source files require 80% line coverage when added with this command.
+Missing measurements, missing baselines, and per-file regressions fail CI.
+
+CI artifacts include Python JUnit results, Python HTML/XML coverage, and
+`frontend-test-reports` with frontend HTML coverage and browser failure traces
+and screenshots. Open traces using Playwright's `show-trace` command. Local
+frontend coverage is at `coverage/js/index.html`.
+
+The fixture suite covers plugin behavior without a real ComfyUI frontend. The
+separate required real-host job covers the integration described below. GPU/model
+execution, cloud inference and model downloads still need targeted checks when
+changed; the compatibility suite does not queue workflows or download weights.
+Type checking and security jobs retain their existing advisory behavior.
+
+## Pinned real-ComfyUI compatibility
+
+The required **real ComfyUI compatibility** CI job provisions a CPU-only host.
+`tools/testing/comfyui-runtime.json` pins upstream commit
+`e8665ca8e4089ab917567cdb491308e1397663d4` (server 0.39.0), frontend 1.55.14,
+Python 3.12 and the CPU PyTorch/torchvision pair. The launcher rejects a different
+revision or modified tracked upstream files. The suite verifies server/frontend
+versions and attaches them to each test's report.
+
+Two projects, `classic-start` and `nodes2-start`, select the renderer during
+startup, before creating nodes. Both run the complete suite, including live
+renderer switching, zoom/resize, palette changes, workflow save/reload and
+cleanup. Test-local settings start from a blank workspace and skip first-run
+onboarding. They do not change the server's saved preferences.
+
+The migrated controls covered are Local Image Loader, Save Image, Seed History,
+Workflow Timer and its color picker, both dimension swap nodes, Node Dimensions,
+Display Text/Any, Embedding Autocomplete/settings/tag imports, Custom Colors and
+Follow Execution. Native canvas menus are opened with actual right clicks.
+Execution/progress events are simulated; generation is never queued.
+
+### Managed local host
+
+Use a separate clean checkout of the pinned ComfyUI commit and a Python 3.12
+environment containing its `requirements.txt` and this repository's
+`requirements-dev.txt`. Install the CPU torch/torchvision versions from the
+runtime manifest first, using the official CPU wheel index. The CI workflow in
+`.github/workflows/tests.yml` contains the full provisioning recipe.
+
+```sh
+KIKO_COMFY_ROOT=/path/to/pinned/ComfyUI \
+KIKO_TEST_PYTHON=/path/to/cpu-venv/bin/python \
+  npm run --prefix tools/testing test:comfyui
+```
+
+Playwright owns this host on `127.0.0.1:8189` and a fixture server on port 8771.
+The launcher creates a temporary base/user/model directory, installs only a
+symlink to the current KikoTools checkout, disables other custom nodes and
+partner services, and uses an in-memory database. It removes owned state after
+normal shutdown, startup failure or process termination. Existing installations
+and model folders are not used. An occupied port fails instead of reusing an
+unrelated server.
+
+### Existing local host
+
+An opt-in mode still supports an already running host with the same pinned
+versions:
+
+```sh
+KIKO_COMFY_URL=http://127.0.0.1:8188/ \
+  npm run --prefix tools/testing test:comfyui
+```
+
+Only loopback URLs are accepted. A separate browser context serves the current
+checkout's extensions. Media requests use real plugin Python routes with
+disposable fixture data. Other HTTP writes are intercepted, preserving server
+settings, saved workflows and selections. This mode does not start or stop the
+existing server.
+
+### Reports and pin updates
+
+CI retains `real-comfyui-reports` for 14 days, including server startup logs at
+`tools/testing/test-results/comfyui-host.log`, browser traces, screenshots and
+version attachments. Startup logs survive failure. Reviewed captures copied to
+[docs/screenshots](docs/screenshots/README.md) are committed separately from
+throwaway test artifacts.
+
+To update the host, review and change the runtime manifest, provision the new
+checkout/dependencies, and run both startup projects before merging. A version
+assertion update alone is not compatibility validation. Cross-pack installation
+and shared-source version compatibility remain tracked in #81.
+
+## Required merge checks
+
+The manifest in `.github/branch-protection.json` requires all Python matrix jobs,
+Python coverage, frontend syntax, frontend workflows/coverage, real ComfyUI
+compatibility, and the existing
+`code-quality` job (including Black and fatal lint checks). Administrators follow
+the same checks and branches must be current with main. No extra human approval
+is required. Workflows run on every pull request without path filters.
+
+After the checks pass, an administrator applies and verifies the manifest:
+
+```sh
+gh api --method PUT repos/ComfyAssets/ComfyUI-KikoTools/branches/main/protection \
+  --input .github/branch-protection.json
+gh api repos/ComfyAssets/ComfyUI-KikoTools/branches/main/protection/required_status_checks
+```
+
+Keep the manifest synchronized with job names when changing CI.

__init__.py

@@ -3,12 +3,126 @@ ComfyUI-KikoTools: Modular collection of custom ComfyUI nodes
 All nodes are grouped under the "ComfyAssets" category
 """
 
-from .kikotools import NODE_CLASS_MAPPINGS, NODE_DISPLAY_NAME_MAPPINGS
+import re
+from pathlib import Path
+
+try:
+    from .kikotools import NODE_CLASS_MAPPINGS, NODE_DISPLAY_NAME_MAPPINGS
+except ImportError:
+    # Fallback for testing environment
+    from kikotools import NODE_CLASS_MAPPINGS, NODE_DISPLAY_NAME_MAPPINGS
 
 # Tell ComfyUI where to find our JavaScript extensions
-WEB_DIRECTORY = "./web"
+import os
 
-# Print startup message
-print("\033[94m[ComfyUI-KikoTools] Loaded with swap button support!\033[0m")
+WEB_DIRECTORY = os.path.join(os.path.dirname(os.path.abspath(__file__)), "web")
+
+# Import server components at module level to ensure they're available
+try:
+    from aiohttp import web
+    from server import PromptServer
+    import folder_paths
+
+    print("[KikoTools] Server imports successful")
+
+    # Register autocomplete endpoints directly
+    @PromptServer.instance.routes.get("/kikotools/autocomplete/embeddings")
+    async def get_embeddings(request):
+        """API endpoint for getting list of embeddings with full paths."""
+        print("[KikoTools] Embeddings endpoint called")
+        try:
+            embedding_files = folder_paths.get_filename_list("embeddings")
+            print(f"[KikoTools] Found {len(embedding_files)} embedding files")
+            # Return embeddings with their subdirectory paths, without extensions
+            embeddings = []
+            for f in embedding_files:
+                # Remove extension but keep subdirectory path
+                clean_path = os.path.splitext(f)[0]
+                embeddings.append(
+                    {
+                        "file_name": clean_path,
+                        "model_name": clean_path,
+                        "name": os.path.basename(clean_path),
+                        "path": clean_path,
+                    }
+                )
+            if len(embeddings) > 0:
+                print(f"[KikoTools] Sample embedding: {embeddings[0]}")
+            print(f"[KikoTools] Returning {len(embeddings)} embeddings with paths")
+            return web.json_response(embeddings)
+        except Exception as e:
+            print(f"[KikoTools] Error getting embeddings: {e}")
+            import traceback
+
+            traceback.print_exc()
+            return web.json_response([])
+
+    @PromptServer.instance.routes.get("/kikotools/autocomplete/loras")
+    async def get_loras(request):
+        """API endpoint for getting list of LoRAs."""
+        print("[KikoTools] LoRA endpoint called")
+        try:
+            lora_files = folder_paths.get_filename_list("loras")
+            print(f"[KikoTools] Found {len(lora_files)} LoRA files")
+            # Return LoRAs with paths
+            loras = []
+            for f in lora_files:
+                clean_path = os.path.splitext(f)[0]
+                loras.append(
+                    {
+                        "name": os.path.basename(clean_path),
+                        "path": clean_path,
+                        "file": f,
+                    }
+                )
+            print(f"[KikoTools] Returning {len(loras)} LoRAs")
+            return web.json_response(loras)
+        except Exception as e:
+            print(f"[KikoTools] Error getting LoRAs: {e}")
+            import traceback
+
+            traceback.print_exc()
+            return web.json_response([])
+
+    print("[KikoTools] Autocomplete API endpoints registered successfully")
+    print(
+        "[KikoTools] Routes available: /kikotools/autocomplete/embeddings and /kikotools/autocomplete/loras"
+    )
+
+except ImportError as e:
+    print(f"[KikoTools] Could not import server components: {e}")
+except Exception as e:
+    print(f"[KikoTools] Unexpected error setting up API: {e}")
+    import traceback
+
+    traceback.print_exc()
+
+# API endpoints are registered above at module import time
+
+
+def get_version():
+    """Parse version from pyproject.toml"""
+    try:
+        pyproject_path = Path(__file__).parent / "pyproject.toml"
+        if pyproject_path.exists():
+            content = pyproject_path.read_text(encoding="utf-8")
+            match = re.search(r'version\s*=\s*["\']([^"\']+)["\']', content)
+            if match:
+                return match.group(1)
+    except Exception:
+        pass
+    return "unknown"
+
+
+# Print startup message with loaded tools
+print()
+print(f"\033[94m[ComfyUI-KikoTools] Version:\033[0m {get_version()}")
+for node_key, display_name in NODE_DISPLAY_NAME_MAPPINGS.items():
+    # ASCII only: a Windows console using a legacy code page cannot print emoji,
+    # and a UnicodeEncodeError here would abort loading the whole node.
+    ascii_name = display_name.encode("ascii", "ignore").decode().strip()
+    print(f"  \033[94mLoaded:\033[0m {ascii_name}")
+print(f"\033[94mTotal: {len(NODE_CLASS_MAPPINGS)} tools loaded\033[0m")
+print()
 
 __all__ = ["NODE_CLASS_MAPPINGS", "NODE_DISPLAY_NAME_MAPPINGS", "WEB_DIRECTORY"]

docs/screenshots/README.md

@@ -0,0 +1,22 @@
+# ComfyAssets UI screenshots
+
+Retained captures from the KikoTools UI migrations. Real-ComfyUI tests cover
+Classic and Nodes 2.0, renderer switching, saved workflows and cleanup.
+
+| Interface | Captures |
+| --- | --- |
+| Local Image Loader | [Classic](live-image-loader/classic.png), [Nodes 2.0](live-image-loader/nodes2.png) |
+| Saved-image viewer | [Dark](save-image-viewer/dark.png), [Light](save-image-viewer/light.png) |
+| Seed History | [Dark](seed-history/dark.png), [Light](seed-history/light.png) |
+| Workflow Timer | [Dark](workflow-timer/dark.png), [Light](workflow-timer/light.png), [Color picker](workflow-timer/color-picker.png) |
+| Dimension swap | [Selector dark](dimension-swap/selector-dark.png), [Selector light](dimension-swap/selector-light.png), [Latent dark](dimension-swap/latent-dark.png), [Latent light](dimension-swap/latent-light.png) |
+| Node Dimensions | [Dark](node-dimensions/dark.png), [Light](node-dimensions/light.png) |
+| Display Text | [Dark](display-output/text-dark.png), [Light](display-output/text-light.png) |
+| Display Any | [Dark](display-output/any-dark.png), [Light](display-output/any-light.png) |
+| Embedding Autocomplete | [Suggestions dark](embedding-autocomplete/suggestions-dark.png), [Suggestions light](embedding-autocomplete/suggestions-light.png), [Settings dark](embedding-autocomplete/settings-dark.png), [Settings light](embedding-autocomplete/settings-light.png) |
+| Custom Colors | [Dark](custom-colors/dark.png), [Light](custom-colors/light.png) |
+| Follow Execution | [Classic](follow-execution/classic.png), [Nodes 2.0](follow-execution/nodes2.png) |
+
+Screenshots record the tested appearance at capture time. Updated Playwright
+captures are temporary test artifacts until copied into this directory and
+committed for review.

docs/tag-packs/README.md

@@ -0,0 +1,48 @@
+# Autocomplete tag packs
+
+ComfyAssets prepares filtered autocomplete data from Danbooru's public
+`tags.json` and `tag_aliases.json` APIs. Dataset releases are versioned separately
+from KikoTools and stored as release assets, keeping bulk data out of Git history.
+
+## Danbooru — Illustrious / NoobAI, 2026-10-16
+
+[Download the CSV and manifest](https://github.com/ComfyAssets/ComfyUI-KikoTools/releases/tag/tags-2026-10-16).
+This snapshot contains 165,158 canonical tags, their categories, post counts, and
+aliases. The adjacent manifest records the retrieval date, model targets,
+selection filters, schema, byte size, and SHA-256 checksum.
+
+The UTF-8 CSV has no header. Columns are `tag,category,post_count,aliases`.
+Aliases share a comma-separated field; use a CSV parser that respects quoting.
+An empty alias field means no aliases. Category codes are 0 (general), 1
+(artist), 3 (copyright), 4 (character), and 5 (meta).
+
+In ComfyUI Settings, search **Embedding Autocomplete**, open its settings,
+then download the pack and choose the CSV under **Tag list file**. Enable
+**Show Custom Words** and select **Save Settings**. Importing stages the list;
+Cancel leaves the active list unchanged. The browser caches the saved file in
+IndexedDB for offline use and restores it after a refresh. Clearing browser site
+data removes this cache. There is no server-side autocomplete folder to populate.
+
+Alternatively, enter a CSV/TXT URL and select **Load URL**, then save. Remote
+servers must allow browser cross-origin requests; for GitHub release assets,
+download and import the file locally. Existing one-column word lists and
+`tag,frequency` lists remain supported. The default URL is unchanged.
+
+Parsing runs in a Web Worker with a 32 MB UTF-8 limit. Search checks canonical
+names and aliases, inserts the canonical tag, and ranks exact matches ahead of
+prefixes and substrings, then by descending post count. The number of displayed
+results is bounded by Maximum suggestions. Categories are retained in records;
+category-specific controls are not currently exposed.
+
+## Source and terms
+
+Source data: [Danbooru](https://danbooru.donmai.us/), collected 2026-10-16.
+Selection and packaging: ComfyAssets. This is an independent filtered snapshot,
+not an official Danbooru release or a guarantee of model compatibility.
+
+Refer to [Danbooru's Terms of Service](https://danbooru.donmai.us/terms) and the
+[official terms template](https://github.com/danbooru/danbooru/blob/master/app/views/static/terms_of_service.html.erb).
+The template's Copyright Infringement section identifies tags as factual
+information that is generally not copyrightable. Its API Usage section requires
+compliance with API rate limits. This reference does not claim an explicit
+dataset license or extend KikoTools' software license to upstream data.

docs/tag-packs/danbooru-illustrious-noobai-2026-10-16.manifest.json

@@ -0,0 +1,35 @@
+{
+  "source": "danbooru.donmai.us tags.json + tag_aliases.json",
+  "pulled": "2026-10-16",
+  "target_models": "Illustrious 1.0-3.x, NoobAI-XL",
+  "filters": {
+    "created_before": "2025-01-01",
+    "min_post_count": {
+      "general": 50,
+      "artist": 30,
+      "copyright": 20,
+      "character": 20
+    },
+    "artists_kept": true,
+    "deprecated_removed": true,
+    "meta_tags": "removed except small allowlist"
+  },
+  "tag_count": 165158,
+  "schema_version": 1,
+  "file": "danbooru-illustrious-noobai-2026-10-16.csv",
+  "encoding": "UTF-8",
+  "header_row": false,
+  "columns": [
+    "tag",
+    "category",
+    "post_count",
+    "aliases"
+  ],
+  "aliases_format": "Comma-separated inside a CSV-quoted field when necessary",
+  "size_bytes": 3979593,
+  "sha256": "733531a60f2e2d38925f53381b18cff21513ef14550d1f2ca670a0f55b86b798",
+  "prepared_by": "ComfyAssets",
+  "terms_url": "https://danbooru.donmai.us/terms",
+  "terms_source_url": "https://github.com/danbooru/danbooru/blob/master/app/views/static/terms_of_service.html.erb",
+  "release_tag": "tags-2026-10-16"
+}

docs/ui-migration.md

@@ -0,0 +1,44 @@
+# KikoTools UI migration
+
+KikoTools' custom controls use the original ComfyAssets foundation in `web/ui/`.
+They share blue primary actions, red destructive actions, keyboard controls and
+ComfyUI-following dark/light colors. Layouts resize with the available space.
+Pixaroma's toolkit inspired the organization; its code/assets are not vendored.
+
+| Interface | Shared implementation | Retained examples |
+| --- | --- | --- |
+| Local Image Loader | `views/image-browser.js`, controls and scoped controller | [Loader](screenshots/live-image-loader/) |
+| Save Image | Floating window, batch selection and responsive preview | [Viewer](screenshots/save-image-viewer/) |
+| Seed History | `views/seed-history.js`, scoped watcher and disclosure | [History](screenshots/seed-history/) |
+| Workflow Timer | Shared clock, controls and color picker | [Timer](screenshots/workflow-timer/) |
+| Width Height / Empty Latent swaps | `ui/dimension-swap.js`, `ui/dimensions.js` | [Swaps](screenshots/dimension-swap/) |
+| Node Dimensions | `views/node-dimensions.js`, native dialog shell | [Dimensions](screenshots/node-dimensions/) |
+| Display Text / Any | Shared output view, controller and widget adapter | [Output](screenshots/display-output/) |
+| Embedding Autocomplete | Shared suggestions/settings, worker parsing and cache | [Autocomplete](screenshots/embedding-autocomplete/) |
+| Custom Colors | Shared color picker, native node/group menus | [Colors](screenshots/custom-colors/) |
+| Follow Execution | Native host menus/settings, idempotent execution listeners | [Menus](screenshots/follow-execution/) |
+
+`createScope()` owns listeners, observers and delayed work. Node removal preserves
+previous lifecycle hooks while disposing owned resources. Host-specific text
+widget handling lives in `ui/text-widget-adapter.js`; floating windows and native
+dialogs manage their own focus and cleanup. See [module notes](../web/ui/README.md).
+
+Pure Python nodes continue using ComfyUI's native widgets. Gemini Prompt
+Engineer retains its legacy UI for saved workflows under the agreed deprecation;
+its UI migration was cancelled.
+
+The [test guide](../TESTING.md) distinguishes fixture coverage, real-host
+compatibility and model/GPU behavior. Required real-host CI uses a reviewed
+upstream commit, fresh Classic/Nodes 2.0 starts and disposable CPU-only state.
+
+## Remaining shared-toolset work
+
+Before PromptManager adopts the foundation, extract a versioned shared source
+package with reproducible browser artifacts. Then test both node packs alone and
+together, including different bundled foundation versions, isolated settings
+and identical styling. These requirements remain open in issue #81; the KikoTools
+migration does not establish cross-pack compatibility by itself.
+
+The approved design-preview draft [#82](https://github.com/ComfyAssets/ComfyUI-KikoTools/pull/82)
+records the original direction. This inventory describes the shipped interfaces
+and supersedes that draft's implementation sequence.

example.py

@@ -0,0 +1,366 @@
+import os
+from typing import Tuple
+
+import comfy.sd
+import comfy.utils
+import torch
+import torch.nn.functional as F
+from comfy.sd import CLIP
+from diffusers import ConsistencyDecoderVAE
+from folder_paths import get_folder_paths
+from huggingface_hub import hf_hub_download
+from torch import Tensor
+
+
+def find_or_create_cache():
+    cwd = os.getcwd()
+    if os.path.exists(os.path.join(cwd, "ComfyUI")):
+        cwd = os.path.join(cwd, "ComfyUI")
+    if os.path.exists(os.path.join(cwd, "models")):
+        cwd = os.path.join(cwd, "models")
+    if not os.path.exists(os.path.join(cwd, "huggingface_cache")):
+        print("Creating huggingface_cache directory within comfy")
+        os.mkdir(os.path.join(cwd, "huggingface_cache"))
+
+    return str(os.path.join(cwd, "huggingface_cache"))
+
+
+class ConsistencyDecoder:
+    @classmethod
+    def INPUT_TYPES(s):
+        return {"required": {"latent": ("LATENT",)}}
+
+    RETURN_TYPES = ("IMAGE",)
+    FUNCTION = "decode"
+    CATEGORY = "latent"
+
+    def __init__(self):
+        self.vae = (
+            ConsistencyDecoderVAE.from_pretrained(
+                "openai/consistency-decoder",
+                torch_dtype=torch.float16,
+                variant="fp16",
+                use_safetensors=True,
+                cache_dir=find_or_create_cache(),
+            )
+            .eval()
+            .to("cuda")
+        )
+
+    def _decode(self, latent):
+        """Used when patching another vae."""
+        return self.vae.decode(latent.half().cuda()).sample
+
+    def decode(self, latent):
+        """Used for standalone decoding."""
+        sample = self._decode(latent["samples"])
+        sample = sample.clamp(-1, 1).movedim(1, -1).add(1.0).mul(0.5).cpu()
+        return (sample,)
+
+
+class PatchDecoderTiled:
+    @classmethod
+    def INPUT_TYPES(s):
+        return {"required": {"vae": ("VAE",)}}
+
+    RETURN_TYPES = ("VAE",)
+    FUNCTION = "patch"
+    category = "vae"
+
+    def __init__(self):
+        self.vae = ConsistencyDecoder()
+
+    def patch(self, vae):
+        del vae.first_stage_model.decoder
+        vae.first_stage_model.decode = self.vae._decode
+        vae.decode = (
+            lambda x: vae.decode_tiled_(
+                x,
+                tile_x=512,
+                tile_y=512,
+                overlap=64,
+            )
+            .to("cuda")
+            .movedim(1, -1)
+        )
+
+        return (vae,)
+
+
+# quick node to set SDXL-friendly aspect ratios in 1024^2
+# adapted from throttlekitty
+class SDXLAspectRatio:
+    def __init__(self):
+        pass
+
+    @classmethod
+    def INPUT_TYPES(s):
+        return {
+            "required": {
+                "image": ("IMAGE",),
+            }
+        }
+
+    RETURN_TYPES = ("INT", "INT")
+    RETURN_NAMES = ("width", "height")
+    FUNCTION = "run"
+    CATEGORY = "image"
+
+    def run(self, image: Tensor) -> Tuple[int, int]:
+        _, height, width, _ = image.shape
+        aspect_ratio = width / height
+
+        aspect_ratios = (
+            (1 / 1, 1024, 1024),
+            (2 / 3, 832, 1216),
+            (3 / 4, 896, 1152),
+            (5 / 8, 768, 1216),
+            (9 / 16, 768, 1344),
+            (9 / 19, 704, 1472),
+            (9 / 21, 640, 1536),
+            (3 / 2, 1216, 832),
+            (4 / 3, 1152, 896),
+            (8 / 5, 1216, 768),
+            (16 / 9, 1344, 768),
+            (19 / 9, 1472, 704),
+            (21 / 9, 1536, 640),
+        )
+
+        # find the closest aspect ratio
+        closest = min(aspect_ratios, key=lambda x: abs(x[0] - aspect_ratio))
+
+        return (closest[1], closest[2])
+
+
+class ImageToMultipleOf:
+    @classmethod
+    def INPUT_TYPES(s):
+        return {
+            "required": {
+                "image": ("IMAGE",),
+                "multiple_of": (
+                    "INT",
+                    {
+                        "default": 64,
+                        "min": 1,
+                        "max": 256,
+                        "step": 16,
+                        "display": "number",
+                    },
+                ),
+                "method": (["center crop", "rescale"],),
+            }
+        }
+
+    RETURN_TYPES = ("IMAGE",)
+    RETURN_NAMES = ("image",)
+    FUNCTION = "run"
+    CATEGORY = "image"
+
+    def run(self, image: Tensor, multiple_of: int, method: str) -> Tuple[Tensor]:
+        """Center crop the image to a specific multiple of a number."""
+        _, height, width, _ = image.shape
+
+        new_height = height - (height % multiple_of)
+        new_width = width - (width % multiple_of)
+
+        if method == "rescale":
+            return (
+                F.interpolate(
+                    image.unsqueeze(0),
+                    size=(new_height, new_width),
+                    mode="bilinear",
+                    align_corners=False,
+                ).squeeze(0),
+            )
+        else:
+            top = (height - new_height) // 2
+            left = (width - new_width) // 2
+            bottom = top + new_height
+            right = left + new_width
+            return (image[:, top:bottom, left:right, :],)
+
+
+class HFHubLoraLoader:
+    def __init__(self):
+        self.loaded_lora = None
+        self.loaded_lora_path = None
+
+    @classmethod
+    def INPUT_TYPES(s):
+        return {
+            "required": {
+                "model": ("MODEL",),
+                "clip": ("CLIP",),
+                "repo_id": ("STRING", {"default": ""}),
+                "subfolder": ("STRING", {"default": ""}),
+                "filename": ("STRING", {"default": ""}),
+                "strength_model": (
+                    "FLOAT",
+                    {"default": 1.0, "min": -20.0, "max": 20.0, "step": 0.01},
+                ),
+                "strength_clip": (
+                    "FLOAT",
+                    {"default": 1.0, "min": -20.0, "max": 20.0, "step": 0.01},
+                ),
+            }
+        }
+
+    RETURN_TYPES = ("MODEL", "CLIP")
+    FUNCTION = "load_lora"
+
+    CATEGORY = "loaders"
+
+    def load_lora(
+        self,
+        model,
+        clip,
+        repo_id: str,
+        subfolder: str,
+        filename: str,
+        strength_model: float,
+        strength_clip: float,
+    ):
+        if strength_model == 0 and strength_clip == 0:
+            return (model, clip)
+
+        lora_path = hf_hub_download(
+            repo_id=repo_id.strip(),
+            subfolder=(
+                None
+                if subfolder is None or subfolder.strip() == ""
+                else subfolder.strip()
+            ),
+            filename=filename.strip(),
+            cache_dir=find_or_create_cache(),
+        )
+
+        lora = None
+        if self.loaded_lora is not None:
+            if self.loaded_lora_path == lora_path:
+                lora = self.loaded_lora
+            else:
+                self.loaded_lora = None
+                self.loaded_lora_path = None
+
+        if lora is None:
+            lora = comfy.utils.load_torch_file(lora_path, safe_load=True)
+            self.loaded_lora = lora
+            self.loaded_lora_path = lora_path
+
+        model_lora, clip_lora = comfy.sd.load_lora_for_models(
+            model, clip, lora, strength_model, strength_clip
+        )
+        return (model_lora, clip_lora)
+
+
+class HFHubEmbeddingLoader:
+    """Load a text model embedding from Huggingface Hub.
+    The connected CLIP model is not manipulated."""
+
+    @classmethod
+    def INPUT_TYPES(s):
+        return {
+            "required": {
+                "clip": ("CLIP",),
+                "repo_id": ("STRING", {"default": ""}),
+                "subfolder": ("STRING", {"default": ""}),
+                "filename": ("STRING", {"default": ""}),
+            }
+        }
+
+    RETURN_TYPES = ("CLIP",)
+    FUNCTION = "download_embedding"
+
+    CATEGORY = "n/a"
+
+    def download_embedding(
+        self,
+        clip: CLIP,  # added to signify it's best put in between nodes
+        repo_id: str,
+        subfolder: str,
+        filename: str,
+    ):
+        hf_hub_download(
+            repo_id=repo_id.strip(),
+            subfolder=(
+                None
+                if subfolder is None or subfolder.strip() == ""
+                else subfolder.strip()
+            ),
+            filename=filename.strip(),
+            local_dir=get_folder_paths("embeddings")[0],
+        )
+
+        return (clip,)
+
+
+class GlifVariable:
+    @classmethod
+    def INPUT_TYPES(s):
+        return {
+            "required": {
+                "variable": (
+                    [
+                        "",
+                    ],
+                ),
+                "fallback": (
+                    "STRING",
+                    {
+                        "default": "",
+                        "single_line": True,
+                    },
+                ),
+            }
+        }
+
+    RETURN_TYPES = ("STRING", "INT", "FLOAT")
+    FUNCTION = "do_it"
+
+    CATEGORY = "glif/variables"
+
+    @classmethod
+    def VALIDATE_INPUTS(cls, variable: str, fallback: str):
+        # Since we populate dynamically, comfy will report invalid inputs. Override to always return True
+        return True
+
+    def do_it(self, variable: str, fallback: str):
+        variable = variable.strip()
+        fallback = fallback.strip()
+        if variable == "" or (variable.startswith("{") and variable.endswith("}")):
+            variable = fallback
+
+        int_val = 0
+        float_val = 0.0
+        string_val = f"{variable}"
+        try:
+            int_val = int(variable)
+        except Exception:
+            pass
+        try:
+            float_val = float(variable)
+        except Exception:
+            pass
+        return (string_val, int_val, float_val)
+
+
+NODE_CLASS_MAPPINGS = {
+    "GlifConsistencyDecoder": ConsistencyDecoder,
+    "GlifPatchConsistencyDecoderTiled": PatchDecoderTiled,
+    "SDXLAspectRatio": SDXLAspectRatio,
+    "ImageToMultipleOf": ImageToMultipleOf,
+    "HFHubLoraLoader": HFHubLoraLoader,
+    "HFHubEmbeddingLoader": HFHubEmbeddingLoader,
+    "GlifVariable": GlifVariable,
+}
+
+NODE_DISPLAY_NAME_MAPPINGS = {
+    "GlifConsistencyDecoder": "Consistency VAE Decoder",
+    "GlifPatchConsistencyDecoderTiled": "Patch Consistency VAE Decoder",
+    "SDXLAspectRatio": "Image to SDXL compatible WH",
+    "ImageToMultipleOf": "Image to Multiple of",
+    "HFHubLoraLoader": "Load HF Lora",
+    "HFHubEmbeddingLoader": "Load HF Embedding",
+    "GlifVariable": "Glif Variable",
+}

examples/documentation/batch_prompts.md

@@ -0,0 +1,106 @@
+# Batch Prompts Node
+
+The **Batch Prompts** node loads and processes prompts from text files for batch generation workflows. It automatically cycles through prompts with each execution, making it perfect for testing multiple prompts in queue batches.
+
+## Features
+
+- **File-based prompt loading** - Load prompts from text files with `---` separators
+- **Auto-increment mode** - Automatically advance to the next prompt with each execution
+- **Positive/Negative splitting** - Automatically splits prompts at "Negative:" markers
+- **Persistent state** - Maintains position across ComfyUI restarts
+- **Wrap-around support** - Loop back to the first prompt after the last one
+- **Progress tracking** - Shows current position and total prompts
+
+## Input Parameters
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `prompt_file` | STRING | "prompts.txt" | Path to text file containing prompts |
+| `index` | INT | 0 | Manual prompt index (when auto_increment is off) |
+| `auto_increment` | BOOLEAN | True | Automatically advance to next prompt |
+| `wrap_around` | BOOLEAN | True | Loop back to start after last prompt |
+| `split_negative` | BOOLEAN | True | Split prompts at "Negative:" marker |
+| `reload_file` | BOOLEAN | False | Force reload file from disk |
+| `show_preview` | BOOLEAN | True | Show prompt preview in console |
+
+## Output Values
+
+| Output | Type | Description |
+|--------|------|-------------|
+| `positive` | STRING | The positive prompt text |
+| `negative` | STRING | The negative prompt text (if split) |
+| `full_prompt` | STRING | Complete prompt including negative |
+| `next_prompt` | STRING | Preview of the next prompt |
+| `current_index` | INT | Current prompt index (0-based) |
+| `total_prompts` | INT | Total number of prompts |
+| `batch_info` | STRING | Progress information string |
+
+## Prompt File Format
+
+Create a text file with prompts separated by `---` on its own line:
+
+```
+A beautiful sunset over the ocean
+Negative: blurry, dark, low quality
+---
+Mountain landscape with snow peaks
+Negative: foggy, unclear
+---
+Futuristic city at night
+Negative: old, vintage, sepia
+```
+
+## Usage Examples
+
+### Basic Queue Batch Processing
+
+1. Create a prompt file in your ComfyUI `input` folder
+2. Add the Batch Prompts node to your workflow
+3. Set `prompt_file` to your file name
+4. Enable `auto_increment` and `wrap_around`
+5. Connect `positive` to your text encoder
+6. Connect `negative` to your negative text encoder
+7. Set Queue Batch to desired number (e.g., 10)
+8. Run the queue - prompts will cycle automatically
+
+### Manual Index Control
+
+For manual control over which prompt to use:
+
+1. Set `auto_increment` to False
+2. Control the `index` parameter manually
+3. Use with other nodes that provide index values
+
+### Monitoring Progress
+
+The node provides several ways to track progress:
+
+- `batch_info` output shows "Prompt X of Y (Z% complete)"
+- Console logging shows current prompt preview (when `show_preview` is True)
+- `current_index` and `total_prompts` for custom progress displays
+
+## Tips
+
+- Place prompt files in the ComfyUI `input` folder for easy access
+- Use relative paths like "prompts.txt" for files in the input folder
+- Use absolute paths for files elsewhere on your system
+- The node maintains state across ComfyUI restarts
+- Set `reload_file` to True to force re-reading after editing the file
+- Empty sections (between `---` markers) are automatically skipped
+
+## Troubleshooting
+
+### Prompts not changing in queue batch
+- Ensure `auto_increment` is set to True
+- Check console for "[BatchPrompts] Auto-increment" messages
+- Restart ComfyUI after installing/updating the node
+
+### File not found errors
+- Check that the file exists in the ComfyUI `input` folder
+- Try using an absolute path to test
+- Ensure file has read permissions
+
+### State persistence
+- State is stored in your system's temp directory
+- Clear `/tmp/comfyui_batch_prompts/` to reset all counters
+- Use `reload_file` to reset counter for a specific file

examples/documentation/display_any.md

@@ -0,0 +1,120 @@
+# Display Any
+
+The Display Any node is a debugging and inspection tool that can display any type of input value in ComfyUI. It's particularly useful for understanding data structures and tensor shapes during workflow development.
+
+## Features
+
+- **Universal Input**: Accepts any type of input data (tensors, strings, numbers, lists, dictionaries, etc.)
+- **Two Display Modes**:
+  - **Raw Value**: Shows the string representation of the input
+  - **Tensor Shape**: Extracts and displays the shapes of any tensors found in the input
+- **Nested Structure Support**: Can find tensors within nested dictionaries and lists
+- **UI Output**: Displays results directly in the ComfyUI interface
+
+## Inputs
+
+- **input** (*): Any value you want to display or inspect
+- **mode** (DROPDOWN): Display mode selection
+  - `raw value`: Shows the complete string representation of the input
+  - `tensor shape`: Extracts and shows shapes of any tensors in the input
+
+## Outputs
+
+- **display_text** (STRING): The formatted display text
+
+## Usage Examples
+
+### 1. Display Simple Values
+
+Connect any output to see its raw value:
+```
+String Input: "Hello, ComfyUI!"
+Mode: raw value
+Output: "Hello, ComfyUI!"
+```
+
+### 2. Inspect Tensor Shapes
+
+Great for debugging image processing pipelines:
+```
+Image Tensor: [1, 3, 512, 512]
+Mode: tensor shape
+Output: "[[1, 3, 512, 512]]"
+```
+
+### 3. Debug Complex Data Structures
+
+View nested data structures with multiple tensors:
+```python
+Input: {
+    "images": tensor([1, 3, 256, 256]),
+    "masks": [tensor([256, 256]), tensor([256, 256, 1])],
+    "config": {"steps": 20}
+}
+Mode: tensor shape
+Output: "[[1, 3, 256, 256], [256, 256], [256, 256, 1]]"
+```
+
+### 4. Workflow Debugging
+
+Use Display Any nodes at various points in your workflow to understand data flow:
+- After loading images to verify dimensions
+- Before/after processing nodes to track shape changes
+- To inspect conditioning or latent data structures
+- To view metadata or configuration dictionaries
+
+## Use Cases
+
+### Image Pipeline Debugging
+Place Display Any nodes after image loading and processing nodes to track dimension changes:
+```
+Load Image → Display Any (tensor shape) → Resize → Display Any (tensor shape)
+```
+
+### Latent Space Inspection
+Understand latent dimensions in your workflows:
+```
+VAE Encode → Display Any (tensor shape) → KSampler → Display Any (raw value)
+```
+
+### Configuration Verification
+Display complex configuration objects to ensure correct settings:
+```
+Config Node → Display Any (raw value) → Processing Node
+```
+
+## Tips
+
+1. **Multiple Display Nodes**: You can use multiple Display Any nodes in a single workflow to track data at different stages
+
+2. **Tensor Shape Mode**: Particularly useful when working with:
+   - Image batches to verify batch size
+   - Latent tensors to understand dimensions
+   - Mask arrays to check compatibility
+
+3. **Raw Value Mode**: Best for:
+   - String prompts and text
+   - Configuration dictionaries
+   - Debugging node outputs
+   - Understanding data structure
+
+4. **No Tensors Found**: If you see "No tensors found in input" in tensor shape mode, the input doesn't contain any tensor-like objects (numpy arrays, torch tensors, etc.)
+
+## Technical Notes
+
+- The node uses `str()` for raw value display, providing Python's string representation
+- Tensor shape detection works with any object that has a `shape` attribute
+- Nested structure traversal supports dictionaries, lists, and tuples
+- The output is both displayed in the UI and available as a string output for further processing
+
+## Example Workflow Integration
+
+```
+[Load Image] → [Image Processing] → [Display Any (tensor shape)]
+                                           ↓
+                                    "[[1, 3, 512, 512]]"
+                                           ↓
+[Text Multiline] ← [Concatenate] ← "Image dimensions: "
+```
+
+This creates a text output showing the current image dimensions that can be used elsewhere in your workflow.

examples/documentation/display_text.md

@@ -0,0 +1,147 @@
+# Display Text
+
+The Display Text node provides advanced text display capabilities with smart formatting, interactive features, and responsive design for ComfyUI workflows.
+
+## Features
+
+- **Smart Prompt Detection**: Automatically detects and formats SDXL-style positive/negative prompt pairs
+- **Text Wrapping**: Proper word wrapping that reflows when node is resized
+- **Scrollable Content**: Mouse wheel scrolling for long texts with visual indicators
+- **Copy Functionality**: Always-visible copy button with visual feedback
+- **Split View Mode**: Side-by-side display for prompt pairs
+- **Responsive Design**: Content adapts to node resizing
+
+## Inputs
+
+- **text** (STRING): The text to display
+  - Can be a single text block
+  - Can contain "Positive prompt:" and "Negative prompt:" sections for automatic split view
+
+## Outputs
+
+- **text** (STRING): Pass-through of the input text
+
+## Display Modes
+
+### Single Text Mode
+
+When the input is regular text without prompt markers, it displays as a single scrollable text area with:
+- Word wrapping at word boundaries
+- Vertical scrolling for long content
+- Single copy button for the entire text
+
+### Split View Mode
+
+Automatically activated when text contains both "Positive prompt:" and "Negative prompt:" sections:
+- Side-by-side display with 50/50 split
+- Independent scrolling for each section
+- Separate copy buttons for each prompt
+- Labels are stripped when copying (clean prompts)
+
+## Usage Examples
+
+### 1. Display Generated Prompts
+
+```
+Gemini Prompt → Display Text → Copy to workflow
+```
+The node automatically detects SDXL format and shows positive/negative prompts side-by-side.
+
+### 2. Debug Text Processing
+
+```
+Text Processing → Display Text → Further Processing
+```
+View intermediate text processing results with proper formatting.
+
+### 3. Show Long Descriptions
+
+```
+Load Text → Display Text → Review
+```
+Display long text content with scrolling and word wrapping.
+
+## Interactive Features
+
+### Copy Button
+- Always visible in the top-right corner
+- Shows "✓ Copied!" feedback on click
+- In split view: separate buttons for each section
+- Strips prompt labels for clean copying
+
+### Scrolling
+- Mouse wheel scrolling when hovering over text
+- Visual indicators appear when content is scrollable
+- Smooth scrolling with proper boundaries
+- Independent scrolling in split view mode
+
+### Resizing
+- Text reflows when node width changes
+- Maintains readability at different sizes
+- Split view maintains 50/50 proportions
+- Minimum height ensures usability
+
+## Smart Prompt Detection
+
+The node intelligently detects prompt formats:
+
+1. **SDXL Format**:
+   - Looks for "Positive prompt:" and "Negative prompt:" markers
+   - Case-insensitive detection
+   - Handles various formatting styles
+
+2. **Label Stripping**:
+   - When copying from split view, labels are removed
+   - "Positive prompt: beautiful sunset" → "beautiful sunset"
+   - Clean prompts ready for direct use
+
+## Styling
+
+- **Font**: Monospace for consistent alignment
+- **Colors**:
+  - Text: Light gray (#ddd) on dark background
+  - Background: Semi-transparent dark (#1a1a1a)
+  - Borders: Subtle gray (#333)
+- **Spacing**: Comfortable padding and line height
+- **Visual Feedback**: Hover effects on interactive elements
+
+## Use Cases
+
+### Prompt Engineering Workflows
+- Display AI-generated prompts with proper formatting
+- Compare positive and negative prompts side-by-side
+- Copy refined prompts without manual cleanup
+
+### Text Processing Pipelines
+- Debug text transformations at each step
+- View formatted outputs from text nodes
+- Monitor prompt construction workflows
+
+### Documentation and Notes
+- Display workflow instructions
+- Show generation parameters
+- Present formatted metadata
+
+## Technical Details
+
+- **Text Processing**: Preserves original text while adding display formatting
+- **Responsive Design**: CSS-based layout adapts to node dimensions
+- **Event Handling**: Proper event propagation for ComfyUI compatibility
+- **Memory Efficient**: Only renders visible text portions
+
+## Tips
+
+1. **For Long Prompts**: The scrolling feature handles texts of any length efficiently
+2. **Quick Copy**: Use the copy buttons to quickly grab prompts for other nodes
+3. **Resizing**: Drag node edges to find optimal display width for your content
+4. **Split View**: Works best with SDXL-format prompts but handles any dual-section text
+
+## Integration Example
+
+```
+[Gemini Prompt Engineer] → [Display Text] → [Copy Button Click]
+         ↓                        ↓                    ↓
+   SDXL Format            Split View Display    Clean Prompts
+```
+
+This creates a seamless workflow from prompt generation to usage, with the Display Text node providing the visual interface for review and interaction.

examples/documentation/empty_latent_batch.md

@@ -0,0 +1,222 @@
+# Empty Latent Batch Documentation
+
+## Overview
+
+The Empty Latent Batch is a ComfyUI node that creates empty latent tensors with batch support and preset integration. It combines the preset functionality of Width Height Selector with efficient batch processing capabilities, making it ideal for batch workflows and optimized generation pipelines.
+
+## Features
+
+### 🎯 **Preset Integration**
+- **26 Curated Presets**: Full access to SDXL, FLUX, and Ultra-wide presets
+- **Formatted Display**: Shows aspect ratio, megapixels, and model group
+- **Smart Fallback**: Automatic fallback to custom dimensions for invalid presets
+- **Model Optimization**: Preset categories optimized for different model types
+
+### 📦 **Batch Processing**
+- **Configurable Batch Size**: Create 1-64 empty latents in single operation
+- **Memory Efficient**: Uses torch.zeros for optimal memory allocation
+- **Batch Validation**: Prevents excessive memory usage with warnings
+- **ComfyUI Compatible**: Standard latent format for seamless integration
+
+### 🔄 **Visual Swap Button**
+- **Interactive UI**: Blue swap button with hover and click feedback
+- **Preset-Aware Swapping**: Intelligent switching between matching presets
+- **Custom Dimension Support**: Simple value swapping for custom inputs
+- **Visual Feedback**: Button state changes during interaction
+
+### ✅ **Smart Validation**
+- **Dimension Sanitization**: Automatic adjustment to divisible-by-8 constraint
+- **Memory Estimation**: Built-in memory usage calculation
+- **Error Handling**: Graceful handling of invalid inputs with helpful messages
+- **Logging**: Detailed operation logging for debugging
+
+## Node Interface
+
+### Inputs
+- **preset**: Dropdown with 26 formatted preset options + custom
+- **width**: Custom width (64-8192, step 8, default 1024)
+- **height**: Custom height (64-8192, step 8, default 1024)
+- **batch_size**: Number of latents to create (1-64, default 1)
+
+### Outputs
+- **latent**: Dictionary containing batch of empty latent tensors
+- **width**: Final sanitized width (guaranteed divisible by 8)
+- **height**: Final sanitized height (guaranteed divisible by 8)
+
+## Preset Reference
+
+The Empty Latent Batch node uses the same 26 curated presets as the Width Height Selector:
+
+### SDXL Presets (~1 Megapixel)
+Optimized for SDXL models with ~1MP resolution constraint.
+
+### FLUX Presets (High Resolution)
+Higher resolution presets optimized for FLUX models with better quality/speed balance.
+
+### Ultra-Wide Presets (Modern Ratios)
+Modern aspect ratios for ultra-wide and panoramic generation.
+
+*For complete preset details, see [Width Height Selector Documentation](width_height_selector.md#preset-reference)*
+
+## Usage Examples
+
+### Basic Empty Latent Creation
+1. **Select Preset**: Choose from dropdown (e.g., "1024×1024 - 1:1 (1.0MP) - SDXL")
+2. **Set Batch Size**: Enter desired number of latents (e.g., 4)
+3. **Connect Output**: Link latent output to KSampler or other processing nodes
+
+### Custom Batch Creation
+1. **Set Preset**: Select "custom"
+2. **Enter Dimensions**: Input width and height manually
+3. **Set Batch Size**: Configure number of latents needed
+4. **Validation**: Automatic sanitization ensures compatibility
+
+### Orientation Swapping
+1. **Choose Preset**: Any preset (e.g., "1920×1080")
+2. **Click Swap Button**: Blue button in bottom-right corner
+3. **Result**: Gets swapped preset if available, or custom dimensions with swapped values
+4. **Widget Update**: Width/height widgets automatically update
+
+### Memory-Aware Batch Processing
+1. **Large Batch**: Set batch_size to 16 or higher
+2. **Memory Warning**: Node provides memory usage estimation
+3. **Optimization**: Choose appropriate resolution preset for available VRAM
+
+## Common Workflows
+
+### Batch Generation Pipeline
+```
+Empty Latent Batch → KSampler → VAE Decode → Save Image
+(batch_size: 4)      ↓         ↓            ↓
+                   4 samples  4 images    4 files
+```
+- Create 4 empty latents at once
+- Process all through sampling
+- Generate 4 images in single operation
+- Efficient for parameter exploration
+
+### Model Comparison Workflow
+```
+Empty Latent Batch → [Multiple KSamplers] → [Multiple VAE Decoders] → Compare Results
+(batch_size: 8)      ↓                      ↓                        ↓
+                   Split batch            Process variants         Side-by-side
+```
+- Create consistent batch of empty latents
+- Split across different samplers/models
+- Compare results with identical starting conditions
+
+### Upscaling Preparation
+```
+Empty Latent Batch → KSampler → VAE Decode → Resolution Calculator → Upscaler
+(832×1216, batch:4)  ↓         ↓            ↓                     ↓
+                   Sample    Decode       Calculate 2x           Upscale batch
+```
+- Generate batch at base resolution
+- Calculate upscale dimensions
+- Process entire batch through upscaler
+
+### Aspect Ratio Exploration
+```
+Empty Latent Batch → [Clone to multiple orientations] → Parallel Processing
+(1920×1080)          ↓                                  ↓
+[Swap Button] →    Portrait & Landscape versions      Compare orientations
+```
+- Start with base preset
+- Use swap button to create orientation variants
+- Process both simultaneously
+
+## Advanced Features
+
+### Memory Estimation
+The node provides built-in memory estimation for batch operations:
+
+```python
+# Example memory calculations
+Batch Size: 4, Resolution: 1024×1024
+Latent Tensor: 4 × 4 × 128 × 128 = 262,144 elements
+Memory Usage: 262,144 × 4 bytes = 1.0 MB per batch
+```
+
+### Intelligent Preset Handling
+- **Formatted Display**: Shows full metadata in dropdown
+- **Original Extraction**: Extracts original preset name from formatted strings
+- **Validation**: Verifies preset exists before processing
+- **Fallback Logic**: Uses custom dimensions if preset is invalid
+
+### Batch Size Optimization
+- **Performance Warnings**: Alerts for large batch sizes
+- **Memory Limits**: Prevents excessive memory allocation
+- **Hardware Awareness**: Considers available system resources
+
+## Tips and Best Practices
+
+### Batch Size Selection
+- **Small Batches (1-4)**: Good for testing and development
+- **Medium Batches (5-16)**: Efficient for most production workflows
+- **Large Batches (17-64)**: Only for high-memory systems and specific use cases
+
+### Preset Selection
+- **SDXL Projects**: Use SDXL presets for memory efficiency
+- **FLUX Projects**: Use FLUX presets for optimal quality
+- **Ultra-wide Projects**: Ensure sufficient VRAM for large resolutions
+- **Custom Projects**: Use custom dimensions for specific requirements
+
+### Memory Management
+- Monitor memory usage with large batches
+- Use appropriate resolution presets for available VRAM
+- Consider splitting very large batches across multiple nodes
+- Clear GPU memory between large batch operations
+
+### Workflow Integration
+- Always connect all three outputs (latent, width, height)
+- Use width/height outputs for downstream dimension calculations
+- Combine with Resolution Calculator for upscaling workflows
+- Leverage batch processing for efficient parameter exploration
+
+## Troubleshooting
+
+### Common Issues
+- **Out of Memory**: Reduce batch_size or use lower resolution presets
+- **Invalid Dimensions**: Node automatically sanitizes to valid values
+- **Preset Not Found**: Falls back to custom dimensions with warning
+- **Swap Button Not Working**: Ensure node is not collapsed and button is visible
+
+### Performance Optimization
+- **Batch Size**: Start with smaller batches and increase as needed
+- **Resolution**: Use appropriate presets for your model and VRAM
+- **Memory Monitoring**: Watch for memory warnings and adjust accordingly
+- **Cleanup**: Clear unused tensors between large batch operations
+
+### Error Handling
+- **Dimension Validation**: Automatic rounding to nearest valid values
+- **Batch Size Limits**: Clamped to 1-64 range with warnings
+- **Memory Allocation**: Graceful handling of insufficient memory
+- **Preset Fallbacks**: Automatic fallback to custom dimensions
+
+## Technical Details
+
+### Latent Tensor Format
+- **Shape**: [batch_size, 4, height//8, width//8]
+- **Data Type**: torch.float32
+- **Initialization**: torch.zeros for clean empty state
+- **Memory Layout**: Contiguous tensor for optimal performance
+
+### Validation Pipeline
+1. **Preset Extraction**: Parse formatted preset strings
+2. **Dimension Calculation**: Get base dimensions from preset or custom
+3. **Sanitization**: Ensure divisible-by-8 constraint
+4. **Batch Validation**: Check batch size limits
+5. **Memory Estimation**: Calculate expected memory usage
+6. **Tensor Creation**: Allocate and initialize latent tensor
+
+### UI Integration
+- **JavaScript Extension**: Custom UI for swap button functionality
+- **Widget Synchronization**: Auto-update width/height when preset changes
+- **Visual Feedback**: Hover effects and click animations
+- **Event Handling**: Proper mouse event management
+
+### Swap Button Implementation
+- **Position Calculation**: Dynamic positioning based on node size
+- **State Management**: Visual feedback for button interactions
+- **Preset Intelligence**: Smart switching between compatible presets
+- **Fallback Logic**: Custom dimension swapping when preset not available

examples/documentation/flux_sampler_params.md

@@ -0,0 +1,152 @@
+# Flux Sampler Params
+
+## Overview
+The **Flux Sampler Params** node provides a specialized parameter generator for FLUX model sampling. This tool was adapted from the excellent [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials) project (now in maintenance mode) and enhanced for the ComfyAssets ecosystem.
+
+## Attribution
+This node is based on work from [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials) by cubiq. The original project is in maintenance-only mode, and we've adopted and enhanced these tools to ensure continued support and compatibility with modern ComfyUI workflows.
+
+## Features
+- **FLUX-Optimized Parameters**: Specifically tuned for FLUX model requirements
+- **Batch Processing Support**: Generate multiple parameter sets for comparative testing
+- **Interactive UI Elements**: Visual controls for quick parameter adjustments
+- **Smart Defaults**: Pre-configured optimal settings for FLUX workflows
+- **Comprehensive Parameter Control**: Fine-tune all aspects of FLUX sampling
+
+## Node Properties
+- **Category**: `ComfyAssets/🧰 xyz-helpers`
+- **Node Name**: `FluxSamplerParams`
+- **Function**: `get_value`
+
+## Inputs
+
+### Required
+| Parameter | Type | Default | Range | Description |
+|-----------|------|---------|-------|-------------|
+| `scheduler` | DROPDOWN | normal | [normal, simple, sgm_uniform] | Scheduler algorithm for sampling |
+| `steps` | INT | 20 | 1-100 | Number of sampling steps |
+| `guidance` | FLOAT | 3.5 | 0.0-100.0 | Guidance scale for conditioning |
+| `max_shift` | FLOAT | 1.0 | 0.0-100.0 | Maximum shift value for FLUX |
+| `base_shift` | FLOAT | 0.5 | 0.0-100.0 | Base shift value for FLUX |
+| `denoise` | FLOAT | 1.0 | 0.0-1.0 | Denoising strength |
+| `batch_mode` | DROPDOWN | single | [single, batch] | Single value or batch processing |
+
+### Optional
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `batch_count` | INT | 1 | Number of batch variations (1-100) |
+| `batch_seed_mode` | DROPDOWN | incremental | Seed generation mode for batches |
+| `variation_seed` | INT | None | Optional seed for variations |
+| `lora_params` | LORA_PARAMS | None | LoRA parameters from LoRAFolderBatch |
+
+## Outputs
+| Name | Type | Description |
+|------|------|-------------|
+| `sampler_params` | SAMPLER_PARAMS | Complete FLUX sampling parameters |
+| `scheduler` | STRING | Selected scheduler algorithm |
+| `steps` | INT | Number of sampling steps |
+| `guidance` | FLOAT | Guidance scale value |
+
+## Usage Examples
+
+### Basic FLUX Sampling
+```
+FluxSamplerParams → KSampler → VAE Decode → Save Image
+    scheduler: normal
+    steps: 20
+    guidance: 3.5
+```
+
+### Batch Parameter Testing
+```
+FluxSamplerParams → KSampler → Image Grid → Save
+    batch_mode: batch
+    batch_count: 5
+    guidance: 2.0...5.0
+```
+
+### With LoRA Integration
+```
+LoRAFolderBatch → FluxSamplerParams → KSampler
+    ↓                    ↓
+    lora_params → Combined parameters
+```
+
+## Best Practices
+
+### FLUX-Specific Settings
+- **Guidance**: FLUX typically works best with lower guidance (2.0-5.0)
+- **Steps**: 15-25 steps usually sufficient for FLUX
+- **Scheduler**: `normal` or `sgm_uniform` recommended for FLUX
+- **Shift Values**: Adjust for different quality/speed tradeoffs
+
+### Batch Testing Workflow
+1. Set `batch_mode` to `batch`
+2. Configure parameter ranges using `...` syntax
+3. Set appropriate `batch_count`
+4. Use with image grid nodes for comparison
+
+### Memory Optimization
+- Start with smaller batch counts for testing
+- Monitor VRAM usage with high batch counts
+- Use incremental seed mode for reproducibility
+
+## Integration with Other Nodes
+
+### Works Well With
+- **LoRA Folder Batch**: Combine multiple LoRAs with FLUX parameters
+- **Plot Parameters**: Visualize parameter effects
+- **Sampler Select Helper**: Dynamic sampler selection
+- **Text Encode Sampler Params**: Add text conditioning
+
+### Common Workflows
+1. **Parameter Sweep**: Test multiple guidance/step combinations
+2. **LoRA Testing**: Evaluate different LoRA strengths with FLUX
+3. **Quality Comparison**: Compare different shift values
+4. **Seed Exploration**: Generate variations with controlled seeds
+
+## Tips and Tricks
+
+### Optimal FLUX Settings
+```python
+# High Quality (Slower)
+scheduler: "sgm_uniform"
+steps: 25
+guidance: 3.5
+max_shift: 1.0
+base_shift: 0.5
+
+# Fast Preview
+scheduler: "simple"
+steps: 12
+guidance: 2.5
+max_shift: 0.8
+base_shift: 0.4
+```
+
+### Batch Parameter Ranges
+- Steps: `15...25+5` (test 15, 20, 25)
+- Guidance: `2.0...5.0+0.5` (test 2.0, 2.5, 3.0, 3.5, 4.0, 4.5, 5.0)
+- Denoise: `0.8...1.0+0.1` (test 0.8, 0.9, 1.0)
+
+## Troubleshooting
+
+### Common Issues
+1. **Out of Memory**: Reduce batch_count or image resolution
+2. **Poor Quality**: Increase steps or adjust guidance
+3. **Artifacts**: Check shift values aren't too high
+4. **Slow Generation**: Use `simple` scheduler for previews
+
+### Parameter Guidelines
+- Don't set guidance too high (>10) for FLUX
+- Keep denoise at 1.0 for initial generation
+- Adjust shift values gradually for best results
+
+## Version History
+- **1.0.0**: Initial adaptation from comfyui-essentials-nodes
+- **1.0.1**: Added batch processing support
+- **1.0.2**: Enhanced FLUX-specific optimizations
+- **1.0.3**: Improved UI elements and parameter validation
+
+## Credits
+Original implementation by cubiq in [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials). Adapted and maintained by the ComfyAssets team.

examples/documentation/gemini_prompt.md

@@ -0,0 +1,220 @@
+# Gemini Prompt Engineer (Deprecated)
+
+**Legacy documentation for existing workflows.** This node is soft-deprecated
+and hidden from normal new-node discovery through ComfyUI's deprecated-node
+metadata. Users who enable deprecated-node visibility may still find it.
+
+The `GeminiPrompt` registration, display name, input/output schema and execution
+remain available for saved workflows. Existing configuration and model-refresh
+behavior remain in place. Google API/model compatibility updates and UI migration
+have ended; the historical model and setup details below may no longer match
+Google's current service. No replacement or automatic workflow conversion is
+provided.
+
+The Gemini Prompt Engineer node uses Google's Gemini AI to analyze images and generate optimized prompts for various AI image generation models.
+
+## Features
+
+- **Multi-Model Support**: Generate prompts optimized for FLUX, SDXL, Danbooru, and Video generation
+- **Custom Prompts**: Override templates with your own system prompts
+- **Visual Feedback**: UI shows processing status and error states
+- **Flexible API Key Management**: Multiple ways to provide API credentials
+- **Dynamic Model Selection**: Fetch and use latest Gemini models with refresh button
+- **Model Caching**: Persistent storage of available models for offline access
+- **Help Integration**: Built-in setup guide accessible via help button
+
+## Setup
+
+### 1. Get API Key
+
+Get your free Gemini API key from [Google AI Studio](https://makersuite.google.com/app/apikey)
+
+### 2. Install Dependencies
+
+```bash
+pip install google-genai
+```
+
+### 3. Configure API Key
+
+Choose one of these methods:
+
+1. **Environment Variable** (Recommended):
+   ```bash
+   export GEMINI_API_KEY="your-api-key-here"
+   ```
+
+2. **Config File**:
+   Create `gemini_config.json` in your ComfyUI root directory:
+   ```json
+   {
+     "api_key": "your-api-key-here"
+   }
+   ```
+
+3. **Node Input**:
+   Enter the API key directly in the node's `api_key` field
+
+## Inputs
+
+- **image** (IMAGE): The image to analyze
+- **prompt_type** (DROPDOWN): Type of prompt to generate
+  - `flux`: Detailed artistic prompts with quality markers
+  - `sdxl`: Positive/negative prompt pairs with weight emphasis
+  - `danbooru`: Anime-style booru tags with underscores
+  - `video`: Motion and temporal descriptions for video generation
+- **model** (DROPDOWN): Gemini model selection
+  - Dynamically populated list of available models
+  - Includes latest models like gemini-2.0-flash-exp
+  - Click refresh button to update model list
+- **api_key** (STRING, optional): Gemini API key if not set elsewhere
+- **custom_prompt** (STRING, optional): Override template with custom system prompt
+
+## Outputs
+
+- **prompt** (STRING): Generated prompt text
+- **negative_prompt** (STRING): Negative prompt (only populated for SDXL format)
+
+## Prompt Type Details
+
+### FLUX Format
+Generates detailed prompts optimized for FLUX models:
+- Starts with main subject and action
+- Includes style and medium descriptors
+- Adds lighting and atmosphere details
+- Uses quality markers like "4K", "highly detailed", "award-winning"
+
+Example output:
+```
+majestic mountain landscape at golden hour, oil painting style, dramatic lighting with sun rays piercing through clouds, wide angle composition, warm color palette with orange and purple hues, highly detailed, 4K resolution, trending on ArtStation, photorealistic rendering
+```
+
+### SDXL Format
+Generates positive and negative prompt pairs with enhanced structure:
+- Layered positive prompts: main subject → style → composition → technical
+- Comprehensive negative prompts to avoid common issues
+- Uses parentheses for emphasis: `(detailed eyes:1.2)`
+- Includes quality boosters and technical specifications
+
+Example output:
+```
+Positive prompt:
+beautiful woman with flowing red hair, elegant pose, (detailed eyes:1.2), serene expression
+oil painting style, renaissance art influence, classical portraiture
+golden hour lighting, warm color palette, soft shadows, dramatic chiaroscuro
+centered composition, rule of thirds, shallow depth of field, bokeh background
+masterpiece, best quality, highly detailed, 8k uhd, professional artwork
+
+Negative prompt:
+low quality, worst quality, blurry, out of focus, pixelated, low resolution
+bad anatomy, deformed features, extra limbs, missing limbs, disconnected limbs
+poorly drawn face, poorly drawn hands, amateur drawing, bad proportions
+oversaturated, overexposed, underexposed, bad lighting, harsh shadows
+jpeg artifacts, watermark, signature, text, cropped, duplicate
+```
+
+### Danbooru Format
+Generates booru-style tags for anime artwork:
+- Uses underscores for multi-word concepts
+- Includes character count descriptors (1girl, 2boys)
+- Orders tags from most to least important
+
+Example output:
+```
+1girl, solo, long_hair, blue_eyes, blonde_hair, school_uniform, serafuku, pleated_skirt, thighhighs, smile, looking_at_viewer, classroom, sitting, desk, window, sunlight, highres, masterpiece
+```
+
+### Video Format
+Generates prompts for video generation models:
+- Describes motion and camera movements
+- Includes temporal markers and transitions
+- Specifies technical details like fps and duration
+
+Example output:
+```
+Aerial shot slowly descending toward a misty forest at dawn, camera smoothly transitions to tracking shot following a deer through the trees, photorealistic style, soft golden hour lighting with fog, 10 second duration, 4K resolution 24fps, ending with close-up of deer looking at camera
+```
+
+## Custom System Prompts
+
+You can override any template by providing your own system prompt. This is useful for:
+- Specialized use cases
+- Different language outputs
+- Custom formatting requirements
+- Integration with specific workflows
+
+Example custom prompt:
+```
+You are an expert at analyzing images and creating simple, concise descriptions.
+Focus only on the main subject and primary colors.
+Keep your response under 50 words.
+```
+
+## Error Handling
+
+The node provides clear error messages for common issues:
+- Missing API key
+- API request failures
+- Invalid image inputs
+- Rate limiting
+
+Errors are displayed in the prompt output for easy debugging.
+
+## Model Selection
+
+### Dynamic Model List
+- Click the refresh button (🔄) next to the model dropdown to fetch latest models
+- Models are fetched from Google's API and include all available versions
+- Common models include:
+  - `gemini-2.0-flash-exp`: Latest experimental flash model
+  - `gemini-1.5-pro`: Advanced model with larger context
+  - `gemini-1.5-flash`: Fast and efficient for most tasks
+
+### Model Caching
+- Available models are cached locally for offline access
+- Cache persists across ComfyUI sessions
+- Refresh button updates the cache with latest models
+
+## UI Features
+
+### Help Button
+- Click the help button (?) for quick setup instructions
+- Shows API key setup methods
+- Links to Google AI Studio for key generation
+
+### Status Indicators
+- Processing spinner during API calls
+- Error messages displayed in red
+- Success feedback when prompt is generated
+
+## Tips
+
+1. **API Usage**: Gemini has generous free tier limits, but be mindful of rate limits
+2. **Image Quality**: Higher resolution images provide better analysis results
+3. **Prompt Refinement**: You can chain multiple Gemini nodes with different custom prompts
+4. **Caching**: Results are not cached, so identical images will make new API calls
+5. **Model Selection**: Use flash models for faster responses, pro models for complex analysis
+
+## Example Workflow
+
+1. Load an image using Load Image node
+2. Connect to Gemini Prompt Engineer
+3. Select appropriate prompt_type for your target model
+4. Connect prompt output to your generation model
+5. For SDXL, connect both prompt and negative_prompt outputs
+
+## Troubleshooting
+
+**"API key not found" error**:
+- Check environment variable is set correctly
+- Verify config file path and JSON format
+- Try entering key directly in node
+
+**"No response generated" error**:
+- Check internet connection
+- Verify API key is valid
+- Image might be too large (resize if needed)
+
+**Import error for google-genai**:
+- Run `pip install google-genai` in your ComfyUI environment
+- Restart ComfyUI after installation

examples/documentation/image_to_multiple_of.md

@@ -0,0 +1,82 @@
+# Image to Multiple Of
+
+## Overview
+
+The **Image to Multiple Of** node adjusts image dimensions to be multiples of a specified value. This is particularly useful for models that require input dimensions to be multiples of certain values (e.g., 8, 16, 32, 64) for optimal performance or compatibility.
+
+## Purpose
+
+Many AI models, especially diffusion models and VAEs, require input dimensions to be multiples of specific values due to their architecture (e.g., downsampling layers). This node ensures your images meet these requirements without manual calculation.
+
+## Inputs
+
+- **image** (IMAGE, required): The input image to process
+- **multiple_of** (INT, required): The value that dimensions should be multiple of
+  - Default: 64
+  - Range: 1-256
+  - Step: 16
+- **method** (COMBO, required): Processing method
+  - Options: "center crop", "rescale"
+
+## Outputs
+
+- **image** (IMAGE): Processed image with dimensions adjusted to multiples of the specified value
+
+## Processing Methods
+
+### Center Crop
+- Crops the image from the center to achieve the target dimensions
+- Preserves image quality but may lose edge content
+- Best for images where the important content is centered
+
+### Rescale
+- Resizes the image to the target dimensions using bilinear interpolation
+- Keeps all content but may slightly affect image quality
+- Best when you need to preserve all image content
+
+## Usage Examples
+
+### Example 1: Prepare for VAE Encoding
+```
+Load Image → Image to Multiple Of (multiple_of: 64) → VAE Encode
+```
+
+### Example 2: Prepare for Specific Model Requirements
+```
+Load Image → Image to Multiple Of (multiple_of: 32) → Model Processing
+```
+
+### Example 3: Batch Processing
+```
+Load Images → Image to Multiple Of (multiple_of: 16, method: rescale) → Batch Process
+```
+
+## Technical Details
+
+- Supports batch processing (processes all images in a batch)
+- Works with any number of channels (RGB, RGBA, grayscale, etc.)
+- Calculates the largest dimensions that are less than or equal to the original size
+- For center crop: crops equally from all sides to maintain centering
+- For rescale: uses bilinear interpolation with align_corners=False
+
+## Common Use Cases
+
+1. **VAE Preprocessing**: Ensure images are compatible with VAE encoders that require dimensions divisible by 64
+2. **Model Compatibility**: Adjust images for models with specific architectural requirements
+3. **Batch Uniformity**: Ensure all images in a batch have dimensions that meet model requirements
+4. **Performance Optimization**: Some models perform better with dimensions that are powers of 2
+
+## Tips
+
+- Use **center crop** when your subject is centered and you don't mind losing edge details
+- Use **rescale** when you need to preserve all image content
+- Common multiple_of values: 8, 16, 32, 64, 128
+- For Stable Diffusion models, 64 is typically recommended
+- For some upscaling models, 32 or 16 may be sufficient
+
+## Error Handling
+
+The node will raise an error if:
+- The image dimensions are smaller than the specified multiple_of value
+- Invalid input types are provided
+- The resulting dimensions would be 0 or negative

examples/documentation/kiko_film_grain.md

@@ -0,0 +1,125 @@
+# Kiko Film Grain
+
+## Overview
+The **Kiko Film Grain** node applies realistic film grain effects to images, simulating the aesthetic of analog film photography. It provides comprehensive controls for grain size, intensity, color saturation, and shadow lifting to achieve various film looks.
+
+## Node Details
+- **Category**: ComfyAssets/image
+- **Node Name**: KikoFilmGrain
+- **Display Name**: Kiko Film Grain
+
+## Inputs
+
+### Required
+- **image** (`IMAGE`)
+  - The input image to apply film grain to
+  - Supports batch processing
+  - Preserves alpha channel if present
+
+### Parameters
+- **scale** (`FLOAT`)
+  - Controls the size of the grain pattern
+  - Range: 0.25 to 2.0
+  - Default: 0.5
+  - Lower values = finer grain, higher values = coarser grain
+
+- **strength** (`FLOAT`)
+  - Intensity of the grain effect
+  - Range: 0.0 to 10.0
+  - Default: 0.5
+  - 0.0 = no grain, higher values = more pronounced grain
+
+- **saturation** (`FLOAT`)
+  - Color saturation of the grain
+  - Range: 0.0 to 2.0
+  - Default: 0.7
+  - 0.0 = monochrome grain, 1.0 = full color, >1.0 = oversaturated
+
+- **toe** (`FLOAT`)
+  - Lifts blacks/shadows for a film-like look
+  - Range: -0.2 to 0.5
+  - Default: 0.0
+  - Positive values lift shadows, negative values crush blacks
+
+- **seed** (`INT`)
+  - Random seed for grain pattern generation
+  - Range: 0 to maximum integer
+  - Default: 0
+  - Use for reproducible grain patterns
+
+## Outputs
+- **image** (`IMAGE`)
+  - The processed image with film grain applied
+  - Same dimensions and batch size as input
+  - Alpha channel preserved if present
+
+## Usage Examples
+
+### Subtle Film Look
+```
+Scale: 0.5
+Strength: 0.3
+Saturation: 0.8
+Toe: 0.05
+```
+Creates a subtle, fine-grained film aesthetic suitable for portraits.
+
+### Vintage Film
+```
+Scale: 1.0
+Strength: 0.8
+Saturation: 0.5
+Toe: 0.15
+```
+Simulates vintage film with moderate grain and lifted shadows.
+
+### High ISO Film
+```
+Scale: 0.75
+Strength: 1.5
+Saturation: 0.6
+Toe: 0.1
+```
+Emulates high ISO film stock with pronounced grain.
+
+### Black & White Film
+```
+Scale: 0.6
+Strength: 0.6
+Saturation: 0.0
+Toe: 0.08
+```
+Creates monochrome grain perfect for black and white photography.
+
+## Technical Details
+
+### Improvements Over Standard Implementations
+1. **Pure PyTorch Operations**: No OpenCV dependencies, better GPU utilization
+2. **ITU-R BT.709 Color Space**: Accurate color conversion for grain application
+3. **Screen Blend Mode**: Preserves highlights better than multiply blending
+4. **Channel-Specific Weighting**: Film grain is stronger in blue channel (3x), moderate in red (2x), matching real film characteristics
+5. **Efficient Memory Management**: Minimizes tensor copies and conversions
+
+### Algorithm Overview
+1. Generate random noise at specified scale
+2. Convert to YCbCr color space for realistic grain distribution
+3. Apply different blur kernels to each channel:
+   - Y (luminance): 3x3 kernel for fine detail
+   - Cb (blue-yellow): 15x15 kernel for color noise
+   - Cr (red-green): 11x11 kernel for color noise
+4. Convert back to RGB and apply strength/saturation
+5. Use screen blend mode to combine with original image
+6. Apply toe adjustment for film-like shadow response
+
+## Tips
+- Start with low strength values (0.2-0.5) and adjust upward
+- For color images, saturation between 0.5-0.8 looks most natural
+- Combine with color grading nodes for complete film emulation
+- Use consistent seed values across batch for uniform grain
+- Scale parameter affects both grain size and render performance (smaller scale = more computation)
+
+## Compatibility
+- Works with any image format supported by ComfyUI
+- Preserves image properties (alpha channel, batch size)
+- Compatible with both RGB and RGBA images
+- Efficient batch processing support

examples/documentation/kiko_save_image.md

@@ -0,0 +1,213 @@
+# Kiko Save Image
+
+Enhanced image saving node with multiple format support, quality controls, and an interactive floating popup viewer for ComfyUI.
+
+## Features
+
+- **Multiple Format Support**: Save as PNG, JPEG, or WebP with format-specific optimizations
+- **Advanced Quality Controls**: Fine-tune compression settings per format
+- **Floating Popup Viewer**: Interactive window showing saved images immediately
+- **Batch Operations**: Multi-select images for bulk actions
+- **File Size Display**: Real-time feedback on compression effectiveness
+- **Smart UI**: Auto-hide, draggable, resizable popup window
+
+## Inputs
+
+- **images** (IMAGE): Batch of images to save
+- **filename_prefix** (STRING): Prefix for saved filenames
+  - Default: "KikoSave"
+  - Supports subfolder paths (e.g., "outputs/renders/final")
+- **format** (DROPDOWN): Output format selection
+  - `PNG`: Lossless compression, best quality
+  - `JPEG`: Lossy compression, smaller files
+  - `WEBP`: Modern format, best compression ratio
+- **quality** (INT): JPEG/WebP quality level
+  - Range: 1-100 (default: 90)
+  - Higher values = better quality, larger files
+- **png_compress_level** (INT): PNG compression level
+  - Range: 0-9 (default: 4)
+  - Higher values = smaller files, slower saving
+- **webp_lossless** (BOOLEAN): Use lossless WebP compression
+  - Default: False (lossy)
+  - True: Lossless compression like PNG
+- **popup** (BOOLEAN): Enable popup viewer window
+  - Default: True
+  - Toggle per save operation
+
+## Outputs
+
+- **UI**: Enhanced preview data with interactive popup viewer
+
+## Popup Viewer Features
+
+### Window Controls
+- **Drag Handle**: Click and drag the header to move window
+- **Minimize Button**: Collapse to title bar only
+- **Maximize Button**: Expand to larger viewing size
+- **Roll-up Button**: Show/hide content area
+- **Close Button**: Hide the popup (can reopen with toggle)
+
+### Image Grid
+- **Thumbnails**: Click any image to open full-size in new tab
+- **File Info**: Shows filename and size for each image
+- **Quality Indicators**:
+  - PNG: Compression level (0-9)
+  - JPEG/WebP: Quality percentage
+- **Batch Selection**: Checkboxes for multi-select operations
+
+### Bulk Actions
+- **Open All Selected**: Opens selected images in new tabs
+- **Download All Selected**: Downloads selected images as a batch
+- **Individual Downloads**: Download button per image
+
+### Smart Behavior
+- **Auto-positioning**: Appears in convenient screen location
+- **Persistence**: Stays open across multiple saves
+- **Auto-hide**: Can be minimized when not needed
+- **Responsive**: Adapts to different image counts
+
+## Format Details
+
+### PNG Format
+- **Pros**: Lossless quality, transparency support, wide compatibility
+- **Cons**: Larger file sizes
+- **Best for**: Final outputs, images with transparency, archival
+- **Compression**: 0 (none) to 9 (maximum)
+  - Level 4 (default) balances size and speed
+  - Level 9 for maximum compression (slow)
+
+### JPEG Format
+- **Pros**: Smaller files, fast loading, universal support
+- **Cons**: Lossy compression, no transparency
+- **Best for**: Web images, previews, photos
+- **Quality**: 1-100%
+  - 90% (default) excellent quality with good compression
+  - 95%+ for near-lossless quality
+  - 70-85% for web optimization
+
+### WebP Format
+- **Pros**: Best compression ratios, supports transparency, modern
+- **Cons**: Limited software support
+- **Best for**: Web deployment, storage optimization
+- **Modes**:
+  - Lossy (default): Excellent compression with quality control
+  - Lossless: PNG-like quality with better compression
+
+## Usage Examples
+
+### High-Quality Archive
+```
+Format: PNG
+Compression: 0-2
+Use Case: Final renders for portfolio or client delivery
+```
+
+### Web Optimization
+```
+Format: JPEG or WebP
+Quality: 80-85
+Use Case: Website images, social media posts
+```
+
+### Balanced Storage
+```
+Format: WebP
+Quality: 90
+Lossless: False
+Use Case: Large batches with storage constraints
+```
+
+### Transparency Preservation
+```
+Format: PNG or WebP (lossless)
+Use Case: Logos, UI elements, cutout images
+```
+
+## Workflow Integration
+
+### Basic Save
+```
+Generate → Kiko Save Image
+           format: PNG
+           popup: enabled
+```
+
+### Format Comparison
+```
+Generate → Kiko Save Image (PNG)    → Compare file sizes
+        ↘ Kiko Save Image (JPEG)   ↗
+        ↘ Kiko Save Image (WebP)   ↗
+```
+
+### Batch Processing
+```
+Batch Generate → Kiko Save Image → Popup Viewer
+                 ↓                  ↓
+                4 images        Select best results
+```
+
+## Tips and Best Practices
+
+1. **Format Selection**:
+   - Use PNG for maximum quality and transparency
+   - Use JPEG for photographs without transparency
+   - Use WebP for modern web deployment
+
+2. **Quality Settings**:
+   - Start with defaults (90 for JPEG/WebP, 4 for PNG)
+   - Adjust based on file size requirements
+   - Preview results in popup before finalizing
+
+3. **Popup Management**:
+   - Drag to second monitor for larger workspace
+   - Use roll-up to save screen space
+   - Disable popup for automated workflows
+
+4. **Batch Operations**:
+   - Use checkboxes to select multiple images
+   - Open all in tabs for side-by-side comparison
+   - Download all for quick collection
+
+5. **File Organization**:
+   - Use subfolders in filename_prefix
+   - Include descriptive prefixes
+   - Let ComfyUI handle timestamp suffixes
+
+## Advantages Over Standard Save Image
+
+- **Immediate Preview**: No need to navigate file system
+- **Format Flexibility**: Choose optimal format per use case
+- **Quality Control**: Fine-tune compression settings
+- **Batch Management**: Handle multiple images efficiently
+- **Modern UI**: Floating interface doesn't interrupt workflow
+- **File Size Awareness**: See compression effectiveness immediately
+- **Quick Access**: One-click opening and downloading
+
+## Technical Details
+
+- **Image Processing**: Uses Pillow for format conversion
+- **Metadata**: Preserves ComfyUI metadata in saved files
+- **File Naming**: Automatic timestamp and counter suffixes
+- **Memory Efficiency**: Processes images individually
+- **Thread Safety**: Proper handling of concurrent saves
+
+## Troubleshooting
+
+**Popup not appearing**:
+- Check that popup input is enabled
+- Look for minimized window
+- Try toggling the popup button in node
+
+**WebP not working**:
+- Ensure Pillow has WebP support
+- Update Pillow: `pip install --upgrade pillow`
+
+**Large file sizes**:
+- Increase compression (PNG) or reduce quality (JPEG/WebP)
+- Consider switching formats
+- Check image dimensions
+
+**Can't see all images**:
+- Scroll within the popup grid
+- Maximize the popup window
+- Images are shown newest first

examples/documentation/local_image_loader.md

@@ -0,0 +1,158 @@
+# Local Image Loader
+
+## Overview
+
+The Local Image Loader node provides a visual gallery interface for browsing and selecting images, videos, and audio files from your local filesystem directly within ComfyUI. This streamlined version focuses on essential functionality without the complexity of tagging or metadata management.
+
+## Features
+
+- **Visual Gallery Browser**: Browse local directories with thumbnail previews
+- **Multi-Media Support**: Load images, videos, and audio files
+- **Directory Navigation**: Navigate through folders with ease
+- **Sorting Options**: Sort by name, date, or file size
+- **Saved Paths**: Save frequently used directory paths for quick access
+- **Pagination**: Handle large directories with paginated display
+- **Lightbox Preview**: Full-size preview with zoom and pan capabilities
+
+## Node Inputs
+
+### Required Inputs
+None - The node uses a visual interface for file selection
+
+### Hidden Inputs
+- `unique_id`: Automatically assigned node identifier
+
+## Node Outputs
+
+| Output | Type | Description |
+|--------|------|-------------|
+| `image` | IMAGE | The selected image as a tensor |
+| `video_path` | STRING | Path to the selected video file |
+| `audio_path` | STRING | Path to the selected audio file |
+| `info` | STRING | JSON metadata about the selected image |
+
+## Usage
+
+### Basic Workflow
+
+1. **Add the Node**: Search for "Local Image Loader" in the node menu
+2. **Browse Directory**: Enter a directory path or use saved paths
+3. **Select Media**: Click on thumbnails to select files
+4. **Connect Outputs**: Use the outputs in your workflow
+
+### Interface Controls
+
+#### Path Management
+- **Directory Input**: Enter or paste a directory path
+- **Saved Paths Dropdown**: Quick access to saved directories
+- **Save Path Button** (💾): Save current directory to favorites
+- **Browse Button** (📁): Load the entered directory
+
+#### View Options
+- **Videos Checkbox**: Show/hide video files
+- **Audio Checkbox**: Show/hide audio files
+- **Sort By**: Choose between Name, Date, or Size
+- **Sort Order**: Ascending (↑) or Descending (↓)
+- **Refresh Button** (🔄): Reload current directory
+
+#### Gallery Display
+- **Thumbnail Grid**: Visual preview of files
+- **Blue Border**: Selected items are highlighted
+- **Folder Icons**: Navigate into subdirectories
+- **Video Overlay**: Visual indicator for video files
+- **Pagination**: Navigate through pages of results
+
+## File Support
+
+### Supported Image Formats
+- `.jpg`, `.jpeg`
+- `.png`
+- `.bmp`
+- `.gif`
+- `.webp`
+
+### Supported Video Formats
+- `.mp4`
+- `.webm`
+- `.mov`
+- `.mkv`
+- `.avi`
+
+### Supported Audio Formats
+- `.mp3`
+- `.wav`
+- `.ogg`
+- `.flac`
+
+## Image Metadata
+
+When an image is selected, the node extracts and returns metadata including:
+- **Basic Info**: Filename, width, height, format, mode
+- **Embedded Parameters**: Generation parameters if present
+- **Workflow Data**: Embedded ComfyUI workflow if present
+- **Prompt Data**: Embedded prompt information if present
+
+## Examples
+
+### Loading an Image for Processing
+```
+Local Image Loader → Load Image → Image Processing Node
+                 ↓
+              [info] → Display Text (to show metadata)
+```
+
+### Setting Up a Multi-Media Workflow
+```
+Local Image Loader → [image] → Image Preview
+                 ↓
+           [video_path] → Video Player Node
+                 ↓
+           [audio_path] → Audio Player Node
+```
+
+## Tips and Best Practices
+
+1. **Save Frequently Used Paths**: Use the save button to bookmark directories you use often
+2. **Use Sorting**: Sort by date to find recent files quickly
+3. **Keyboard Navigation**: Press Enter in the path field to load a directory
+4. **Performance**: For directories with thousands of files, use pagination to navigate efficiently
+5. **Thumbnail Generation**: Thumbnails are generated on-demand and cached for performance
+
+## Differences from Original
+
+This version simplifies the original ComfyUI_Local_Image_Gallery by removing:
+- Tag filtering and management
+- Rating system
+- Global tag search
+- Metadata editing capabilities
+
+These features were removed to focus on the core functionality of browsing and selecting files, making the tool simpler and more straightforward to use.
+
+## Troubleshooting
+
+### Common Issues
+
+**Directory Not Loading**
+- Verify the path exists and you have read permissions
+- Check for special characters in the path
+- Try using absolute paths instead of relative ones
+
+**Thumbnails Not Showing**
+- Ensure the files are in supported formats
+- Check if the images are corrupted
+- Try refreshing the gallery
+
+**Large Directories Slow to Load**
+- Use sorting and pagination to manage large folders
+- Consider organizing files into subdirectories
+- Enable only the media types you need (images, videos, audio)
+
+## Technical Details
+
+The node creates a visual widget that runs in the ComfyUI interface and communicates with the backend through API endpoints to:
+- List directory contents
+- Generate thumbnails
+- Save user preferences
+- Handle file selection
+
+All file operations are performed server-side for security, with proper path validation to prevent directory traversal attacks.

examples/documentation/lora_folder_batch.md

@@ -0,0 +1,264 @@
+# LoRA Folder Batch
+
+## Overview
+The **LoRA Folder Batch** node automates the process of testing multiple LoRA models from a folder. This tool was adapted from [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials) (now in maintenance mode) and enhanced with batch processing capabilities for efficient LoRA evaluation workflows.
+
+## Attribution
+This node is based on work from [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials) by cubiq. The original project is in maintenance-only mode, and we've adopted and enhanced these tools to ensure continued support and compatibility with modern ComfyUI workflows.
+
+## Features
+- **Automatic Folder Scanning**: Discovers all .safetensors files in specified folders
+- **Natural Sorting**: Intelligently sorts epochs (e.g., epoch_004, epoch_020, epoch_100)
+- **Pattern Filtering**: Include/exclude LoRAs using regex patterns
+- **Flexible Strength Control**: Single, multiple, or range-based strength values
+- **Batch Modes**: Sequential or combinatorial strength application
+- **Epoch Detection**: Automatically extracts epoch numbers from filenames
+- **Auto-Batching**: Automatically splits large LoRA collections into manageable chunks to prevent UI disconnection
+
+## Node Properties
+- **Category**: `ComfyAssets/🧰 xyz-helpers`
+- **Node Name**: `LoRAFolderBatch`
+- **Function**: `batch_loras`
+
+## Inputs
+
+### Required
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `folder_path` | STRING | "." | Folder path relative to models/loras (or absolute) |
+| `strength` | STRING | "1.0" | Strength values (see formats below) |
+| `batch_mode` | DROPDOWN | sequential | [sequential, combinatorial] processing mode |
+
+### Optional
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `include_pattern` | STRING | "" | Regex pattern to include files |
+| `exclude_pattern` | STRING | "" | Regex pattern to exclude files |
+| `max_loras` | INT | 50 | Maximum LoRAs to process (when auto_batch disabled) |
+| `sort_order` | DROPDOWN | natural | Sorting method [natural, alphabetical, newest, oldest] |
+| `auto_batch` | DROPDOWN | disabled | Enable auto-batching for large collections [disabled, enabled] |
+| `batch_size` | INT | 25 | Number of LoRAs per batch when auto-batching |
+| `batch_index` | INT | 0 | Which batch to output (0-based) when auto-batching |
+
+### Strength Format Options
+- **Single**: `"1.0"` - Apply same strength to all LoRAs
+- **Multiple**: `"0.5, 0.75, 1.0"` - Comma-separated values
+- **Range**: `"0.5...1.0+0.25"` - Start...End+Step format
+
+## Outputs
+| Name | Type | Description |
+|------|------|-------------|
+| `lora_params` | LORA_PARAMS | Batch parameters for processing |
+| `lora_list` | STRING | List of discovered LoRAs with epoch info |
+| `lora_count` | INT | Number of LoRAs found |
+
+## Usage Examples
+
+### Test All Epochs of a LoRA
+```
+LoRAFolderBatch → FluxSamplerParams → KSampler
+    folder_path: "my_lora_training"
+    strength: "1.0"
+    batch_mode: sequential
+```
+
+### Strength Testing for Each LoRA
+```
+LoRAFolderBatch → KSampler → Image Grid
+    folder_path: "test_loras"
+    strength: "0.5, 0.75, 1.0"
+    batch_mode: combinatorial
+```
+
+### Filter Specific Epochs
+```
+LoRAFolderBatch → Processing Pipeline
+    folder_path: "training_results"
+    include_pattern: "epoch_0[2-5]0"
+    strength: "0.8...1.2+0.1"
+```
+
+### Auto-Batch Large Collections
+```
+LoRAFolderBatch → FluxSamplerParams → KSampler
+    folder_path: "massive_lora_collection"  # 100+ files
+    strength: "1.0"
+    auto_batch: enabled
+    batch_size: 25
+    batch_index: 0  # Change to 1, 2, 3... for subsequent batches
+```
+
+## Batch Modes Explained
+
+### Sequential Mode
+Each LoRA gets one strength value in order:
+- LoRA1 → strength[0]
+- LoRA2 → strength[1]
+- LoRA3 → strength[0] (cycles if fewer strengths than LoRAs)
+
+### Combinatorial Mode
+Each LoRA is tested with ALL strength values:
+- LoRA1 → [0.5, 0.75, 1.0]
+- LoRA2 → [0.5, 0.75, 1.0]
+- LoRA3 → [0.5, 0.75, 1.0]
+
+## Auto-Batching for Large Collections
+
+### Overview
+When testing large numbers of LoRAs (e.g., 75+ files), ComfyUI can experience UI disconnections or memory issues. Auto-batching solves this by automatically splitting your LoRA collection into smaller, manageable chunks.
+
+### How It Works
+1. **Enable Auto-Batching**: Set `auto_batch` to "enabled"
+2. **Set Batch Size**: Configure `batch_size` (default: 25, range: 5-100)
+3. **Select Batch**: Use `batch_index` to choose which batch to process
+
+### Example: Testing 75 LoRAs
+With 75 LoRAs and batch_size=25, the system creates 3 batches:
+- **Batch 0**: LoRAs 1-25 (set batch_index=0)
+- **Batch 1**: LoRAs 26-50 (set batch_index=1)
+- **Batch 2**: LoRAs 51-75 (set batch_index=2)
+
+Run your workflow 3 times, changing only the `batch_index` each time.
+
+### Visual Feedback
+When auto-batching is enabled, the `lora_list` output includes batch information:
+```
+=== Batch 1/3 (LoRAs 1-25) ===
+
+style-epoch-001
+style-epoch-002
+...
+```
+
+### Best Practices for Auto-Batching
+1. **Start with Default**: Use batch_size=25 for most scenarios
+2. **Adjust for Memory**: Decrease batch_size if you still experience issues
+3. **Combinatorial Mode**: Be extra careful - 25 LoRAs × 3 strengths = 75 combinations
+4. **Save Between Batches**: Save your results after each batch to avoid data loss
+5. **Use Plot Parameters**: The batch info appears in plot visualizations for easy tracking
+
+## File Naming Patterns
+
+### Supported Epoch Formats
+- `model-v1-000004.safetensors` → Epoch 4
+- `style_epoch_020.safetensors` → Epoch 20
+- `lora-000100.safetensors` → Epoch 100
+
+### Natural Sorting Examples
+Files are sorted intelligently:
+1. `model-000004.safetensors`
+2. `model-000020.safetensors`
+3. `model-000100.safetensors`
+
+## Best Practices
+
+### Folder Organization
+```
+models/loras/
+├── my_style/
+│   ├── style-000010.safetensors
+│   ├── style-000020.safetensors
+│   └── style-000030.safetensors
+└── character/
+    ├── char-v2-000005.safetensors
+    └── char-v2-000010.safetensors
+```
+
+### Testing Workflows
+1. **Initial Testing**: Use single strength (1.0) to evaluate all epochs
+2. **Fine-tuning**: Use combinatorial mode with multiple strengths
+3. **Final Selection**: Filter to specific epochs and test strength range
+
+### Pattern Filtering Examples
+```python
+# Include only specific versions
+include_pattern: "v2|v3"
+
+# Exclude test/backup files
+exclude_pattern: "test|backup|old"
+
+# Include specific epoch range
+include_pattern: "epoch_0[3-7]0"
+```
+
+## Integration with Other Nodes
+
+### Common Pipelines
+1. **LoRA Comparison Grid**:
+   ```
+   LoRAFolderBatch → KSampler → Image Grid → Save
+   ```
+
+2. **Strength Testing**:
+   ```
+   LoRAFolderBatch → PlotParameters → Graph Display
+   ```
+
+3. **Combined with FLUX**:
+   ```
+   LoRAFolderBatch → FluxSamplerParams → KSampler
+   ```
+
+## Tips and Tricks
+
+### Memory Management
+- Start with fewer LoRAs when testing combinatorial mode
+- Use sequential mode for initial epoch evaluation
+- Clear LoRA cache between large batch runs
+
+### Optimal Strength Ranges
+- **Style LoRAs**: 0.5-1.0
+- **Character LoRAs**: 0.7-1.2
+- **Detail LoRAs**: 0.3-0.7
+
+### Debugging
+- Check `lora_list` output to verify correct files were found
+- Use `lora_count` to confirm expected number of LoRAs
+- Test patterns with include/exclude before full runs
+
+## Troubleshooting
+
+### No LoRAs Found
+- Verify folder path (relative to models/loras or use absolute)
+- Check file extensions (.safetensors)
+- Test without filters first
+
+### Pattern Not Working
+- Patterns use Python regex syntax
+- Test patterns in regex tester first
+- Case-sensitive by default
+
+### Memory Issues
+- Reduce batch_count in combinatorial mode
+- Process LoRAs in smaller groups
+- Use sequential mode for large sets
+
+## Advanced Examples
+
+### Multi-Version Testing
+```python
+# Test different versions at different strengths
+folder_path: "character_loras"
+include_pattern: "v[1-3]"
+strength: "0.6, 0.8, 1.0"
+batch_mode: combinatorial
+```
+
+### Epoch Progression Analysis
+```python
+# Test every 10th epoch
+folder_path: "training_output"
+include_pattern: "0[0-9]0\\.safetensors$"
+strength: "1.0"
+batch_mode: sequential
+```
+
+## Version History
+- **1.0.0**: Initial adaptation from comfyui-essentials-nodes
+- **1.0.1**: Added natural sorting for epochs
+- **1.0.2**: Enhanced pattern filtering
+- **1.0.3**: Improved batch modes and strength parsing
+- **1.0.4**: Added auto-batching for large LoRA collections
+
+## Credits
+Original implementation by cubiq in [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials). Adapted and maintained by the ComfyAssets team.

examples/documentation/plot_parameters.md

@@ -0,0 +1,234 @@
+# Plot Parameters
+
+## Overview
+The **Plot Parameters** node creates visual graphs and plots from sampler parameters, enabling data-driven analysis of generation settings. Adapted from [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials) (now in maintenance mode), this tool helps visualize the relationship between parameters and output quality.
+
+## Attribution
+This node is based on work from [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials) by cubiq. The original project is in maintenance-only mode, and we've adopted and enhanced these tools to ensure continued support and compatibility with modern ComfyUI workflows.
+
+## Features
+- **Multi-Parameter Plotting**: Visualize multiple parameters simultaneously
+- **Comparison Graphs**: Compare settings across batch runs
+- **Statistical Analysis**: Calculate means, deviations, and trends
+- **Export Capabilities**: Save plots as images or data files
+- **Real-time Updates**: Dynamic graph generation during workflow execution
+
+## Node Properties
+- **Category**: `ComfyAssets/🧰 xyz-helpers`
+- **Node Name**: `PlotParameters`
+- **Function**: `plot`
+
+## Inputs
+
+### Required
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `sampler_params` | SAMPLER_PARAMS | - | Parameters to plot |
+| `plot_type` | DROPDOWN | line | [line, bar, scatter, heatmap] |
+| `x_axis` | DROPDOWN | steps | Parameter for X axis |
+| `y_axis` | DROPDOWN | quality | Metric for Y axis |
+
+### Optional
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `title` | STRING | "Parameter Analysis" | Graph title |
+| `show_grid` | BOOLEAN | True | Display grid lines |
+| `show_legend` | BOOLEAN | True | Display legend |
+| `color_scheme` | DROPDOWN | default | Color palette selection |
+
+## Outputs
+| Name | Type | Description |
+|------|------|-------------|
+| `plot_image` | IMAGE | Generated plot as image |
+| `data_csv` | STRING | Plot data in CSV format |
+| `statistics` | STRING | Statistical summary |
+
+## Usage Examples
+
+### Basic Parameter Visualization
+```
+FluxSamplerParams → PlotParameters → Display Image
+    plot_type: line
+    x_axis: steps
+    y_axis: guidance
+```
+
+### Batch Comparison Plot
+```
+LoRAFolderBatch → PlotParameters → Save Image
+    plot_type: scatter
+    x_axis: lora_strength
+    y_axis: quality_score
+```
+
+### Heatmap Analysis
+```
+Parameter Grid → PlotParameters → Analysis Display
+    plot_type: heatmap
+    x_axis: cfg
+    y_axis: steps
+```
+
+## Plot Types Explained
+
+### Line Plot
+- Best for continuous parameter changes
+- Shows trends and relationships
+- Ideal for time series or progression
+
+### Bar Chart
+- Compares discrete values
+- Good for categorical comparisons
+- Shows distribution clearly
+
+### Scatter Plot
+- Reveals correlations
+- Identifies outliers
+- Best for large datasets
+
+### Heatmap
+- Two-dimensional parameter analysis
+- Color-coded intensity values
+- Perfect for grid searches
+
+## Best Practices
+
+### Parameter Selection
+- Choose related parameters for meaningful plots
+- Use consistent scales for comparison
+- Consider parameter ranges when plotting
+
+### Visual Clarity
+- Limit number of series to 5-7 for readability
+- Use contrasting colors for multiple lines
+- Enable grid for precise value reading
+
+### Data Analysis
+```python
+# Effective parameter combinations
+x_axis: "guidance"
+y_axis: "perceived_quality"
+
+# Step efficiency analysis
+x_axis: "steps"
+y_axis: "generation_time"
+
+# LoRA impact assessment
+x_axis: "lora_strength"
+y_axis: "style_adherence"
+```
+
+## Integration Examples
+
+### Complete Analysis Pipeline
+```
+1. Generate with parameters
+2. Plot results
+3. Export data
+4. Statistical analysis
+```
+
+### Multi-Plot Workflow
+```
+Params → Plot1 (steps vs quality)
+      ↘ Plot2 (guidance vs coherence)
+      ↘ Plot3 (strength vs style)
+      → Combined Analysis
+```
+
+## Advanced Features
+
+### Custom Metrics
+- Define custom Y-axis metrics
+- Import external quality scores
+- Calculate derived values
+
+### Export Options
+- PNG/SVG image formats
+- CSV data export
+- JSON statistics export
+
+### Styling Options
+```python
+# Professional presentation
+color_scheme: "scientific"
+show_grid: True
+show_legend: True
+
+# Minimal style
+color_scheme: "minimal"
+show_grid: False
+show_legend: False
+```
+
+## Statistical Analysis
+
+### Available Metrics
+- Mean, Median, Mode
+- Standard Deviation
+- Correlation Coefficients
+- Trend Lines
+- R-squared Values
+
+### Interpretation Guide
+- **Positive Correlation**: Parameters increase together
+- **Negative Correlation**: Inverse relationship
+- **No Correlation**: Independent parameters
+
+## Tips and Tricks
+
+### Optimal Visualization
+1. Start with scatter plots for exploration
+2. Use line plots for trends
+3. Apply heatmaps for 2D parameter spaces
+4. Bar charts for final comparisons
+
+### Data Preparation
+- Normalize scales when comparing different metrics
+- Remove outliers for cleaner plots
+- Group similar parameters
+
+### Performance Tips
+- Cache plot images for repeated viewing
+- Export data for external analysis
+- Use lower resolution for preview plots
+
+## Troubleshooting
+
+### Empty Plots
+- Verify sampler_params contains data
+- Check axis parameter selection
+- Ensure valid parameter ranges
+
+### Scaling Issues
+- Use logarithmic scale for wide ranges
+- Normalize data if needed
+- Adjust plot dimensions
+
+### Export Problems
+- Check file permissions
+- Verify export path exists
+- Ensure sufficient disk space
+
+## Use Cases
+
+### Hyperparameter Optimization
+Track and visualize the effect of different sampling parameters on output quality.
+
+### LoRA Strength Analysis
+Plot the relationship between LoRA strength and style transfer effectiveness.
+
+### Efficiency Studies
+Analyze generation time vs quality trade-offs across different settings.
+
+### Batch Comparison
+Compare multiple generation runs to identify optimal parameters.
+
+## Version History
+- **1.0.0**: Initial adaptation from comfyui-essentials-nodes
+- **1.0.1**: Added heatmap visualization
+- **1.0.2**: Enhanced statistical analysis
+- **1.0.3**: Improved export capabilities
+
+## Credits
+Original implementation by cubiq in [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials). Adapted and maintained by the ComfyAssets team.

examples/documentation/resolution_calculator.md

@@ -98,4 +98,4 @@ The Resolution Calculator integrates seamlessly with:
 - Standard ComfyUI image loaders
 - VAE encode/decode operations
 - Upscaler nodes (ESRGAN, Real-ESRGAN, etc.)
-- Custom latent processing workflows
+- Custom latent processing workflows

examples/documentation/sampler_combo.md

@@ -0,0 +1,208 @@
+# Sampler Combo Documentation
+
+## Overview
+
+The Sampler Combo is a unified ComfyUI node that combines sampler, scheduler, steps, and CFG settings into a single interface. It reduces workflow complexity while ensuring compatible parameter combinations and providing optimization recommendations.
+
+## Features
+
+### 🎯 **Unified Configuration**
+- Single node for all sampling parameters
+- Compatible sampler + scheduler combinations
+- Optimized steps and CFG recommendations
+- Reduced workflow complexity
+
+### 🧠 **Smart Recommendations**
+- Scheduler suggestions based on selected sampler
+- Optimal steps range for each sampler
+- CFG scale recommendations
+- Compatibility warnings and suggestions
+
+### ✅ **Built-in Validation**
+- Parameter validation and sanitization
+- Error handling with safe defaults
+- Performance optimization hints
+- Real-time compatibility checking
+
+### 📊 **Analysis Tools**
+- Combo configuration analysis
+- Performance assessment
+- Optimization recommendations
+- Compatibility scoring
+
+## Node Interface
+
+### Inputs
+- **sampler_name**: Dropdown with available sampling algorithms
+- **scheduler**: Dropdown with compatible schedulers
+- **steps**: Integer slider (1-100 steps)
+- **cfg**: Float slider (0.0-20.0 CFG scale)
+
+### Outputs
+- **sampler_name**: Selected sampler algorithm
+- **scheduler**: Selected scheduler algorithm
+- **steps**: Number of sampling steps
+- **cfg**: CFG scale value
+
+## Available Samplers
+
+### Primary Samplers
+| Sampler | Type | Speed | Quality | Best For |
+|---------|------|-------|---------|----------|
+| euler | Deterministic | Fast | Good | General use |
+| euler_ancestral | Stochastic | Fast | Good | Creative variation |
+| heun | Higher-order | Medium | Better | Quality focus |
+| dpm_2 | Multi-step | Medium | Good | Balanced |
+| dpm_2_ancestral | Stochastic | Medium | Good | Creative quality |
+| lms | Linear | Fast | Good | Simple scenes |
+| dpm_fast | Optimized | Very Fast | Good | Speed priority |
+| dpm_adaptive | Adaptive | Variable | Best | Automatic tuning |
+
+### Advanced Samplers
+| Sampler | Type | Speed | Quality | Best For |
+|---------|------|-------|---------|----------|
+| dpmpp_2s_ancestral | Advanced | Medium | Better | High quality |
+| dpmpp_2m | Optimized | Fast | Better | Speed + quality |
+| dpmpp_2m_sde | Stochastic | Medium | Best | Maximum quality |
+| dpmpp_3m_sde | Latest | Medium | Best | Cutting edge |
+| ddim | Classic | Fast | Good | Compatibility |
+| uni_pc | Unified | Fast | Better | Efficiency |
+
+## Available Schedulers
+
+### Linear Schedulers
+- **normal**: Standard linear schedule
+- **linear**: Basic linear distribution
+- **sgm_uniform**: Uniform distribution
+
+### Advanced Schedulers
+- **karras**: Karras noise schedule (recommended)
+- **exponential**: Exponential decay
+- **polyexponential**: Polynomial exponential
+- **beta**: Beta distribution schedule
+
+### Specialized Schedulers
+- **cosine**: Cosine annealing schedule
+- **simple**: Simplified schedule
+- **ddim_uniform**: DDIM uniform schedule
+- **laplace**: Laplace distribution
+
+## Optimization Guidelines
+
+### Recommended Combinations
+
+#### Speed Optimized
+```
+Sampler: euler or dpm_fast
+Scheduler: normal or simple
+Steps: 15-25
+CFG: 6.0-8.0
+```
+
+#### Quality Optimized
+```
+Sampler: dpmpp_2m_sde or dpmpp_3m_sde
+Scheduler: karras
+Steps: 25-35
+CFG: 7.0-9.0
+```
+
+#### Balanced
+```
+Sampler: dpmpp_2m or heun
+Scheduler: karras or normal
+Steps: 20-30
+CFG: 7.0-8.5
+```
+
+### Steps Recommendations
+
+| Sampler Type | Min Steps | Optimal | Max Steps |
+|--------------|-----------|---------|-----------|
+| Fast (euler, dpm_fast) | 10 | 20 | 30 |
+| Standard (heun, dpm_2) | 15 | 25 | 40 |
+| Advanced (dpmpp_*) | 20 | 30 | 50 |
+| Adaptive | 10 | 25 | 100 |
+
+### CFG Scale Guidelines
+
+| Content Type | CFG Range | Recommended |
+|--------------|-----------|-------------|
+| Photorealistic | 5.0-8.0 | 7.0 |
+| Artistic/Stylized | 7.0-12.0 | 9.0 |
+| Abstract/Creative | 8.0-15.0 | 11.0 |
+| Text/Details | 10.0-20.0 | 13.0 |
+
+## Usage Examples
+
+### Basic Configuration
+```
+sampler_name: euler
+scheduler: normal
+steps: 20
+cfg: 7.0
+```
+
+### High Quality Setup
+```
+sampler_name: dpmpp_2m_sde
+scheduler: karras
+steps: 30
+cfg: 8.0
+```
+
+### Speed Priority
+```
+sampler_name: dpm_fast
+scheduler: simple
+steps: 15
+cfg: 6.5
+```
+
+## Advanced Features
+
+### Compatibility Analysis
+The node provides real-time analysis of parameter compatibility:
+- Scheduler compatibility with selected sampler
+- Steps optimization for sampler type
+- CFG scale recommendations
+- Performance impact assessment
+
+### Error Handling
+- Invalid samplers default to 'euler'
+- Invalid schedulers default to 'normal'
+- Out-of-range steps clamped to valid range
+- Invalid CFG values sanitized to safe defaults
+
+### Performance Tips
+1. **Use Karras scheduler** for most samplers (better quality)
+2. **Start with 20-30 steps** for most use cases
+3. **Keep CFG 6.0-9.0** for realistic images
+4. **Try dpmpp_2m** for best speed/quality balance
+5. **Use euler** for fastest generation
+
+## Troubleshooting
+
+### Common Issues
+- **Slow generation**: Try euler or dpm_fast samplers
+- **Poor quality**: Increase steps or try dpmpp_2m_sde
+- **Overcooked images**: Lower CFG scale
+- **Underdetailed**: Increase CFG or steps
+- **Artifacts**: Try karras scheduler or different sampler
+
+### Performance Optimization
+- **GPU Memory**: Lower steps if running out of VRAM
+- **Speed**: Use euler + normal + 15-20 steps
+- **Quality**: Use dpmpp_2m_sde + karras + 25-30 steps
+- **Compatibility**: Stick to euler/heun for broad model support
+
+## Integration
+
+The Sampler Combo node outputs are compatible with all standard ComfyUI sampling nodes:
+- KSampler
+- KSamplerAdvanced
+- Custom sampling workflows
+- Upscaling pipelines
+- Img2img workflows
+
+Connect the outputs directly to your sampling node inputs for streamlined configuration.

examples/documentation/sampler_select_helper.md

@@ -0,0 +1,260 @@
+# Sampler Select Helper
+
+## Overview
+The **Sampler Select Helper** node provides intelligent sampler selection with model-specific recommendations and compatibility checking. Adapted from [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials) (now in maintenance mode), this tool ensures optimal sampler-scheduler combinations for different model architectures.
+
+## Attribution
+This node is based on work from [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials) by cubiq. The original project is in maintenance-only mode, and we've adopted and enhanced these tools to ensure continued support and compatibility with modern ComfyUI workflows.
+
+## Features
+- **Model-Aware Selection**: Automatic recommendations based on model type
+- **Compatibility Validation**: Ensures sampler-scheduler pairs work well together
+- **Performance Profiles**: Pre-configured settings for quality vs speed
+- **Dynamic Updates**: Adapts to newly available samplers
+- **Batch Support**: Test multiple samplers in sequence
+
+## Node Properties
+- **Category**: `ComfyAssets/🧰 xyz-helpers`
+- **Node Name**: `SamplerSelectHelper`
+- **Function**: `select_sampler`
+
+## Inputs
+
+### Required
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `model_type` | DROPDOWN | auto | [auto, sdxl, sd15, flux, custom] |
+| `quality_preset` | DROPDOWN | balanced | [fast, balanced, quality, extreme] |
+| `sampler_override` | DROPDOWN | auto | Specific sampler selection |
+
+### Optional
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `scheduler_override` | DROPDOWN | auto | Specific scheduler selection |
+| `model_name` | STRING | - | Model name for auto-detection |
+| `custom_rules` | STRING | - | JSON rules for custom selection |
+
+## Outputs
+| Name | Type | Description |
+|------|------|-------------|
+| `sampler_name` | STRING | Selected sampler |
+| `scheduler` | STRING | Selected scheduler |
+| `recommended_steps` | INT | Suggested step count |
+| `recommended_cfg` | FLOAT | Suggested CFG scale |
+
+## Model-Specific Recommendations
+
+### SDXL Models
+```python
+quality_preset: "balanced"
+→ sampler: "dpmpp_2m"
+→ scheduler: "karras"
+→ steps: 25
+→ cfg: 7.0
+```
+
+### SD 1.5 Models
+```python
+quality_preset: "quality"
+→ sampler: "dpmpp_2m_sde"
+→ scheduler: "exponential"
+→ steps: 30
+→ cfg: 7.5
+```
+
+### FLUX Models
+```python
+quality_preset: "fast"
+→ sampler: "euler"
+→ scheduler: "simple"
+→ steps: 15
+→ cfg: 3.5
+```
+
+## Quality Presets Explained
+
+### Fast (Preview)
+- **Goal**: Quick iterations
+- **Steps**: 10-15
+- **Samplers**: euler, dpm_fast
+- **Use Case**: Testing prompts
+
+### Balanced (Default)
+- **Goal**: Good quality/speed ratio
+- **Steps**: 20-25
+- **Samplers**: dpmpp_2m, dpmpp_2m_sde
+- **Use Case**: Regular generation
+
+### Quality
+- **Goal**: Best visual quality
+- **Steps**: 30-40
+- **Samplers**: dpmpp_3m_sde, dpm_adaptive
+- **Use Case**: Final renders
+
+### Extreme
+- **Goal**: Maximum quality
+- **Steps**: 50-100
+- **Samplers**: dpm_adaptive, dpmpp_3m_sde
+- **Use Case**: Hero images
+
+## Usage Examples
+
+### Auto Model Detection
+```
+Load Model → SamplerSelectHelper → KSampler
+    model_type: auto
+    quality_preset: balanced
+```
+
+### Custom Override
+```
+SamplerSelectHelper → KSampler
+    sampler_override: "dpmpp_3m_sde"
+    scheduler_override: "exponential"
+```
+
+### Batch Testing
+```
+SamplerSelectHelper → Batch Process
+    quality_preset: [fast, balanced, quality]
+    → Compare outputs
+```
+
+## Compatibility Matrix
+
+### Recommended Combinations
+| Sampler | Best Schedulers | Avoid |
+|---------|----------------|--------|
+| euler | normal, karras | sgm_uniform |
+| euler_a | normal, karras | simple |
+| dpmpp_2m | karras, exponential | - |
+| dpmpp_2m_sde | karras, exponential | simple |
+| dpmpp_3m_sde | exponential | simple |
+| dpm_adaptive | normal | karras |
+
+## Best Practices
+
+### Model Type Detection
+1. Use `auto` for automatic detection
+2. Override only when necessary
+3. Provide model_name for better accuracy
+
+### Performance Optimization
+```python
+# Quick preview workflow
+quality_preset: "fast"
+→ 10 steps, euler sampler
+
+# Final production
+quality_preset: "quality"
+→ 35 steps, dpmpp_3m_sde
+
+# Experimental/artistic
+quality_preset: "extreme"
+→ 75 steps, dpm_adaptive
+```
+
+### Custom Rules Format
+```json
+{
+  "model_pattern": "anime.*",
+  "sampler": "dpmpp_2m_sde",
+  "scheduler": "karras",
+  "steps": 28,
+  "cfg": 7.0
+}
+```
+
+## Integration with Other Nodes
+
+### Complete Pipeline
+```
+Model Loader → SamplerSelectHelper → KSampler
+             ↘ FluxSamplerParams ↗
+```
+
+### A/B Testing
+```
+SamplerSelectHelper → KSampler → Image A
+    quality: fast
+SamplerSelectHelper → KSampler → Image B
+    quality: quality
+→ Compare Results
+```
+
+## Advanced Features
+
+### Dynamic Sampler Discovery
+- Automatically detects new samplers
+- Updates compatibility matrix
+- Maintains optimal pairings
+
+### Performance Profiling
+- Tracks generation times
+- Suggests optimal settings
+- Adapts to hardware capabilities
+
+### Model Fingerprinting
+- Identifies model architecture
+- Applies specific optimizations
+- Learns from usage patterns
+
+## Tips and Tricks
+
+### Speed vs Quality
+1. Start with "fast" for prompt testing
+2. Move to "balanced" for iteration
+3. Use "quality" for final output
+4. Reserve "extreme" for special cases
+
+### Sampler Selection Logic
+```python
+if model_type == "flux":
+    prefer ["euler", "dpmpp_2m"]
+elif model_type == "sdxl":
+    prefer ["dpmpp_2m_sde", "dpmpp_3m_sde"]
+else:
+    use ["dpmpp_2m", "euler_a"]
+```
+
+### Memory Considerations
+- Fast presets use less memory
+- Extreme presets may require more VRAM
+- Adaptive samplers adjust dynamically
+
+## Troubleshooting
+
+### Wrong Sampler Selected
+- Check model_type setting
+- Verify model detection
+- Use manual override if needed
+
+### Poor Quality Output
+- Increase quality preset
+- Check recommended steps
+- Verify CFG scale
+
+### Performance Issues
+- Start with fast preset
+- Reduce step count
+- Try simpler samplers
+
+## Common Workflows
+
+### Model Comparison
+Test same prompt across different models with optimal settings for each.
+
+### Quality Ladder
+Progress from fast to extreme quality to find optimal balance.
+
+### Sampler Shootout
+Compare all compatible samplers for specific model/prompt combination.
+
+## Version History
+- **1.0.0**: Initial adaptation from comfyui-essentials-nodes
+- **1.0.1**: Added FLUX model support
+- **1.0.2**: Enhanced compatibility matrix
+- **1.0.3**: Improved auto-detection
+
+## Credits
+Original implementation by cubiq in [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials). Adapted and maintained by the ComfyAssets team.

examples/documentation/scheduler_select_helper.md

@@ -0,0 +1,300 @@
+# Scheduler Select Helper
+
+## Overview
+The **Scheduler Select Helper** node provides intelligent scheduler selection with sampler-aware recommendations and model-specific optimizations. Adapted from [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials) (now in maintenance mode), this tool ensures optimal scheduler selection for different sampling algorithms and models.
+
+## Attribution
+This node is based on work from [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials) by cubiq. The original project is in maintenance-only mode, and we've adopted and enhanced these tools to ensure continued support and compatibility with modern ComfyUI workflows.
+
+## Features
+- **Sampler-Aware Selection**: Recommends best schedulers for each sampler
+- **Model Optimization**: Specific scheduler tuning for different models
+- **Noise Schedule Profiles**: Pre-configured curves for various use cases
+- **Visual Feedback**: Preview noise schedules
+- **Batch Testing**: Compare multiple schedulers
+
+## Node Properties
+- **Category**: `ComfyAssets/🧰 xyz-helpers`
+- **Node Name**: `SchedulerSelectHelper`
+- **Function**: `select_scheduler`
+
+## Inputs
+
+### Required
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `sampler_name` | STRING | - | Current sampler being used |
+| `model_type` | DROPDOWN | auto | [auto, sdxl, sd15, flux] |
+| `schedule_type` | DROPDOWN | smooth | [smooth, sharp, linear, custom] |
+
+### Optional
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `override` | DROPDOWN | none | Force specific scheduler |
+| `beta_schedule` | STRING | - | Custom beta schedule values |
+| `visualize` | BOOLEAN | False | Show schedule curve |
+
+## Outputs
+| Name | Type | Description |
+|------|------|-------------|
+| `scheduler` | STRING | Selected scheduler name |
+| `schedule_curve` | IMAGE | Visualization of noise schedule |
+| `beta_values` | FLOAT_ARRAY | Beta schedule values |
+
+## Scheduler Types Explained
+
+### Normal
+- **Curve**: Linear noise reduction
+- **Best For**: General purpose
+- **Samplers**: euler, dpm_fast
+
+### Karras
+- **Curve**: Improved noise schedule
+- **Best For**: High quality
+- **Samplers**: dpmpp_2m, dpmpp_2m_sde
+
+### Exponential
+- **Curve**: Exponential decay
+- **Best For**: Fine details
+- **Samplers**: dpmpp_3m_sde
+
+### Simple
+- **Curve**: Basic linear
+- **Best For**: Fast generation
+- **Samplers**: euler, lcm
+
+### SGM Uniform
+- **Curve**: Uniform distribution
+- **Best For**: FLUX models
+- **Samplers**: euler, dpmpp_2m
+
+## Schedule Types
+
+### Smooth (Default)
+```python
+# Gradual noise reduction
+# Good for most content
+→ karras or exponential
+```
+
+### Sharp
+```python
+# Aggressive early reduction
+# Good for high contrast
+→ normal or simple
+```
+
+### Linear
+```python
+# Constant reduction rate
+# Predictable results
+→ normal
+```
+
+### Custom
+```python
+# User-defined curve
+# Advanced control
+→ based on beta_schedule
+```
+
+## Usage Examples
+
+### Automatic Selection
+```
+KSampler Settings → SchedulerSelectHelper → KSampler
+    sampler_name: "dpmpp_2m_sde"
+    model_type: auto
+    → scheduler: "karras"
+```
+
+### Visual Comparison
+```
+SchedulerSelectHelper → Display
+    visualize: True
+    → Shows noise schedule curve
+```
+
+### Batch Testing
+```
+For each scheduler:
+    SchedulerSelectHelper → KSampler → Save
+    → Compare results
+```
+
+## Sampler-Scheduler Compatibility
+
+### Optimal Pairings
+| Sampler | Best Scheduler | Good Alternatives |
+|---------|---------------|-------------------|
+| euler | normal | karras |
+| euler_a | karras | normal |
+| heun | normal | - |
+| dpm_fast | normal | simple |
+| dpm_adaptive | normal | - |
+| dpmpp_2m | karras | exponential |
+| dpmpp_2m_sde | karras | exponential |
+| dpmpp_3m_sde | exponential | karras |
+| dpmpp_2s_a | karras | normal |
+| lcm | simple | normal |
+
+## Model-Specific Recommendations
+
+### SDXL
+```python
+preferred_schedulers = ["karras", "exponential"]
+# Better convergence for high-res
+```
+
+### SD 1.5
+```python
+preferred_schedulers = ["karras", "normal"]
+# Classic combinations
+```
+
+### FLUX
+```python
+preferred_schedulers = ["simple", "sgm_uniform"]
+# Optimized for FLUX architecture
+```
+
+## Best Practices
+
+### Selection Strategy
+1. Let auto-detection handle defaults
+2. Override for specific artistic goals
+3. Test multiple schedulers for hero images
+4. Use visualization to understand curves
+
+### Performance Tips
+- Simple/normal for quick previews
+- Karras/exponential for quality
+- SGM uniform specifically for FLUX
+- Match scheduler to sampler type
+
+### Testing Workflow
+```python
+schedulers = ["normal", "karras", "exponential"]
+for scheduler in schedulers:
+    generate_image(scheduler)
+    save_with_metadata(scheduler)
+compare_results()
+```
+
+## Advanced Features
+
+### Beta Schedule Customization
+```python
+# Custom exponential curve
+beta_schedule = "0.00085, 0.0012, 0.0018, ..."
+
+# Sharp early reduction
+beta_schedule = "0.001, 0.002, 0.004, 0.006, ..."
+```
+
+### Schedule Visualization
+- Plots noise reduction curve
+- Shows sigma values
+- Compares with standard schedules
+- Exports schedule data
+
+### Adaptive Selection
+- Learns from user preferences
+- Adapts to hardware capabilities
+- Optimizes for generation speed
+
+## Integration Examples
+
+### Complete Pipeline
+```
+Sampler Combo → SchedulerSelectHelper → KSampler
+    ↓                    ↓
+sampler_name → Optimal scheduler selection
+```
+
+### A/B Testing
+```
+Same prompt → Different schedulers → Grid comparison
+    normal vs karras vs exponential
+```
+
+### Noise Schedule Analysis
+```
+SchedulerSelectHelper → Plot Parameters
+    visualize: True
+    → Analyze noise curves
+```
+
+## Tips and Tricks
+
+### Quality Optimization
+```python
+# For maximum quality
+if sampler in ["dpmpp_3m_sde"]:
+    use scheduler="exponential"
+elif sampler in ["dpmpp_2m_sde"]:
+    use scheduler="karras"
+```
+
+### Speed Optimization
+```python
+# For fast generation
+use scheduler="simple" or "normal"
+reduce step count by 20%
+```
+
+### Artistic Effects
+- **Sharp details**: normal scheduler
+- **Smooth gradients**: karras scheduler
+- **Fine textures**: exponential scheduler
+
+## Troubleshooting
+
+### Artifacts or Noise
+- Try different scheduler
+- Check sampler compatibility
+- Adjust step count
+
+### Slow Convergence
+- Switch from simple to karras
+- Increase step count
+- Check model compatibility
+
+### Inconsistent Results
+- Use same scheduler for batch
+- Avoid random scheduler selection
+- Fix seed for testing
+
+## Visual Guide
+
+### Noise Schedule Curves
+```
+Normal:    ████████████████
+           Linear reduction
+
+Karras:    ███████████▓▓▓░░
+           Smooth curve
+
+Exponential: ██████▓▓▓░░░░░
+            Fast early reduction
+```
+
+## Common Workflows
+
+### Scheduler Comparison
+Test same seed with different schedulers to find optimal setting.
+
+### Model Migration
+When switching models, automatically adjust scheduler for best results.
+
+### Quality Ladder
+Progress through schedulers from fast to quality for different use cases.
+
+## Version History
+- **1.0.0**: Initial adaptation from comfyui-essentials-nodes
+- **1.0.1**: Added visualization features
+- **1.0.2**: Enhanced model detection
+- **1.0.3**: Improved compatibility matrix
+
+## Credits
+Original implementation by cubiq in [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials). Adapted and maintained by the ComfyAssets team.

examples/documentation/seed_history.md

@@ -0,0 +1,167 @@
+# Seed History Tool
+
+The Seed History tool provides advanced seed value tracking with an interactive UI for managing seed history, automatic deduplication, and convenient seed retrieval.
+
+## Overview
+
+The Seed History node functions as both a standard seed input and an intelligent tracking system that automatically monitors seed changes and maintains a searchable history.
+
+## Features
+
+### 🎲 Core Functionality
+- **Seed Output**: Standard ComfyUI seed value output (0 to 18,446,744,073,709,551,615)
+- **History Tracking**: Automatic tracking of all seed changes with timestamps
+- **Deduplication**: Intelligent filtering to prevent duplicate entries within 500ms windows
+- **Persistent Storage**: History persists across ComfyUI sessions using localStorage
+
+### 🎯 Interactive UI
+- **History Display**: Scrollable list showing recent seeds with timestamps
+- **Click to Load**: Click any history entry to instantly load that seed
+- **Generate Button**: Create new random seeds with one click
+- **Clear History**: Remove all tracked seeds when needed
+- **Auto-Hide**: History section automatically hides after 2.5 seconds of inactivity
+
+### ⚡ Smart Features
+- **Real-time Updates**: Tracks seed changes from increment/decrement buttons
+- **Visual Feedback**: Selected seeds are highlighted in green
+- **Time Formatting**: Human-readable "time ago" display (e.g., "5m ago", "2h ago")
+- **Notifications**: Toast messages for actions like generate and clear
+- **Responsive Design**: Adapts to node resizing
+
+## Usage
+
+### Basic Setup
+
+1. **Add Node**: Search for "Seed History" in the ComfyUI node browser
+2. **Connect Output**: Connect the seed output to any node requiring a seed input
+3. **Automatic Tracking**: The node automatically begins tracking seed changes
+
+### Seed Management
+
+```
+🎲 Seed History
+┌─────────────────┐
+│ 🎲 Generate │ 🗑️ Clear │
+├─────────────────┤
+│ 🎲 1,234,567    │ ← Click to load
+│ ⏰ 2m ago       │
+├─────────────────┤
+│ 🎲 9,876,543    │
+│ ⏰ 5m ago       │
+├─────────────────┤
+│ 🎲 5,555,555    │
+│ ⏰ 10m ago      │
+└─────────────────┘
+```
+
+### Workflow Integration
+
+The Seed History node works seamlessly with any ComfyUI workflow:
+
+```
+[Seed History] → [KSampler] → [Image Output]
+     ↓
+[VAE Decode] → [Save Image]
+```
+
+## Advanced Features
+
+### History Management
+- **Maximum Entries**: Keeps the 10 most recent seeds
+- **Smart Deduplication**: Prevents rapid duplicate additions
+- **Timestamp Tracking**: Full date/time information for each seed
+- **Persistent Storage**: History survives ComfyUI restarts
+
+### UI Behavior
+- **Auto-Hide Timer**: History hides after 2.5 seconds of inactivity
+- **Mouse Interaction**: Hovering over history cancels auto-hide
+- **Restore Button**: Click to restore hidden history section
+- **Visual Feedback**: Hover effects and selection highlighting
+
+### Seed Validation
+- **Range Checking**: Ensures seeds are within valid ComfyUI range
+- **Error Handling**: Graceful fallback to default seed (12345) on errors
+- **Sanitization**: Automatic clamping of out-of-range values
+
+## Technical Details
+
+### Input Parameters
+- **seed** (INT): Seed value for generation processes
+  - Range: 0 to 18,446,744,073,709,551,615
+  - Default: 12345
+  - Tooltip: "Seed value for generation processes. History UI tracks all changes automatically."
+
+### Output
+- **seed** (INT): The processed seed value for use in other nodes
+
+### Storage
+- **Key**: `comfyui_kikotools_seed_history`
+- **Format**: JSON array of history entries
+- **Location**: Browser localStorage
+- **Persistence**: Survives browser sessions and ComfyUI restarts
+
+## Use Cases
+
+### 🎨 Creative Workflows
+- **Iteration Tracking**: Keep track of promising seeds during creative exploration
+- **Version Control**: Easily return to previous seeds that produced good results
+- **Experimentation**: Generate and track multiple seed variations
+
+### 🔬 Technical Workflows
+- **Reproducibility**: Maintain exact seed records for reproducing specific outputs
+- **A/B Testing**: Compare results from different seeds with easy switching
+- **Documentation**: Export seed history for technical documentation
+
+### 📊 Batch Processing
+- **Seed Management**: Track seeds across multiple batch runs
+- **Quality Control**: Quickly identify and reuse successful seeds
+- **Workflow Optimization**: Analyze seed performance patterns
+
+## Tips and Best Practices
+
+### Efficient Usage
+1. **Let it Track**: The node automatically tracks all seed changes - no manual intervention needed
+2. **Use Generate**: The generate button is optimized for creating good random seeds
+3. **Regular Clearing**: Clear history periodically to maintain relevant seeds only
+
+### Workflow Integration
+1. **Single Source**: Use one Seed History node per workflow for centralized tracking
+2. **Connect Early**: Place the node early in your workflow chain for complete tracking
+3. **Branch Connections**: Connect to multiple nodes that need the same seed
+
+### History Management
+1. **Review Regularly**: Check history for seeds that produced good results
+2. **Document Success**: Note down particularly successful seeds externally
+3. **Clean Periodically**: Clear history when starting new creative projects
+
+## Troubleshooting
+
+### Common Issues
+
+**History Not Updating**
+- Ensure the node is properly connected to your workflow
+- Check that seed widget is visible and functional
+- Verify browser localStorage is enabled
+
+**UI Not Appearing**
+- Check browser console for JavaScript errors
+- Ensure ComfyUI-KikoTools is properly installed
+- Verify web directory permissions
+
+**Seeds Not Loading**
+- Confirm the seed is within valid range
+- Check that target widgets support the seed value
+- Verify node connections are intact
+
+### Performance Notes
+- History is limited to 10 entries for optimal performance
+- Deduplication prevents excessive storage usage
+- Auto-hide reduces visual clutter during long workflows
+
+## Examples
+
+See the `examples/workflows/` directory for complete workflow examples demonstrating:
+- Basic seed tracking workflow
+- Creative iteration with history
+- Technical reproducibility setup
+- Batch processing with seed management

examples/documentation/text_encode_sampler_params.md

@@ -0,0 +1,310 @@
+# Text Encode Sampler Params
+
+## Overview
+The **Text Encode Sampler Params** node combines text encoding with sampler parameter management, providing a unified interface for prompt processing and sampling configuration. Adapted from [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials) (now in maintenance mode), this tool streamlines the text-to-image pipeline setup.
+
+## Attribution
+This node is based on work from [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials) by cubiq. The original project is in maintenance-only mode, and we've adopted and enhanced these tools to ensure continued support and compatibility with modern ComfyUI workflows.
+
+## Features
+- **Unified Interface**: Combine text encoding and sampler params in one node
+- **Dynamic Prompt Processing**: Support for wildcards and syntax
+- **Parameter Templates**: Pre-configured settings for common scenarios
+- **Batch Text Processing**: Handle multiple prompts efficiently
+- **Model-Aware Encoding**: Optimize for different text encoders
+
+## Node Properties
+- **Category**: `ComfyAssets/🧰 xyz-helpers`
+- **Node Name**: `TextEncodeSamplerParams`
+- **Function**: `encode_and_params`
+
+## Inputs
+
+### Required
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `text` | STRING | - | Prompt text to encode |
+| `clip` | CLIP | - | CLIP model for encoding |
+| `sampler_name` | DROPDOWN | dpmpp_2m | Sampling algorithm |
+| `scheduler` | DROPDOWN | karras | Noise scheduler |
+| `steps` | INT | 20 | Sampling steps |
+| `cfg` | FLOAT | 7.0 | CFG scale |
+
+### Optional
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `negative_text` | STRING | "" | Negative prompt |
+| `seed` | INT | -1 | Random seed (-1 for random) |
+| `denoise` | FLOAT | 1.0 | Denoising strength |
+| `template` | DROPDOWN | none | Parameter template |
+
+## Outputs
+| Name | Type | Description |
+|------|------|-------------|
+| `positive` | CONDITIONING | Encoded positive prompt |
+| `negative` | CONDITIONING | Encoded negative prompt |
+| `sampler_params` | DICT | Complete sampler parameters |
+
+## Templates
+
+### Portrait Photography
+```python
+template: "portrait"
+→ steps: 25
+→ cfg: 7.5
+→ sampler: dpmpp_2m_sde
+→ scheduler: karras
+```
+
+### Landscape Art
+```python
+template: "landscape"
+→ steps: 30
+→ cfg: 8.0
+→ sampler: dpmpp_3m_sde
+→ scheduler: exponential
+```
+
+### Quick Preview
+```python
+template: "preview"
+→ steps: 12
+→ cfg: 6.0
+→ sampler: euler
+→ scheduler: normal
+```
+
+### High Detail
+```python
+template: "detailed"
+→ steps: 40
+→ cfg: 7.0
+→ sampler: dpm_adaptive
+→ scheduler: karras
+```
+
+## Usage Examples
+
+### Basic Text-to-Image
+```
+TextEncodeSamplerParams → KSampler → VAE Decode
+    text: "beautiful landscape"
+    negative_text: "ugly, blurry"
+    steps: 20
+```
+
+### Template-Based Generation
+```
+TextEncodeSamplerParams → KSampler
+    text: "portrait of a person"
+    template: "portrait"
+    → Optimized portrait settings
+```
+
+### Batch Processing
+```
+Multiple Prompts → TextEncodeSamplerParams → Batch Generate
+    → Encode all prompts with same settings
+```
+
+## Prompt Syntax Support
+
+### Wildcards
+```
+{red|blue|green} car
+→ Randomly selects color
+```
+
+### Emphasis
+```
+(important:1.2) detail
+→ Increases weight to 1.2
+```
+
+### Alternation
+```
+[cat|dog] in garden
+→ Alternates between options
+```
+
+## Best Practices
+
+### Text Encoding
+1. Keep prompts concise and descriptive
+2. Use emphasis for important elements
+3. Structure prompts logically
+4. Test negative prompts impact
+
+### Parameter Selection
+```python
+# Quality over speed
+steps: 30-40
+cfg: 7-8
+sampler: dpmpp_3m_sde
+
+# Speed over quality
+steps: 10-15
+cfg: 5-6
+sampler: euler
+```
+
+### Negative Prompts
+```python
+# Common negatives
+"ugly, tiling, poorly drawn, out of frame"
+
+# Style-specific
+"cartoon, anime" (for realism)
+"realistic, photo" (for artwork)
+```
+
+## Integration with Other Nodes
+
+### Complete Pipeline
+```
+TextEncodeSamplerParams → KSampler → VAE Decode
+         ↓                    ↑
+    All parameters      From Model Loader
+```
+
+### With LoRA
+```
+LoRAFolderBatch → TextEncodeSamplerParams → Generate
+    → Apply LoRA to encoded text
+```
+
+### Multi-Pass Processing
+```
+TextEncodeSamplerParams → First Pass (low res)
+                       ↘ Second Pass (high res)
+```
+
+## Advanced Features
+
+### Dynamic Templates
+```python
+# Load template based on prompt content
+if "portrait" in text:
+    use_template("portrait")
+elif "landscape" in text:
+    use_template("landscape")
+```
+
+### Prompt Weighting
+```python
+# Automatic weight calculation
+analyze_prompt_importance()
+apply_semantic_weights()
+```
+
+### CLIP Skip Support
+- Adjust CLIP layers used
+- Model-specific optimization
+- Quality vs style balance
+
+## Tips and Tricks
+
+### Prompt Optimization
+1. Front-load important elements
+2. Use commas for separation
+3. Avoid contradictions
+4. Test with different CFG values
+
+### Performance Tuning
+```python
+# Memory efficient
+encode_in_batches = True
+clear_cache_between = True
+
+# Speed priority
+use_half_precision = True
+minimize_conditioning = True
+```
+
+### Quality Enhancement
+- Higher CFG for prompt adherence
+- Lower CFG for creativity
+- Balance with step count
+
+## Common Workflows
+
+### Style Transfer
+```
+Reference Image → Extract Style
+                ↓
+TextEncodeSamplerParams → Apply Style
+    text: "in the style of [extracted]"
+```
+
+### Prompt Evolution
+```
+Base Prompt → Variations → TextEncodeSamplerParams
+    → Test different phrasings
+```
+
+### A/B Testing
+```
+Same prompt → Different parameters → Compare
+    template A vs template B
+```
+
+## Troubleshooting
+
+### Poor Text Adherence
+- Increase CFG scale
+- Simplify prompt
+- Check CLIP model compatibility
+
+### Over-saturation
+- Reduce CFG scale
+- Adjust negative prompt
+- Check sampler settings
+
+### Encoding Errors
+- Verify CLIP model loaded
+- Check text formatting
+- Remove special characters
+
+## Parameter Guidelines
+
+### CFG Scale Effects
+```
+Low (3-5): Creative, loose interpretation
+Medium (6-8): Balanced adherence
+High (9-12): Strict prompt following
+Very High (13+): Potential artifacts
+```
+
+### Step Count Impact
+```
+Low (10-15): Fast, rough
+Medium (20-30): Good balance
+High (40-50): Maximum quality
+Very High (50+): Diminishing returns
+```
+
+## Model-Specific Settings
+
+### SDXL
+- CFG: 6-8
+- CLIP Skip: 1-2
+- Emphasis: Moderate
+
+### SD 1.5
+- CFG: 7-9
+- CLIP Skip: 1-2
+- Emphasis: Standard
+
+### FLUX
+- CFG: 3-5
+- CLIP Skip: 0
+- Emphasis: Subtle
+
+## Version History
+- **1.0.0**: Initial adaptation from comfyui-essentials-nodes
+- **1.0.1**: Added template system
+- **1.0.2**: Enhanced prompt syntax support
+- **1.0.3**: Improved batch processing
+
+## Credits
+Original implementation by cubiq in [comfyui-essentials-nodes](https://github.com/cubiq/ComfyUI_essentials). Adapted and maintained by the ComfyAssets team.

examples/documentation/width_height_selector.md

@@ -147,7 +147,7 @@ Width Height Selector → EmptyLatentImage → Resolution Calculator → Upscale
 
 ### Aspect Ratio Considerations
 - **Portrait**: 3:4, 2:3, 13:19 work well for people
-- **Landscape**: 16:9, 19:13, 7:4 for scenes and objects  
+- **Landscape**: 16:9, 19:13, 7:4 for scenes and objects
 - **Square**: 1:1 for centered compositions
 - **Ultra-wide**: 21:9+ for panoramic and cinematic shots
 
@@ -192,4 +192,4 @@ Width Height Selector → EmptyLatentImage → Resolution Calculator → Upscale
 ### Preset Organization
 - Categorized by model optimization
 - Sorted by aspect ratio within categories
-- Comprehensive tooltips for each preset
+- Comprehensive tooltips for each preset

examples/test_prompts.txt

@@ -0,0 +1,14 @@
+A beautiful sunset over the ocean, golden hour lighting, professional photography, vibrant colors, high detail
+Negative: blurry, dark, low quality, distorted, oversaturated
+---
+Majestic mountain landscape with snow-capped peaks, dramatic clouds, alpine scenery, crystal clear air, epic composition
+Negative: foggy, flat lighting, boring composition, low contrast
+---
+Futuristic cityscape at night, neon lights, cyberpunk aesthetic, rain-slicked streets, atmospheric, blade runner style
+Negative: daylight, rural, old fashioned, low tech, empty streets
+---
+Enchanted forest with magical glowing mushrooms, fairy lights, mystical atmosphere, ancient trees, fantasy art style
+Negative: desert, urban, modern, realistic, mundane
+---
+Space station orbiting Earth, detailed mechanical structures, astronauts performing spacewalk, realistic sci-fi, NASA photography
+Negative: fantasy, medieval, underwater, cartoon style

examples/workflows/display_any_example.json

@@ -0,0 +1,379 @@
+{
+  "id": "display-any-example",
+  "revision": 0,
+  "last_node_id": 11,
+  "last_link_id": 9,
+  "nodes": [
+    {
+      "id": 1,
+      "type": "DisplayAny",
+      "pos": [
+        400,
+        270
+      ],
+      "size": [
+        210,
+        60
+      ],
+      "flags": {},
+      "order": 3,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "input",
+          "type": "*",
+          "link": 1
+        }
+      ],
+      "outputs": [
+        {
+          "name": "display_text",
+          "type": "STRING",
+          "links": [
+            8
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "DisplayAny"
+      },
+      "widgets_values": [
+        "tensor shape"
+      ]
+    },
+    {
+      "id": 2,
+      "type": "LoadImage",
+      "pos": [
+        50,
+        270
+      ],
+      "size": [
+        315,
+        314
+      ],
+      "flags": {},
+      "order": 2,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "IMAGE",
+          "type": "IMAGE",
+          "links": [
+            1,
+            5
+          ]
+        },
+        {
+          "name": "MASK",
+          "type": "MASK",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.47",
+        "Node name for S&R": "LoadImage"
+      },
+      "widgets_values": [
+        "example.png",
+        "image"
+      ]
+    },
+    {
+      "id": 4,
+      "type": "DisplayAny",
+      "pos": [
+        400,
+        520
+      ],
+      "size": [
+        210,
+        70
+      ],
+      "flags": {},
+      "order": 6,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "input",
+          "type": "*",
+          "link": 7
+        }
+      ],
+      "outputs": [
+        {
+          "name": "display_text",
+          "type": "STRING",
+          "links": [
+            9
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "DisplayAny"
+      },
+      "widgets_values": [
+        "raw value"
+      ]
+    },
+    {
+      "id": 7,
+      "type": "VAELoader",
+      "pos": [
+        -250,
+        410
+      ],
+      "size": [
+        270,
+        58
+      ],
+      "flags": {},
+      "order": 0,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "VAE",
+          "type": "VAE",
+          "links": [
+            6
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.47",
+        "Node name for S&R": "VAELoader"
+      },
+      "widgets_values": [
+        "ae.safetensors"
+      ]
+    },
+    {
+      "id": 8,
+      "type": "VAEEncode",
+      "pos": [
+        430,
+        390
+      ],
+      "size": [
+        140,
+        46
+      ],
+      "flags": {},
+      "order": 4,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "pixels",
+          "type": "IMAGE",
+          "link": 5
+        },
+        {
+          "name": "vae",
+          "type": "VAE",
+          "link": 6
+        }
+      ],
+      "outputs": [
+        {
+          "name": "LATENT",
+          "type": "LATENT",
+          "links": [
+            7
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.47",
+        "Node name for S&R": "VAEEncode"
+      },
+      "widgets_values": []
+    },
+    {
+      "id": 9,
+      "type": "DisplayText",
+      "pos": [
+        640,
+        270
+      ],
+      "size": [
+        450,
+        278
+      ],
+      "flags": {},
+      "order": 5,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "link": 8
+        }
+      ],
+      "outputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "DisplayText"
+      },
+      "widgets_values": [
+        null
+      ]
+    },
+    {
+      "id": 10,
+      "type": "DisplayText",
+      "pos": [
+        640,
+        610
+      ],
+      "size": [
+        590,
+        278
+      ],
+      "flags": {},
+      "order": 7,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "link": 9
+        }
+      ],
+      "outputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "DisplayText"
+      },
+      "widgets_values": [
+        null
+      ]
+    },
+    {
+      "id": 11,
+      "type": "MarkdownNote",
+      "pos": [
+        -320,
+        530
+      ],
+      "size": [
+        350,
+        270
+      ],
+      "flags": {},
+      "order": 1,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [],
+      "properties": {},
+      "widgets_values": [
+        "Display Any Example\n\nUniversal debugging tool:\n- Accepts ANY input type\n- Two modes: raw value or tensor shape\n- Finds tensors in nested structures\n\nUse cases:\n- Debug tensor dimensions\n- Inspect latent data\n- View config objects\n- Track data flow\n\nConnect anything to see its contents!"
+      ],
+      "color": "#432",
+      "bgcolor": "#653"
+    }
+  ],
+  "links": [
+    [
+      1,
+      2,
+      0,
+      1,
+      0,
+      "IMAGE"
+    ],
+    [
+      5,
+      2,
+      0,
+      8,
+      0,
+      "IMAGE"
+    ],
+    [
+      6,
+      7,
+      0,
+      8,
+      1,
+      "VAE"
+    ],
+    [
+      7,
+      8,
+      0,
+      4,
+      0,
+      "*"
+    ],
+    [
+      8,
+      1,
+      0,
+      9,
+      0,
+      "STRING"
+    ],
+    [
+      9,
+      4,
+      0,
+      10,
+      0,
+      "STRING"
+    ]
+  ],
+  "groups": [
+    {
+      "id": 1,
+      "title": "Display Any",
+      "bounding": [
+        -400,
+        130,
+        1740,
+        850
+      ],
+      "color": "#ffffff",
+      "font_size": 24,
+      "flags": {}
+    }
+  ],
+  "config": {},
+  "extra": {
+    "ds": {
+      "scale": 0.6115909044841477,
+      "offset": [
+        689.1392030323894,
+        -27.435530779258137
+      ]
+    },
+    "frontendVersion": "1.23.4",
+    "VHS_latentpreview": true,
+    "VHS_latentpreviewrate": 0,
+    "VHS_MetadataImage": true,
+    "VHS_KeepIntermediate": true
+  },
+  "version": 0.4
+}

examples/workflows/display_text_example.json

@@ -0,0 +1,144 @@
+{
+  "id": "display-text-example",
+  "revision": 0,
+  "last_node_id": 6,
+  "last_link_id": 2,
+  "nodes": [
+    {
+      "id": 1,
+      "type": "DisplayText",
+      "pos": [
+        -160,
+        70
+      ],
+      "size": [
+        500,
+        400
+      ],
+      "flags": {},
+      "order": 2,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "link": 2
+        }
+      ],
+      "outputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "DisplayText"
+      },
+      "widgets_values": [
+        null
+      ]
+    },
+    {
+      "id": 4,
+      "type": "easy positive",
+      "pos": [
+        -620,
+        70
+      ],
+      "size": [
+        400,
+        200
+      ],
+      "flags": {},
+      "order": 0,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "positive",
+          "type": "STRING",
+          "links": [
+            2
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfyui-easy-use",
+        "ver": "1.3.1",
+        "Node name for S&R": "easy positive"
+      },
+      "widgets_values": [
+        "Positive prompt:\nbeautiful landscape, mountains in background, sunset lighting, golden hour, professional photography, high resolution, detailed textures, vibrant colors, masterpiece\n\nNegative prompt:\nlow quality, blurry, pixelated, bad composition, oversaturated, underexposed, amateur"
+      ],
+      "color": "#232",
+      "bgcolor": "#353"
+    },
+    {
+      "id": 6,
+      "type": "MarkdownNote",
+      "pos": [
+        -620,
+        330
+      ],
+      "size": [
+        360,
+        250
+      ],
+      "flags": {},
+      "order": 1,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [],
+      "properties": {},
+      "widgets_values": [
+        "Display Text Example\n\nSmart text display with:\n- Auto-detection of SDXL prompt format\n- Split view for positive/negative prompts\n- Text wrapping and scrolling\n- Copy buttons (strips labels)\n- Responsive resizing\n\nTry editing the text to see:\n1. Single text mode (no prompt markers)\n2. Split view mode (with Positive/Negative prompts)\n\nPerfect for displaying Gemini-generated prompts!"
+      ],
+      "color": "#432",
+      "bgcolor": "#653"
+    }
+  ],
+  "links": [
+    [
+      2,
+      4,
+      0,
+      1,
+      0,
+      "STRING"
+    ]
+  ],
+  "groups": [
+    {
+      "id": 1,
+      "title": "Display Text",
+      "bounding": [
+        -750,
+        -60,
+        1240,
+        700
+      ],
+      "color": "#ffffff",
+      "font_size": 24,
+      "flags": {}
+    }
+  ],
+  "config": {},
+  "extra": {
+    "ds": {
+      "scale": 0.90909090909091,
+      "offset": [
+        720,
+        30
+      ]
+    },
+    "frontendVersion": "1.23.4",
+    "VHS_latentpreview": true,
+    "VHS_latentpreviewrate": 0,
+    "VHS_MetadataImage": true,
+    "VHS_KeepIntermediate": true
+  },
+  "version": 0.4
+}

examples/workflows/empty_latent_batch_example.json

@@ -0,0 +1,301 @@
+{
+  "id": "empty-latent-batch-example",
+  "revision": 0,
+  "last_node_id": 9,
+  "last_link_id": 8,
+  "nodes": [
+    {
+      "id": 1,
+      "type": "EmptyLatentBatch",
+      "pos": [
+        350,
+        350
+      ],
+      "size": [
+        370,
+        210
+      ],
+      "flags": {},
+      "order": 0,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "latent",
+          "type": "LATENT",
+          "slot_index": 0,
+          "links": []
+        },
+        {
+          "name": "width",
+          "type": "INT",
+          "slot_index": 1,
+          "links": [
+            4
+          ]
+        },
+        {
+          "name": "height",
+          "type": "INT",
+          "slot_index": 2,
+          "links": [
+            5
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "EmptyLatentBatch"
+      },
+      "widgets_values": [
+        "896×1152 - 7:9 (1.0MP) - SDXL",
+        896,
+        1152,
+        4
+      ]
+    },
+    {
+      "id": 2,
+      "type": "Note",
+      "pos": [
+        -50,
+        320
+      ],
+      "size": [
+        350,
+        250
+      ],
+      "flags": {},
+      "order": 1,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [],
+      "properties": {
+        "text": "Empty Latent Batch Example\n\nThis node creates empty latent tensors with:\n- 26 preset resolutions for SDXL/FLUX/Ultra-wide\n- Batch size support (1-64)\n- Interactive swap button\n- Memory usage estimation\n\nConnect to:\n- KSampler for image generation\n- Other latent processing nodes\n\nOutputs sanitized dimensions divisible by 8."
+      },
+      "widgets_values": [
+        "Empty Latent Batch Example\n\nThis node creates empty latent tensors with:\n- 26 preset resolutions for SDXL/FLUX/Ultra-wide\n- Batch size support (1-64)\n- Interactive swap button\n- Memory usage estimation\n\nConnect to:\n- KSampler for image generation\n- Other latent processing nodes\n\nOutputs sanitized dimensions divisible by 8."
+      ],
+      "color": "#432",
+      "bgcolor": "#653"
+    },
+    {
+      "id": 5,
+      "type": "DisplayAny",
+      "pos": [
+        760,
+        280
+      ],
+      "size": [
+        210,
+        60
+      ],
+      "flags": {},
+      "order": 2,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "input",
+          "type": "*",
+          "link": 4
+        }
+      ],
+      "outputs": [
+        {
+          "name": "display_text",
+          "type": "STRING",
+          "links": [
+            7
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "DisplayAny"
+      },
+      "widgets_values": [
+        "raw value"
+      ]
+    },
+    {
+      "id": 6,
+      "type": "DisplayAny",
+      "pos": [
+        770,
+        500
+      ],
+      "size": [
+        210,
+        60
+      ],
+      "flags": {},
+      "order": 3,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "input",
+          "type": "*",
+          "link": 5
+        }
+      ],
+      "outputs": [
+        {
+          "name": "display_text",
+          "type": "STRING",
+          "links": [
+            8
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "DisplayAny"
+      },
+      "widgets_values": [
+        "raw value"
+      ]
+    },
+    {
+      "id": 8,
+      "type": "DisplayText",
+      "pos": [
+        1000,
+        280
+      ],
+      "size": [
+        210,
+        138
+      ],
+      "flags": {},
+      "order": 4,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "link": 7
+        }
+      ],
+      "outputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "DisplayText"
+      },
+      "widgets_values": [
+        null
+      ]
+    },
+    {
+      "id": 9,
+      "type": "DisplayText",
+      "pos": [
+        1010,
+        500
+      ],
+      "size": [
+        210,
+        138
+      ],
+      "flags": {},
+      "order": 5,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "link": 8
+        }
+      ],
+      "outputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "DisplayText"
+      },
+      "widgets_values": [
+        null
+      ]
+    }
+  ],
+  "links": [
+    [
+      4,
+      1,
+      1,
+      5,
+      0,
+      "*"
+    ],
+    [
+      5,
+      1,
+      2,
+      6,
+      0,
+      "*"
+    ],
+    [
+      7,
+      5,
+      0,
+      8,
+      0,
+      "STRING"
+    ],
+    [
+      8,
+      6,
+      0,
+      9,
+      0,
+      "STRING"
+    ]
+  ],
+  "groups": [
+    {
+      "id": 1,
+      "title": "Empty Latent",
+      "bounding": [
+        -110,
+        120,
+        1440,
+        620
+      ],
+      "color": "#ffffff",
+      "font_size": 24,
+      "flags": {}
+    }
+  ],
+  "config": {},
+  "extra": {
+    "ds": {
+      "scale": 0.8264462809917358,
+      "offset": [
+        156.41790912499965,
+        -2.272547312500285
+      ]
+    },
+    "frontendVersion": "1.23.4",
+    "VHS_latentpreview": true,
+    "VHS_latentpreviewrate": 0,
+    "VHS_MetadataImage": true,
+    "VHS_KeepIntermediate": true
+  },
+  "version": 0.4
+}

examples/workflows/gemini_prompt_example.json

@@ -0,0 +1,207 @@
+{
+  "id": "gemini-prompt-example",
+  "revision": 0,
+  "last_node_id": 6,
+  "last_link_id": 4,
+  "nodes": [
+    {
+      "id": 2,
+      "type": "LoadImage",
+      "pos": [
+        300,
+        30
+      ],
+      "size": [
+        315,
+        314
+      ],
+      "flags": {},
+      "order": 1,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "IMAGE",
+          "type": "IMAGE",
+          "links": [
+            3
+          ]
+        },
+        {
+          "name": "MASK",
+          "type": "MASK",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.47",
+        "Node name for S&R": "LoadImage"
+      },
+      "widgets_values": [
+        "example.png",
+        "image"
+      ]
+    },
+    {
+      "id": 3,
+      "type": "DisplayText",
+      "pos": [
+        1070,
+        30
+      ],
+      "size": [
+        500,
+        400
+      ],
+      "flags": {},
+      "order": 3,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "link": 4
+        }
+      ],
+      "outputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "DisplayText"
+      },
+      "widgets_values": [
+        null
+      ]
+    },
+    {
+      "id": 5,
+      "type": "GeminiPrompt",
+      "pos": [
+        640,
+        30
+      ],
+      "size": [
+        400,
+        276
+      ],
+      "flags": {},
+      "order": 2,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "image",
+          "type": "IMAGE",
+          "link": 3
+        }
+      ],
+      "outputs": [
+        {
+          "name": "prompt",
+          "type": "STRING",
+          "links": [
+            4
+          ]
+        },
+        {
+          "name": "negative_prompt",
+          "type": "STRING",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "GeminiPrompt"
+      },
+      "widgets_values": [
+        "sdxl",
+        "gemini-2.0-flash",
+        "1234-1234-1234-1234",
+        "",
+        true,
+        null,
+        null,
+        null
+      ]
+    },
+    {
+      "id": 6,
+      "type": "MarkdownNote",
+      "pos": [
+        300,
+        410
+      ],
+      "size": [
+        400,
+        240
+      ],
+      "flags": {},
+      "order": 0,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [],
+      "properties": {},
+      "widgets_values": [
+        "Gemini Prompt Engineer Example\n\nAI-powered image analysis:\n- Analyzes image content and style\n- Generates optimized prompts for FLUX/SDXL/Danbooru/Video\n- Dynamic model selection with refresh button\n- Custom system prompt override\n\nSetup:\n1. Get free API key from Google AI Studio\n2. Set GEMINI_API_KEY env var or use config file\n3. Click refresh button to get latest models\n\nDisplayText automatically shows split view for SDXL prompts!"
+      ],
+      "color": "#432",
+      "bgcolor": "#653"
+    }
+  ],
+  "links": [
+    [
+      3,
+      2,
+      0,
+      5,
+      0,
+      "IMAGE"
+    ],
+    [
+      4,
+      5,
+      0,
+      3,
+      0,
+      "STRING"
+    ]
+  ],
+  "groups": [
+    {
+      "id": 1,
+      "title": "Gemini Prompt Engineer",
+      "bounding": [
+        210,
+        -110,
+        1460,
+        850
+      ],
+      "color": "#ffffff",
+      "font_size": 24,
+      "flags": {}
+    }
+  ],
+  "config": {},
+  "extra": {
+    "ds": {
+      "scale": 0.7513148009015777,
+      "offset": [
+        97.5582232217803,
+        133.12148846503663
+      ]
+    },
+    "frontendVersion": "1.23.4",
+    "VHS_latentpreview": true,
+    "VHS_latentpreviewrate": 0,
+    "VHS_MetadataImage": true,
+    "VHS_KeepIntermediate": true
+  },
+  "version": 0.4
+}

examples/workflows/image_to_multiple_of_example.json

@@ -0,0 +1,552 @@
+{
+  "id": "3cd0ac86-8d11-41e5-9d8b-6621bc810ee6",
+  "revision": 0,
+  "last_node_id": 21,
+  "last_link_id": 21,
+  "nodes": [
+    {
+      "id": 1,
+      "type": "LoadImage",
+      "pos": [
+        -80,
+        850
+      ],
+      "size": [
+        315,
+        314.0000305175781
+      ],
+      "flags": {},
+      "order": 1,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "label": "IMAGE",
+          "name": "IMAGE",
+          "type": "IMAGE",
+          "links": [
+            13
+          ]
+        },
+        {
+          "name": "MASK",
+          "type": "MASK",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.47",
+        "Node name for S&R": "LoadImage"
+      },
+      "widgets_values": [
+        "example.png",
+        "image"
+      ]
+    },
+    {
+      "id": 8,
+      "type": "GetNode",
+      "pos": [
+        540,
+        840
+      ],
+      "size": [
+        210,
+        34
+      ],
+      "flags": {
+        "collapsed": true
+      },
+      "order": 0,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "UPSCALE_MODEL",
+          "type": "UPSCALE_MODEL",
+          "links": []
+        }
+      ],
+      "title": "Get_upscale_skin_model",
+      "properties": {
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        "upscale_skin_model"
+      ]
+    },
+    {
+      "id": 9,
+      "type": "ImageUpscaleWithModel",
+      "pos": [
+        530,
+        810
+      ],
+      "size": [
+        221.98202514648438,
+        60
+      ],
+      "flags": {},
+      "order": 5,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "upscale_model",
+          "type": "UPSCALE_MODEL",
+          "link": 16
+        },
+        {
+          "name": "image",
+          "type": "IMAGE",
+          "link": 5
+        }
+      ],
+      "outputs": [
+        {
+          "name": "IMAGE",
+          "type": "IMAGE",
+          "links": [
+            10,
+            21
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.28",
+        "Node name for S&R": "ImageUpscaleWithModel",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": []
+    },
+    {
+      "id": 10,
+      "type": "ImageToMultipleOf",
+      "pos": [
+        1000,
+        810
+      ],
+      "size": [
+        230,
+        82
+      ],
+      "flags": {},
+      "order": 9,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "image",
+          "type": "IMAGE",
+          "link": 6
+        }
+      ],
+      "outputs": [
+        {
+          "name": "image",
+          "type": "IMAGE",
+          "links": [
+            18
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfyui-glifnodes",
+        "ver": "1.0.0",
+        "Node name for S&R": "ImageToMultipleOf",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        65,
+        "center crop"
+      ]
+    },
+    {
+      "id": 13,
+      "type": "ImageScaleBy",
+      "pos": [
+        760,
+        810
+      ],
+      "size": [
+        220,
+        82
+      ],
+      "flags": {},
+      "order": 7,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "image",
+          "type": "IMAGE",
+          "link": 10
+        }
+      ],
+      "outputs": [
+        {
+          "name": "IMAGE",
+          "type": "IMAGE",
+          "links": [
+            6,
+            19
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.28",
+        "Node name for S&R": "ImageScaleBy",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        "lanczos",
+        0.5000000000000001
+      ]
+    },
+    {
+      "id": 14,
+      "type": "ImageUpscaleWithModel",
+      "pos": [
+        280,
+        830
+      ],
+      "size": [
+        221.98202514648438,
+        60
+      ],
+      "flags": {},
+      "order": 4,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "upscale_model",
+          "type": "UPSCALE_MODEL",
+          "link": 15
+        },
+        {
+          "name": "image",
+          "type": "IMAGE",
+          "link": 13
+        }
+      ],
+      "outputs": [
+        {
+          "name": "IMAGE",
+          "type": "IMAGE",
+          "links": [
+            5,
+            20
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.28",
+        "Node name for S&R": "ImageUpscaleWithModel",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": []
+    },
+    {
+      "id": 15,
+      "type": "UpscaleModelLoader",
+      "pos": [
+        -90,
+        720
+      ],
+      "size": [
+        320,
+        60
+      ],
+      "flags": {},
+      "order": 2,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "UPSCALE_MODEL",
+          "type": "UPSCALE_MODEL",
+          "links": [
+            15
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.28",
+        "Node name for S&R": "UpscaleModelLoader",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        "4x-ClearRealityV1.pth"
+      ],
+      "color": "#232",
+      "bgcolor": "#353"
+    },
+    {
+      "id": 16,
+      "type": "UpscaleModelLoader",
+      "pos": [
+        140,
+        610
+      ],
+      "size": [
+        320,
+        60
+      ],
+      "flags": {},
+      "order": 3,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "UPSCALE_MODEL",
+          "type": "UPSCALE_MODEL",
+          "links": [
+            16
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.28",
+        "Node name for S&R": "UpscaleModelLoader",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        "1xSkinContrast-High-SuperUltraCompact.pth"
+      ],
+      "color": "#232",
+      "bgcolor": "#353"
+    },
+    {
+      "id": 18,
+      "type": "PreviewImage",
+      "pos": [
+        1260,
+        810
+      ],
+      "size": [
+        270,
+        280
+      ],
+      "flags": {},
+      "order": 11,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "images",
+          "type": "IMAGE",
+          "link": 18
+        }
+      ],
+      "outputs": [],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.47",
+        "Node name for S&R": "PreviewImage"
+      },
+      "widgets_values": []
+    },
+    {
+      "id": 19,
+      "type": "PreviewImage",
+      "pos": [
+        1010,
+        940
+      ],
+      "size": [
+        210,
+        258
+      ],
+      "flags": {},
+      "order": 10,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "images",
+          "type": "IMAGE",
+          "link": 19
+        }
+      ],
+      "outputs": [],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.47",
+        "Node name for S&R": "PreviewImage"
+      },
+      "widgets_values": []
+    },
+    {
+      "id": 20,
+      "type": "PreviewImage",
+      "pos": [
+        520,
+        940
+      ],
+      "size": [
+        210,
+        258
+      ],
+      "flags": {},
+      "order": 6,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "images",
+          "type": "IMAGE",
+          "link": 20
+        }
+      ],
+      "outputs": [],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.47",
+        "Node name for S&R": "PreviewImage"
+      },
+      "widgets_values": []
+    },
+    {
+      "id": 21,
+      "type": "PreviewImage",
+      "pos": [
+        750,
+        940
+      ],
+      "size": [
+        210,
+        258
+      ],
+      "flags": {},
+      "order": 8,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "images",
+          "type": "IMAGE",
+          "link": 21
+        }
+      ],
+      "outputs": [],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.47",
+        "Node name for S&R": "PreviewImage"
+      },
+      "widgets_values": []
+    }
+  ],
+  "links": [
+    [
+      5,
+      14,
+      0,
+      9,
+      1,
+      "IMAGE"
+    ],
+    [
+      6,
+      13,
+      0,
+      10,
+      0,
+      "IMAGE"
+    ],
+    [
+      10,
+      9,
+      0,
+      13,
+      0,
+      "IMAGE"
+    ],
+    [
+      13,
+      1,
+      0,
+      14,
+      1,
+      "IMAGE"
+    ],
+    [
+      15,
+      15,
+      0,
+      14,
+      0,
+      "UPSCALE_MODEL"
+    ],
+    [
+      16,
+      16,
+      0,
+      9,
+      0,
+      "UPSCALE_MODEL"
+    ],
+    [
+      18,
+      10,
+      0,
+      18,
+      0,
+      "IMAGE"
+    ],
+    [
+      19,
+      13,
+      0,
+      19,
+      0,
+      "IMAGE"
+    ],
+    [
+      20,
+      14,
+      0,
+      20,
+      0,
+      "IMAGE"
+    ],
+    [
+      21,
+      9,
+      0,
+      21,
+      0,
+      "IMAGE"
+    ]
+  ],
+  "groups": [
+    {
+      "id": 1,
+      "title": "Image to Multiple of",
+      "bounding": [
+        -180,
+        420,
+        1800,
+        830
+      ],
+      "color": "#ffffff",
+      "font_size": 24,
+      "flags": {}
+    }
+  ],
+  "config": {},
+  "extra": {
+    "ds": {
+      "scale": 0.6655312045216585,
+      "offset": [
+        292.51725658775155,
+        -375.0766486499791
+      ]
+    },
+    "frontendVersion": "1.23.4",
+    "VHS_latentpreview": true,
+    "VHS_latentpreviewrate": 0,
+    "VHS_MetadataImage": true,
+    "VHS_KeepIntermediate": true
+  },
+  "version": 0.4
+}

examples/workflows/kiko_film_grain_example.json

@@ -0,0 +1,165 @@
+{
+  "id": "kiko-film-grain-example",
+  "revision": 0,
+  "last_node_id": 4,
+  "last_link_id": 2,
+  "nodes": [
+    {
+      "id": 1,
+      "type": "LoadImage",
+      "pos": [
+        50,
+        100
+      ],
+      "size": [
+        350,
+        450
+      ],
+      "flags": {},
+      "order": 0,
+      "mode": 0,
+      "outputs": [
+        {
+          "name": "IMAGE",
+          "type": "IMAGE",
+          "links": [1],
+          "shape": 3,
+          "label": "IMAGE"
+        },
+        {
+          "name": "MASK",
+          "type": "MASK",
+          "links": null,
+          "shape": 3,
+          "label": "MASK"
+        }
+      ],
+      "properties": {
+        "Node name for S&R": "LoadImage"
+      },
+      "widgets_values": [
+        "example.png"
+      ]
+    },
+    {
+      "id": 2,
+      "type": "KikoFilmGrain",
+      "pos": [
+        450,
+        100
+      ],
+      "size": [
+        315,
+        202
+      ],
+      "flags": {},
+      "order": 1,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "image",
+          "type": "IMAGE",
+          "link": 1
+        }
+      ],
+      "outputs": [
+        {
+          "name": "image",
+          "type": "IMAGE",
+          "links": [2],
+          "shape": 3,
+          "label": "image",
+          "slot_index": 0
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "Node name for S&R": "KikoFilmGrain"
+      },
+      "widgets_values": [
+        0.5,
+        0.5,
+        0.7,
+        0.0,
+        0
+      ],
+      "color": "#223",
+      "bgcolor": "#335"
+    },
+    {
+      "id": 3,
+      "type": "PreviewImage",
+      "pos": [
+        850,
+        100
+      ],
+      "size": [
+        350,
+        450
+      ],
+      "flags": {},
+      "order": 2,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "images",
+          "type": "IMAGE",
+          "link": 2
+        }
+      ],
+      "properties": {
+        "Node name for S&R": "PreviewImage"
+      }
+    },
+    {
+      "id": 4,
+      "type": "Note",
+      "pos": [
+        450,
+        350
+      ],
+      "size": [
+        315,
+        150
+      ],
+      "flags": {},
+      "order": 3,
+      "mode": 0,
+      "properties": {
+        "text": ""
+      },
+      "widgets_values": [
+        "Kiko Film Grain Example\n\nThis workflow demonstrates the film grain effect.\n\nAdjust parameters:\n- Scale: Grain size (0.25-2.0)\n- Strength: Intensity (0.0-10.0)\n- Saturation: Color amount (0.0-2.0)\n- Toe: Shadow lifting (-0.2-0.5)\n- Seed: Random pattern"
+      ],
+      "color": "#432",
+      "bgcolor": "#653"
+    }
+  ],
+  "links": [
+    [
+      1,
+      1,
+      0,
+      2,
+      0,
+      "IMAGE"
+    ],
+    [
+      2,
+      2,
+      0,
+      3,
+      0,
+      "IMAGE"
+    ]
+  ],
+  "groups": [],
+  "config": {},
+  "extra": {
+    "ds": {
+      "scale": 1.0,
+      "offset": [0, 0]
+    }
+  },
+  "version": 0.4
+}

examples/workflows/kiko_save_image_example.json

@@ -0,0 +1,147 @@
+{
+  "id": "kiko-save-image-example",
+  "revision": 0,
+  "last_node_id": 4,
+  "last_link_id": 1,
+  "nodes": [
+    {
+      "id": 1,
+      "type": "KikoSaveImage",
+      "pos": [
+        390,
+        80
+      ],
+      "size": [
+        400,
+        390
+      ],
+      "flags": {},
+      "order": 2,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "images",
+          "type": "IMAGE",
+          "link": 1
+        }
+      ],
+      "outputs": [],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "KikoSaveImage"
+      },
+      "widgets_values": [
+        "KikoSave",
+        "PNG",
+        90,
+        4,
+        false,
+        true
+      ]
+    },
+    {
+      "id": 2,
+      "type": "LoadImage",
+      "pos": [
+        -10,
+        80
+      ],
+      "size": [
+        315,
+        314
+      ],
+      "flags": {},
+      "order": 1,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "IMAGE",
+          "type": "IMAGE",
+          "links": [
+            1
+          ]
+        },
+        {
+          "name": "MASK",
+          "type": "MASK",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.47",
+        "Node name for S&R": "LoadImage"
+      },
+      "widgets_values": [
+        "example.png",
+        "image"
+      ]
+    },
+    {
+      "id": 4,
+      "type": "MarkdownNote",
+      "pos": [
+        -10,
+        460
+      ],
+      "size": [
+        370,
+        270
+      ],
+      "flags": {},
+      "order": 0,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [],
+      "properties": {},
+      "widgets_values": [
+        "Kiko Save Image Example\n\nEnhanced image saving with:\n- Format selection: PNG, JPEG, WebP\n- Quality controls per format\n- Floating popup viewer (draggable)\n- Batch operations support\n- File size display\n\nPopup Features:\n- Click images to open in new tab\n- Download individual or selected images\n- Minimize/maximize/roll-up controls\n- Persistent across saves\n\nTry different formats to compare file sizes!"
+      ],
+      "color": "#432",
+      "bgcolor": "#653"
+    }
+  ],
+  "links": [
+    [
+      1,
+      2,
+      0,
+      1,
+      0,
+      "IMAGE"
+    ]
+  ],
+  "groups": [
+    {
+      "id": 1,
+      "title": "Kiko save Image",
+      "bounding": [
+        -110,
+        -60,
+        1020,
+        870
+      ],
+      "color": "#ffffff",
+      "font_size": 24,
+      "flags": {}
+    }
+  ],
+  "config": {},
+  "extra": {
+    "ds": {
+      "scale": 0.7513148009015777,
+      "offset": [
+        648.1018911400128,
+        110.02838653698085
+      ]
+    },
+    "frontendVersion": "1.23.4",
+    "VHS_latentpreview": true,
+    "VHS_latentpreviewrate": 0,
+    "VHS_MetadataImage": true,
+    "VHS_KeepIntermediate": true
+  },
+  "version": 0.4
+}

examples/workflows/resolution_calculator_example.json

@@ -1,47 +1,355 @@
 {
-  "last_node_id": 3,
-  "last_link_id": 2,
+  "id": "41469b2d-d616-479d-879a-95cdc6074a37",
+  "revision": 0,
+  "last_node_id": 11,
+  "last_link_id": 9,
   "nodes": [
     {
       "id": 1,
       "type": "ResolutionCalculator",
-      "pos": [100, 100],
-      "size": {"0": 315, "1": 126},
+      "pos": [
+        -30,
+        210
+      ],
+      "size": [
+        315,
+        126
+      ],
+      "flags": {},
+      "order": 2,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "image",
+          "shape": 7,
+          "type": "IMAGE",
+          "link": 5
+        },
+        {
+          "name": "latent",
+          "shape": 7,
+          "type": "LATENT",
+          "link": null
+        }
+      ],
+      "outputs": [
+        {
+          "name": "width",
+          "type": "INT",
+          "slot_index": 0,
+          "links": [
+            6
+          ]
+        },
+        {
+          "name": "height",
+          "type": "INT",
+          "slot_index": 1,
+          "links": [
+            7
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "965ad60c74d7f25b1acce890d9c06518e46e6d0b",
+        "Node name for S&R": "ResolutionCalculator",
+        "aux_id": "ComfyAssets/ComfyUI-KikoTools",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        2.5
+      ]
+    },
+    {
+      "id": 6,
+      "type": "LoadImage",
+      "pos": [
+        -340,
+        210
+      ],
+      "size": [
+        274.080078125,
+        314
+      ],
       "flags": {},
       "order": 0,
       "mode": 0,
-      "inputs": [
-        {"name": "image", "type": "IMAGE", "link": null},
-        {"name": "latent", "type": "LATENT", "link": null}
-      ],
+      "inputs": [],
       "outputs": [
-        {"name": "width", "type": "INT", "links": [1], "slot_index": 0},
-        {"name": "height", "type": "INT", "links": [2], "slot_index": 1}
+        {
+          "name": "IMAGE",
+          "type": "IMAGE",
+          "links": [
+            5
+          ]
+        },
+        {
+          "name": "MASK",
+          "type": "MASK",
+          "links": null
+        }
       ],
-      "properties": {},
-      "widgets_values": [2.0],
-      "category": "ComfyAssets"
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "LoadImage",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        "image-2025-06-13-105737.jpg",
+        "image"
+      ]
     },
     {
-      "id": 2,
-      "type": "Note",
-      "pos": [450, 100],
-      "size": {"0": 400, "1": 200},
+      "id": 7,
+      "type": "MarkdownNote",
+      "pos": [
+        -350,
+        610
+      ],
+      "size": [
+        410,
+        200
+      ],
       "flags": {},
       "order": 1,
       "mode": 0,
       "inputs": [],
       "outputs": [],
-      "properties": {"text": "Resolution Calculator Example\n\nThis node calculates upscaled dimensions from:\n- IMAGE tensors (connect from image loaders)\n- LATENT tensors (connect from VAE encode/generation)\n\nUse cases:\n- Calculate target dimensions for upscalers\n- Plan memory usage for large generations\n- Ensure dimensions are divisible by 8\n\nScale factors optimized for SDXL and FLUX models."},
-      "widgets_values": ["Resolution Calculator Example\n\nThis node calculates upscaled dimensions from:\n- IMAGE tensors (connect from image loaders)\n- LATENT tensors (connect from VAE encode/generation)\n\nUse cases:\n- Calculate target dimensions for upscalers\n- Plan memory usage for large generations\n- Ensure dimensions are divisible by 8\n\nScale factors optimized for SDXL and FLUX models."]
+      "properties": {},
+      "widgets_values": [
+        "Resolution Calculator Example\n\nThis node calculates upscaled dimensions from:\n- IMAGE tensors (connect from image loaders)\n- LATENT tensors (connect from VAE encode/generation)\n\nUse cases:\n- Calculate target dimensions for upscalers\n- Plan memory usage for large generations\n- Ensure dimensions are divisible by 8\n\nScale factors optimized for SDXL and FLUX models."
+      ],
+      "color": "#432",
+      "bgcolor": "#653"
+    },
+    {
+      "id": 8,
+      "type": "DisplayAny",
+      "pos": [
+        330,
+        160
+      ],
+      "size": [
+        270,
+        58
+      ],
+      "flags": {},
+      "order": 3,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "input",
+          "type": "*",
+          "link": 6
+        }
+      ],
+      "outputs": [
+        {
+          "name": "display_text",
+          "type": "STRING",
+          "links": [
+            8
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "DisplayAny"
+      },
+      "widgets_values": [
+        "raw value"
+      ]
+    },
+    {
+      "id": 9,
+      "type": "DisplayAny",
+      "pos": [
+        330,
+        310
+      ],
+      "size": [
+        270,
+        58
+      ],
+      "flags": {},
+      "order": 4,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "input",
+          "type": "*",
+          "link": 7
+        }
+      ],
+      "outputs": [
+        {
+          "name": "display_text",
+          "type": "STRING",
+          "links": [
+            9
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "DisplayAny"
+      },
+      "widgets_values": [
+        "raw value"
+      ]
+    },
+    {
+      "id": 10,
+      "type": "DisplayText",
+      "pos": [
+        670,
+        160
+      ],
+      "size": [
+        210,
+        138
+      ],
+      "flags": {},
+      "order": 5,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "link": 8
+        }
+      ],
+      "outputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "DisplayText"
+      },
+      "widgets_values": [
+        null
+      ]
+    },
+    {
+      "id": 11,
+      "type": "DisplayText",
+      "pos": [
+        660,
+        400
+      ],
+      "size": [
+        210,
+        138
+      ],
+      "flags": {},
+      "order": 6,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "link": 9
+        }
+      ],
+      "outputs": [
+        {
+          "name": "text",
+          "type": "STRING",
+          "links": null
+        }
+      ],
+      "properties": {
+        "cnr_id": "kikotools",
+        "ver": "271cd020c1b2f78e7ee40c1f08e70191fed00012",
+        "Node name for S&R": "DisplayText"
+      },
+      "widgets_values": [
+        null
+      ]
     }
   ],
   "links": [
-    [1, 1, 0, 3, 0, "INT"],
-    [2, 1, 1, 3, 1, "INT"]
+    [
+      5,
+      6,
+      0,
+      1,
+      0,
+      "IMAGE"
+    ],
+    [
+      6,
+      1,
+      0,
+      8,
+      0,
+      "*"
+    ],
+    [
+      7,
+      1,
+      1,
+      9,
+      0,
+      "*"
+    ],
+    [
+      8,
+      8,
+      0,
+      10,
+      0,
+      "STRING"
+    ],
+    [
+      9,
+      9,
+      0,
+      11,
+      0,
+      "STRING"
+    ]
+  ],
+  "groups": [
+    {
+      "id": 1,
+      "title": "Resolution Calculator",
+      "bounding": [
+        -480,
+        20,
+        1480,
+        880
+      ],
+      "color": "#ffffff",
+      "font_size": 24,
+      "flags": {}
+    }
   ],
-  "groups": [],
   "config": {},
-  "extra": {},
+  "extra": {
+    "ue_links": [],
+    "ds": {
+      "scale": 0.45000000000000145,
+      "offset": [
+        1248.1498802376432,
+        256.0155843113725
+      ]
+    },
+    "links_added_by_ue": [],
+    "frontendVersion": "1.23.4",
+    "VHS_latentpreview": true,
+    "VHS_latentpreviewrate": 0,
+    "VHS_MetadataImage": true,
+    "VHS_KeepIntermediate": true
+  },
   "version": 0.4
-}
+}

examples/workflows/sampler_combo_example.json

@@ -0,0 +1,537 @@
+{
+  "id": "972425bd-9910-484d-ad09-f142f534fc61",
+  "revision": 0,
+  "last_node_id": 10,
+  "last_link_id": 13,
+  "nodes": [
+    {
+      "id": 7,
+      "type": "CLIPTextEncode",
+      "pos": [
+        120,
+        390
+      ],
+      "size": [
+        425.27801513671875,
+        180.6060791015625
+      ],
+      "flags": {},
+      "order": 4,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "clip",
+          "type": "CLIP",
+          "link": 5
+        }
+      ],
+      "outputs": [
+        {
+          "name": "CONDITIONING",
+          "type": "CONDITIONING",
+          "slot_index": 0,
+          "links": [
+            6
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "CLIPTextEncode",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        "text, watermark"
+      ]
+    },
+    {
+      "id": 5,
+      "type": "EmptyLatentImage",
+      "pos": [
+        180,
+        610
+      ],
+      "size": [
+        315,
+        106
+      ],
+      "flags": {},
+      "order": 0,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "LATENT",
+          "type": "LATENT",
+          "slot_index": 0,
+          "links": [
+            2
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "EmptyLatentImage",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        512,
+        512,
+        1
+      ]
+    },
+    {
+      "id": 3,
+      "type": "KSampler",
+      "pos": [
+        863,
+        186
+      ],
+      "size": [
+        315,
+        571
+      ],
+      "flags": {},
+      "order": 5,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "model",
+          "type": "MODEL",
+          "link": 1
+        },
+        {
+          "name": "positive",
+          "type": "CONDITIONING",
+          "link": 4
+        },
+        {
+          "name": "negative",
+          "type": "CONDITIONING",
+          "link": 6
+        },
+        {
+          "name": "latent_image",
+          "type": "LATENT",
+          "link": 2
+        },
+        {
+          "name": "steps",
+          "type": "INT",
+          "widget": {
+            "name": "steps"
+          },
+          "link": 12
+        },
+        {
+          "name": "cfg",
+          "type": "FLOAT",
+          "widget": {
+            "name": "cfg"
+          },
+          "link": 13
+        },
+        {
+          "name": "sampler_name",
+          "type": "COMBO",
+          "widget": {
+            "name": "sampler_name"
+          },
+          "link": 10
+        },
+        {
+          "name": "scheduler",
+          "type": "COMBO",
+          "widget": {
+            "name": "scheduler"
+          },
+          "link": 11
+        }
+      ],
+      "outputs": [
+        {
+          "name": "LATENT",
+          "type": "LATENT",
+          "slot_index": 0,
+          "links": [
+            7
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "KSampler",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        555950987049067,
+        "randomize",
+        20,
+        8,
+        "euler",
+        "normal",
+        1,
+        ""
+      ]
+    },
+    {
+      "id": 8,
+      "type": "VAEDecode",
+      "pos": [
+        1209,
+        188
+      ],
+      "size": [
+        210,
+        46
+      ],
+      "flags": {},
+      "order": 6,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "samples",
+          "type": "LATENT",
+          "link": 7
+        },
+        {
+          "name": "vae",
+          "type": "VAE",
+          "link": 8
+        }
+      ],
+      "outputs": [
+        {
+          "name": "IMAGE",
+          "type": "IMAGE",
+          "slot_index": 0,
+          "links": [
+            9
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "VAEDecode",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": []
+    },
+    {
+      "id": 9,
+      "type": "SaveImage",
+      "pos": [
+        1451,
+        189
+      ],
+      "size": [
+        210,
+        270
+      ],
+      "flags": {},
+      "order": 7,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "images",
+          "type": "IMAGE",
+          "link": 9
+        }
+      ],
+      "outputs": [],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "SaveImage",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        "ComfyUI"
+      ]
+    },
+    {
+      "id": 6,
+      "type": "CLIPTextEncode",
+      "pos": [
+        120,
+        180
+      ],
+      "size": [
+        422.84503173828125,
+        164.31304931640625
+      ],
+      "flags": {},
+      "order": 3,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "clip",
+          "type": "CLIP",
+          "link": 3
+        }
+      ],
+      "outputs": [
+        {
+          "name": "CONDITIONING",
+          "type": "CONDITIONING",
+          "slot_index": 0,
+          "links": [
+            4
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "CLIPTextEncode",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        "beautiful scenery nature glass bottle landscape, , purple galaxy bottle,"
+      ]
+    },
+    {
+      "id": 10,
+      "type": "SamplerCombo",
+      "pos": [
+        550,
+        290
+      ],
+      "size": [
+        300,
+        200
+      ],
+      "flags": {},
+      "order": 1,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "sampler_name",
+          "type": "COMBO",
+          "slot_index": 0,
+          "links": [
+            10
+          ]
+        },
+        {
+          "name": "scheduler",
+          "type": "COMBO",
+          "slot_index": 1,
+          "links": [
+            11
+          ]
+        },
+        {
+          "name": "steps",
+          "type": "INT",
+          "slot_index": 2,
+          "links": [
+            12
+          ]
+        },
+        {
+          "name": "cfg",
+          "type": "FLOAT",
+          "slot_index": 3,
+          "links": [
+            13
+          ]
+        }
+      ],
+      "properties": {
+        "aux_id": "ComfyAssets/ComfyUI-KikoTools",
+        "ver": "dcf2d679c1a1091c54c2aa8cc04724236723227d",
+        "widget_ue_connectable": {},
+        "Node name for S&R": "SamplerCombo"
+      },
+      "widgets_values": [
+        "dpmpp_2m",
+        "karras",
+        25,
+        7.5
+      ]
+    },
+    {
+      "id": 4,
+      "type": "CheckpointLoaderSimple",
+      "pos": [
+        -220,
+        180
+      ],
+      "size": [
+        315,
+        98
+      ],
+      "flags": {},
+      "order": 2,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "MODEL",
+          "type": "MODEL",
+          "slot_index": 0,
+          "links": [
+            1
+          ]
+        },
+        {
+          "name": "CLIP",
+          "type": "CLIP",
+          "slot_index": 1,
+          "links": [
+            3,
+            5
+          ]
+        },
+        {
+          "name": "VAE",
+          "type": "VAE",
+          "slot_index": 2,
+          "links": [
+            8
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "CheckpointLoaderSimple",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        "sdxl_ckpt/realvisxlV40_v40LightningBakedvae.safetensors"
+      ]
+    }
+  ],
+  "links": [
+    [
+      1,
+      4,
+      0,
+      3,
+      0,
+      "MODEL"
+    ],
+    [
+      2,
+      5,
+      0,
+      3,
+      3,
+      "LATENT"
+    ],
+    [
+      3,
+      4,
+      1,
+      6,
+      0,
+      "CLIP"
+    ],
+    [
+      4,
+      6,
+      0,
+      3,
+      1,
+      "CONDITIONING"
+    ],
+    [
+      5,
+      4,
+      1,
+      7,
+      0,
+      "CLIP"
+    ],
+    [
+      6,
+      7,
+      0,
+      3,
+      2,
+      "CONDITIONING"
+    ],
+    [
+      7,
+      3,
+      0,
+      8,
+      0,
+      "LATENT"
+    ],
+    [
+      8,
+      4,
+      2,
+      8,
+      1,
+      "VAE"
+    ],
+    [
+      9,
+      8,
+      0,
+      9,
+      0,
+      "IMAGE"
+    ],
+    [
+      10,
+      10,
+      0,
+      3,
+      6,
+      "COMBO"
+    ],
+    [
+      11,
+      10,
+      1,
+      3,
+      7,
+      "COMBO"
+    ],
+    [
+      12,
+      10,
+      2,
+      3,
+      4,
+      "INT"
+    ],
+    [
+      13,
+      10,
+      3,
+      3,
+      5,
+      "FLOAT"
+    ]
+  ],
+  "groups": [],
+  "config": {},
+  "extra": {
+    "ue_links": [],
+    "links_added_by_ue": [],
+    "ds": {
+      "scale": 0.9740024562304554,
+      "offset": [
+        75.10666660323399,
+        -252.18018113111526
+      ]
+    },
+    "frontendVersion": "1.21.7",
+    "VHS_latentpreview": true,
+    "VHS_latentpreviewrate": 0,
+    "VHS_MetadataImage": true,
+    "VHS_KeepIntermediate": true
+  },
+  "version": 0.4
+}

examples/workflows/seed_history_example.json

@@ -0,0 +1,644 @@
+{
+  "id": "972425bd-9910-484d-ad09-f142f534fc61",
+  "revision": 0,
+  "last_node_id": 11,
+  "last_link_id": 14,
+  "nodes": [
+    {
+      "id": 7,
+      "type": "CLIPTextEncode",
+      "pos": [
+        120,
+        390
+      ],
+      "size": [
+        425.27801513671875,
+        180.6060791015625
+      ],
+      "flags": {},
+      "order": 5,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "clip",
+          "type": "CLIP",
+          "link": 5
+        }
+      ],
+      "outputs": [
+        {
+          "name": "CONDITIONING",
+          "type": "CONDITIONING",
+          "slot_index": 0,
+          "links": [
+            6
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "CLIPTextEncode",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        "text, watermark"
+      ]
+    },
+    {
+      "id": 5,
+      "type": "EmptyLatentImage",
+      "pos": [
+        180,
+        610
+      ],
+      "size": [
+        315,
+        106
+      ],
+      "flags": {},
+      "order": 0,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "LATENT",
+          "type": "LATENT",
+          "slot_index": 0,
+          "links": [
+            2
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "EmptyLatentImage",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        512,
+        512,
+        1
+      ]
+    },
+    {
+      "id": 3,
+      "type": "KSampler",
+      "pos": [
+        863,
+        186
+      ],
+      "size": [
+        315,
+        571
+      ],
+      "flags": {},
+      "order": 6,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "model",
+          "type": "MODEL",
+          "link": 1
+        },
+        {
+          "name": "positive",
+          "type": "CONDITIONING",
+          "link": 4
+        },
+        {
+          "name": "negative",
+          "type": "CONDITIONING",
+          "link": 6
+        },
+        {
+          "name": "latent_image",
+          "type": "LATENT",
+          "link": 2
+        },
+        {
+          "name": "seed",
+          "type": "INT",
+          "widget": {
+            "name": "seed"
+          },
+          "link": 14
+        },
+        {
+          "name": "steps",
+          "type": "INT",
+          "widget": {
+            "name": "steps"
+          },
+          "link": 12
+        },
+        {
+          "name": "cfg",
+          "type": "FLOAT",
+          "widget": {
+            "name": "cfg"
+          },
+          "link": 13
+        },
+        {
+          "name": "sampler_name",
+          "type": "COMBO",
+          "widget": {
+            "name": "sampler_name"
+          },
+          "link": 10
+        },
+        {
+          "name": "scheduler",
+          "type": "COMBO",
+          "widget": {
+            "name": "scheduler"
+          },
+          "link": 11
+        }
+      ],
+      "outputs": [
+        {
+          "name": "LATENT",
+          "type": "LATENT",
+          "slot_index": 0,
+          "links": [
+            7
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "KSampler",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        231413202715030,
+        "randomize",
+        20,
+        8,
+        "euler",
+        "normal",
+        1,
+        ""
+      ]
+    },
+    {
+      "id": 8,
+      "type": "VAEDecode",
+      "pos": [
+        1209,
+        188
+      ],
+      "size": [
+        210,
+        46
+      ],
+      "flags": {},
+      "order": 7,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "samples",
+          "type": "LATENT",
+          "link": 7
+        },
+        {
+          "name": "vae",
+          "type": "VAE",
+          "link": 8
+        }
+      ],
+      "outputs": [
+        {
+          "name": "IMAGE",
+          "type": "IMAGE",
+          "slot_index": 0,
+          "links": [
+            9
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "VAEDecode",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": []
+    },
+    {
+      "id": 9,
+      "type": "SaveImage",
+      "pos": [
+        1451,
+        189
+      ],
+      "size": [
+        210,
+        270
+      ],
+      "flags": {},
+      "order": 8,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "images",
+          "type": "IMAGE",
+          "link": 9
+        }
+      ],
+      "outputs": [],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "SaveImage",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        "ComfyUI"
+      ]
+    },
+    {
+      "id": 6,
+      "type": "CLIPTextEncode",
+      "pos": [
+        120,
+        180
+      ],
+      "size": [
+        422.84503173828125,
+        164.31304931640625
+      ],
+      "flags": {},
+      "order": 4,
+      "mode": 0,
+      "inputs": [
+        {
+          "name": "clip",
+          "type": "CLIP",
+          "link": 3
+        }
+      ],
+      "outputs": [
+        {
+          "name": "CONDITIONING",
+          "type": "CONDITIONING",
+          "slot_index": 0,
+          "links": [
+            4
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "CLIPTextEncode",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        "beautiful scenery nature glass bottle landscape, , purple galaxy bottle,"
+      ]
+    },
+    {
+      "id": 4,
+      "type": "CheckpointLoaderSimple",
+      "pos": [
+        -220,
+        180
+      ],
+      "size": [
+        315,
+        98
+      ],
+      "flags": {},
+      "order": 1,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "MODEL",
+          "type": "MODEL",
+          "slot_index": 0,
+          "links": [
+            1
+          ]
+        },
+        {
+          "name": "CLIP",
+          "type": "CLIP",
+          "slot_index": 1,
+          "links": [
+            3,
+            5
+          ]
+        },
+        {
+          "name": "VAE",
+          "type": "VAE",
+          "slot_index": 2,
+          "links": [
+            8
+          ]
+        }
+      ],
+      "properties": {
+        "cnr_id": "comfy-core",
+        "ver": "0.3.40",
+        "Node name for S&R": "CheckpointLoaderSimple",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        "sdxl_ckpt/realvisxlV40_v40LightningBakedvae.safetensors"
+      ]
+    },
+    {
+      "id": 10,
+      "type": "SamplerCombo",
+      "pos": [
+        550,
+        360
+      ],
+      "size": [
+        300,
+        200
+      ],
+      "flags": {},
+      "order": 2,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "sampler_name",
+          "type": "COMBO",
+          "slot_index": 0,
+          "links": [
+            10
+          ]
+        },
+        {
+          "name": "scheduler",
+          "type": "COMBO",
+          "slot_index": 1,
+          "links": [
+            11
+          ]
+        },
+        {
+          "name": "steps",
+          "type": "INT",
+          "slot_index": 2,
+          "links": [
+            12
+          ]
+        },
+        {
+          "name": "cfg",
+          "type": "FLOAT",
+          "slot_index": 3,
+          "links": [
+            13
+          ]
+        }
+      ],
+      "properties": {
+        "aux_id": "ComfyAssets/ComfyUI-KikoTools",
+        "ver": "dcf2d679c1a1091c54c2aa8cc04724236723227d",
+        "Node name for S&R": "SamplerCombo",
+        "widget_ue_connectable": {}
+      },
+      "widgets_values": [
+        "dpmpp_2m",
+        "karras",
+        25,
+        7.5
+      ]
+    },
+    {
+      "id": 11,
+      "type": "SeedHistory",
+      "pos": [
+        550,
+        100
+      ],
+      "size": [
+        290,
+        220
+      ],
+      "flags": {},
+      "order": 3,
+      "mode": 0,
+      "inputs": [],
+      "outputs": [
+        {
+          "name": "seed",
+          "type": "INT",
+          "links": [
+            14
+          ]
+        }
+      ],
+      "properties": {
+        "aux_id": "ComfyAssets/ComfyUI-KikoTools",
+        "ver": "dcf2d679c1a1091c54c2aa8cc04724236723227d",
+        "widget_ue_connectable": {},
+        "Node name for S&R": "SeedHistory"
+      },
+      "widgets_values": [
+        893082183398485,
+        "randomize",
+        ""
+      ],
+      "color": "#2a363b",
+      "bgcolor": "#3f5159",
+      "hasBeenResized": true,
+      "seedHistory": [
+        {
+          "seed": 893082183398485,
+          "timestamp": 1750032481153,
+          "dateString": "6/15/2025, 5:08:01 PM"
+        },
+        {
+          "seed": 267914687236135,
+          "timestamp": 1750014787315,
+          "dateString": "6/15/2025, 12:13:07 PM"
+        },
+        {
+          "seed": 267914687236134,
+          "timestamp": 1750014721305,
+          "dateString": "6/15/2025, 12:12:01 PM"
+        },
+        {
+          "seed": 267914687236133,
+          "timestamp": 1750012659402,
+          "dateString": "6/15/2025, 11:37:39 AM"
+        },
+        {
+          "seed": 267914687236132,
+          "timestamp": 1750011284415,
+          "dateString": "6/15/2025, 11:14:44 AM"
+        },
+        {
+          "seed": 267914687236131,
+          "timestamp": 1750011223416,
+          "dateString": "6/15/2025, 11:13:43 AM"
+        },
+        {
+          "seed": 267914687236130,
+          "timestamp": 1750011181407,
+          "dateString": "6/15/2025, 11:13:01 AM"
+        },
+        {
+          "seed": 267914687236129,
+          "timestamp": 1750005515384,
+          "dateString": "6/15/2025, 9:38:35 AM"
+        },
+        {
+          "seed": 267914687236128,
+          "timestamp": 1750005462384,
+          "dateString": "6/15/2025, 9:37:42 AM"
+        },
+        {
+          "seed": 267914687236127,
+          "timestamp": 1750005354713,
+          "dateString": "6/15/2025, 9:35:54 AM"
+        }
+      ]
+    }
+  ],
+  "links": [
+    [
+      1,
+      4,
+      0,
+      3,
+      0,
+      "MODEL"
+    ],
+    [
+      2,
+      5,
+      0,
+      3,
+      3,
+      "LATENT"
+    ],
+    [
+      3,
+      4,
+      1,
+      6,
+      0,
+      "CLIP"
+    ],
+    [
+      4,
+      6,
+      0,
+      3,
+      1,
+      "CONDITIONING"
+    ],
+    [
+      5,
+      4,
+      1,
+      7,
+      0,
+      "CLIP"
+    ],
+    [
+      6,
+      7,
+      0,
+      3,
+      2,
+      "CONDITIONING"
+    ],
+    [
+      7,
+      3,
+      0,
+      8,
+      0,
+      "LATENT"
+    ],
+    [
+      8,
+      4,
+      2,
+      8,
+      1,
+      "VAE"
+    ],
+    [
+      9,
+      8,
+      0,
+      9,
+      0,
+      "IMAGE"
+    ],
+    [
+      10,
+      10,
+      0,
+      3,
+      7,
+      "COMBO"
+    ],
+    [
+      11,
+      10,
+      1,
+      3,
+      8,
+      "COMBO"
+    ],
+    [
+      12,
+      10,
+      2,
+      3,
+      5,
+      "INT"
+    ],
+    [
+      13,
+      10,
+      3,
+      3,
+      6,
+      "FLOAT"
+    ],
+    [
+      14,
+      11,
+      0,
+      3,
+      4,
+      "INT"
+    ]
+  ],
+  "groups": [],
+  "config": {},
+  "extra": {
+    "ue_links": [],
+    "links_added_by_ue": [],
+    "ds": {
+      "scale": 0.9740024562304554,
+      "offset": [
+        2.9611945935278796,
+        36.50023864466208
+      ]
+    },
+    "frontendVersion": "1.21.7",
+    "VHS_latentpreview": true,
+    "VHS_latentpreviewrate": 0,
+    "VHS_MetadataImage": true,
+    "VHS_KeepIntermediate": true
+  },
+  "version": 0.4
+}

examples/workflows/xyz_helpers_sampler_comparison.json

@@ -0,0 +1,169 @@
+{
+  "name": "Sampler and Scheduler Comparison Workflow",
+  "description": "Compare different sampler and scheduler combinations using xyz_helpers",
+  "nodes": [
+    {
+      "id": "1",
+      "type": "SamplerSelectHelper",
+      "title": "Select Optimal Sampler",
+      "category": "ComfyAssets/🧰 xyz-helpers",
+      "inputs": {
+        "model_type": "auto",
+        "quality_preset": "balanced",
+        "sampler_override": "auto",
+        "model_name": "sdxl_model.safetensors"
+      },
+      "outputs": {
+        "sampler_name": "STRING",
+        "scheduler": "STRING",
+        "recommended_steps": "INT",
+        "recommended_cfg": "FLOAT"
+      },
+      "pos": [100, 100]
+    },
+    {
+      "id": "2",
+      "type": "SchedulerSelectHelper",
+      "title": "Optimize Scheduler",
+      "category": "ComfyAssets/🧰 xyz-helpers",
+      "inputs": {
+        "sampler_name": ["1", "sampler_name"],
+        "model_type": "sdxl",
+        "schedule_type": "smooth",
+        "visualize": true
+      },
+      "outputs": {
+        "scheduler": "STRING",
+        "schedule_curve": "IMAGE"
+      },
+      "pos": [400, 100]
+    },
+    {
+      "id": "3",
+      "type": "TextEncodeSamplerParams",
+      "title": "Setup Text and Params",
+      "category": "ComfyAssets/🧰 xyz-helpers",
+      "inputs": {
+        "text": "a majestic mountain landscape at sunset, highly detailed",
+        "negative_text": "low quality, blurry, artifacts",
+        "clip": ["model", "clip"],
+        "sampler_name": ["1", "sampler_name"],
+        "scheduler": ["2", "scheduler"],
+        "steps": ["1", "recommended_steps"],
+        "cfg": ["1", "recommended_cfg"],
+        "template": "landscape"
+      },
+      "outputs": {
+        "positive": "CONDITIONING",
+        "negative": "CONDITIONING",
+        "sampler_params": "DICT"
+      },
+      "pos": [700, 100]
+    },
+    {
+      "id": "4",
+      "type": "EmptyLatentBatch",
+      "title": "Create Test Latents",
+      "category": "ComfyAssets/📦 Latents",
+      "inputs": {
+        "preset": "1216×832 (SDXL Landscape)",
+        "batch_size": 4
+      },
+      "outputs": {
+        "latent": "LATENT"
+      },
+      "pos": [100, 300]
+    },
+    {
+      "id": "5",
+      "type": "KSampler",
+      "title": "Generate with Optimal Settings",
+      "inputs": {
+        "model": ["model", "model"],
+        "positive": ["3", "positive"],
+        "negative": ["3", "negative"],
+        "latent_image": ["4", "latent"],
+        "sampler_name": ["1", "sampler_name"],
+        "scheduler": ["2", "scheduler"],
+        "steps": ["1", "recommended_steps"],
+        "cfg": ["1", "recommended_cfg"],
+        "seed": 42
+      },
+      "outputs": {
+        "latent": "LATENT"
+      },
+      "pos": [1000, 200]
+    },
+    {
+      "id": "6",
+      "type": "PlotParameters",
+      "title": "Visualize Parameters",
+      "category": "ComfyAssets/🧰 xyz-helpers",
+      "inputs": {
+        "sampler_params": ["3", "sampler_params"],
+        "plot_type": "bar",
+        "x_axis": "parameter_name",
+        "y_axis": "value",
+        "title": "Sampler Configuration Analysis",
+        "show_grid": true
+      },
+      "outputs": {
+        "plot_image": "IMAGE"
+      },
+      "pos": [700, 400]
+    },
+    {
+      "id": "7",
+      "type": "DisplayAny",
+      "title": "Show Schedule Curve",
+      "category": "ComfyAssets/🔍 Debug",
+      "inputs": {
+        "input": ["2", "schedule_curve"],
+        "mode": "tensor shape"
+      },
+      "pos": [400, 400]
+    },
+    {
+      "id": "8",
+      "type": "VAEDecode",
+      "title": "Decode Results",
+      "inputs": {
+        "samples": ["5", "latent"],
+        "vae": ["model", "vae"]
+      },
+      "outputs": {
+        "image": "IMAGE"
+      },
+      "pos": [1300, 200]
+    },
+    {
+      "id": "9",
+      "type": "KikoSaveImage",
+      "title": "Save Comparison",
+      "category": "ComfyAssets/💾 Images",
+      "inputs": {
+        "images": ["8", "image"],
+        "filename_prefix": "sampler_comparison",
+        "format": "WEBP",
+        "quality": 90,
+        "popup": true
+      },
+      "pos": [1600, 200]
+    }
+  ],
+  "workflow_notes": {
+    "purpose": "Compare and optimize sampler/scheduler combinations for best quality",
+    "features": [
+      "Automatic sampler selection based on model",
+      "Scheduler optimization with visualization",
+      "Parameter analysis and plotting",
+      "Batch generation for comparison"
+    ],
+    "tips": [
+      "Try different quality_preset values",
+      "Use visualize=true to see noise schedules",
+      "Compare results across multiple seeds"
+    ],
+    "attribution": "xyz_helpers nodes adapted from comfyui-essentials-nodes"
+  }
+}