ComfyUI Extension: ComfyUI_Selectors

Authored by ComfyAssets

Created

Updated

0 stars

A modern ComfyUI custom node package that provides essential UI controls for image generation workflows. These nodes allow you to centralize commonly shared parameters (scheduler, sampler, dimensions, seeds) and link them to multiple nodes in your workflow, eliminating redundancy while maintaining JSON metadata compatibility.

Custom Nodes (0)

    README

    ComfyUI Selectors

    CI

    Version 1.0

    A modern ComfyUI custom node package that provides essential UI controls for image generation workflows. These nodes allow you to centralize commonly shared parameters (scheduler, sampler, dimensions, seeds) and link them to multiple nodes in your workflow, eliminating redundancy while maintaining JSON metadata compatibility.

    Features

    • Sampler Selector: Choose from all current ComfyUI-supported sampling methods

      • Alt Text

    • Scheduler Selector: Select from all current ComfyUI-supported schedulers

      • Alt Text

    • Seed History: Generate, increment, or randomize seeds with advanced controls and history tracking

      • Alt Text

    • Width & Height Nodes: Individual dimension controls with preset support

    • Alt Text

    • Combined Width/Height Node: Dual dimension control with swap functionality and presets

    • Modern ComfyUI Standards: Follows 2024 ComfyUI development best practices

    • JSON Compatible: Maintains workflow JSON compatibility for sharing and version control

    Installation

    1. Navigate to your ComfyUI custom_nodes directory
    2. Clone this repository: 
      git clone https://github.com/ComfyAssets/ComfyUI_Selectors.git
    3. Restart ComfyUI
    4. The nodes will appear in the comfyassets/ category

    Available Nodes

    Sampling Nodes (comfyassets/Sampling)

    Sampler Selector

    • Function: Centralized sampler selection
    • Output: Sampler name for use in KSampler nodes
    • Supported Samplers: All current ComfyUI samplers including euler, dpmpp_2m, ddim, etc.

    Scheduler Selector

    • Function: Centralized scheduler selection
    • Output: Scheduler name for use in KSampler nodes
    • Supported Schedulers: normal, karras, exponential, sgm_uniform, simple, ddim_uniform, beta

    Generation Nodes (comfyassets/Generation)

    Seed History

    • Function: Advanced seed management with web-based controls and history tracking
    • Input:
      • seed: Base seed value (0-18446744073709551615)
    • Web UI Features:
      • Control Mode: Dropdown to set behavior after generation
        • Fixed: Keep seed unchanged
        • Increment: Add 1 to seed after each generation
        • Decrement: Subtract 1 from seed after each generation
        • Randomize: Generate new random seed after each generation
      • Seed History: Automatically tracks and displays the last 5 seeds used
      • One-Click Reuse: Click any seed in history to instantly load it
      • Generate New: Quick button to generate and apply a new seed based on control mode
      • Clear History: Reset the seed history cache
      • Persistent Storage: Both seed history and control mode persist across ComfyUI sessions
    • Output: Seed value for use in KSampler nodes

    Dimension Nodes (comfyassets/Dimensions)

    Width Node

    • Function: Image width selection with presets
    • Controls:
      • width: Custom width value (64-8192, step 8)
      • preset: Quick selection (custom, 512, 768, 1024, 1152, 1216, 1344, 1408, 1472, 1536)
    • Output: Width value for use in latent image nodes

    Height Node

    • Function: Image height selection with presets
    • Controls:
      • height: Custom height value (64-8192, step 8)
      • preset: Quick selection (custom, 512, 768, 1024, 1152, 1216, 1344, 1408, 1472, 1536)
    • Output: Height value for use in latent image nodes

    Width & Height Node

    • Function: Combined dimension control with advanced features
    • Controls:
      • width: Custom width value (64-8192, step 8)
      • height: Custom height value (64-8192, step 8)
      • preset: Common dimension presets (512x512, 768x512, 1024x768, etc.)
      • swap_dimensions: Toggle to swap width and height values
    • Outputs: Both width and height values
    • Presets Include: Square formats, landscape, portrait, and popular ratios

    Usage Examples

    Basic Workflow Setup

    1. Add a Sampler Selector node and choose your preferred sampler
    2. Add a Scheduler Selector node and choose your scheduler
    3. Add a Seed History node and set control mode
    4. Add a Width & Height Node and choose dimensions
    5. Connect outputs to your KSampler and latent image nodes

    Centralized Parameter Management

    • Use selector nodes to set parameters once
    • Connect outputs to multiple destination nodes
    • Change settings in one place to affect entire workflow
    • Maintain clean, organized node graphs

    Preset Workflows

    • Use dimension presets for quick setup of common aspect ratios
    • Use seed randomize mode for variation generation
    • Combine nodes for complex parameter linking scenarios

    Technical Details

    ComfyUI Compatibility

    • Built for ComfyUI 2024+ standards
    • Compatible with all current sampler and scheduler types
    • Maintains JSON workflow compatibility
    • Supports widget conversion and parameter linking

    Node Categories

    • comfyassets/Sampling: Sampler and scheduler selection
    • comfyassets/Generation: Seed and generation control
    • comfyassets/Dimensions: Width, height, and dimension control

    Output Types

    • Sampler/Scheduler: ComfyUI COMBO types with current options
    • Dimensions/Seeds: Standard INT types with proper validation
    • JSON Metadata: Maintains workflow sharing compatibility

    Development

    Setup

    1. Create virtual environment:

      python -m venv venv
source venv/bin/activate  # Linux/Mac
# or
venv\Scripts\activate     # Windows

    2. Install development dependencies:

      pip install -r requirements-dev.txt

    Testing

    The project includes comprehensive testing with mock ComfyUI environment:

    # Run all tests (recommended)
python run_tests.py

# Run individual pytest tests
pytest tests/unit/           # Unit tests
pytest tests/integration/    # Integration tests

# Check code formatting
black --check .
isort --check-only .
flake8 .

    Project Structure

    nodes/                   # ComfyUI node implementations
web/                     # Web UI components and extensions
├── seed_history.js     # Seed History UI
└── width_height_swap.js # Width/Height node swap functionality
tests/                   # Test suites with mock ComfyUI
├── mocks/              # Mock ComfyUI modules
├── unit/               # Unit tests
└── integration/        # Integration tests
run_tests.py            # Standalone test runner
requirements-dev.txt    # Development dependencies

    Contributing

    1. Follow ComfyUI development standards
    2. Use the provided test framework with mock ComfyUI environment
    3. Maintain backward compatibility
    4. Add tests for new functionality
    5. Update documentation
    6. Ensure all tests pass before submitting PRs

    Code Quality

    • Formatting: Black (88 character line limit)
    • Import sorting: isort
    • Linting: flake8
    • Testing: Custom test runner with comprehensive mock setup

    Version History

    Version 1.0 (Initial Release)

    • ✅ Sampler Selector with all current ComfyUI samplers
    • ✅ Scheduler Selector with all current ComfyUI schedulers
    • ✅ Seed History with advanced control modes (fixed/increment/decrement/randomize) and history UI
    • ✅ Width Node with preset support
    • ✅ Height Node with preset support
    • ✅ Combined Width & Height Node with swap functionality and dimension presets
    • ✅ Modern ComfyUI 2024 standards compliance
    • ✅ Full JSON workflow compatibility
    • ✅ Comprehensive documentation and testing

    License

    This project is licensed under the MIT License - see the LICENSE file for details.