ComfyUI Extension: HouseKeeper

Authored by joanna910225

Created

Updated

14 stars

A tool that organizes workflow nodes into clean, user-friendly layouts

Custom Nodes (0)

    README

    <div align="center">

    <img src="icons/housekeeper.svg" alt="Housekeeper" height="32"> comfyui-housekeeper

    ComfyUI Node Alignment & Color Tool

    </div>

    A ComfyUI custom node that provides comprehensive node alignment tools and color management for organizing your workflows.

    <div align="center"> <img src="doc/screenshot.png" alt="Housekeeper Panel" height="400"> </div>

    Demo

    <div align="center">

    Node Alignment

    <img src="doc/alignment.gif" alt="Node Alignment Demo" width="600">

    Size Alignment

    <img src="doc/size-alignment.gif" alt="Size Alignment Demo" width="600">

    Color Management

    <img src="doc/color.gif" alt="Color Management Demo" width="600"> </div>

    Features

    • 14 alignment options including edge and center alignments
    • Size normalization for consistent node dimensions
    • Flow-based arrangement using workflow connections
    • Preset color palettes for node styling
    • Custom color picker with recent colors memory
    • Hover preview showing alignment results before applying

    Installation

    Navigate to your ComfyUI custom nodes directory and clone:

    cd ComfyUI/custom_nodes/
    git clone https://github.com/joanna910225/comfyui-housekeeper.git
    

    Restart ComfyUI to load the custom node.

    Usage

    <img src="doc/handler.png" alt="Housekeeper Handler" height="200">

    The Housekeeper handle appears on the right side of the canvas after installation. Click to open the panel. Select 2 or more nodes to use alignment features.

    Basic Alignment

    Edge Alignment:

    • Left: Align all nodes to the leftmost edge with vertical spacing
    • Right: Align all nodes to the rightmost edge with vertical spacing
    • Top: Align all nodes to the topmost edge with horizontal spacing
    • Bottom: Align all nodes to the bottommost edge with horizontal spacing

    Center Alignment:

    • Height-Center: Align horizontal centers on a vertical line with vertical spacing
    • Width-Center: Align vertical centers on a horizontal line with horizontal spacing

    Size Adjustment

    Match node dimensions for consistent layouts:

    • Width-Max: Set all nodes to the widest width
    • Width-Min: Set all nodes to the narrowest width
    • Height-Max: Set all nodes to the tallest height
    • Height-Min: Set all nodes to the shortest height
    • Size-Max: Set all nodes to the largest dimensions (width × height)
    • Size-Min: Shrink each node to its minimum accepted size

    Flow Alignment

    Arrange nodes based on workflow connections:

    • H-Flow: Arrange nodes left-to-right in columns by workflow dependencies
    • V-Flow: Arrange nodes top-to-bottom in rows by workflow dependencies

    Preset Palettes

    Browse curated color sets with arrow navigation. Click any color chip to apply it to all selected nodes.

    Custom Colors

    Pick any color using the color picker or enter hex codes. Click the checkmark to apply.

    Recent Colors

    The panel automatically remembers your last used colors for quick access.