PortraitUtils is a focused collection of ComfyUI nodes designed for pipelines using real potographic images of people, where image sizes are not standardized as they are in text-to-image generation. The suite streamlines prep work such as cropping, resolution targeting, metadata management, and side-by-side QA so you can concentrate on creative iteration instead of utility wiring. These nodes should work well on any type of image, but some of them are designed for and tested on images of humans, particularly the smart cropping nodes.

Node Index

Each entry links to a short, task-oriented reference page (coming soon) for deeper usage notes and parameter breakdowns.

Image Adjustments & Preparation

AutoAdjustNode - One-click levels, tone, and color balancing. Docs
AutoWBColorMatch - White-balances and colour matches against a reference image using several algorithms. Docs
AutoColorConfigNode - Lightweight toggle bundle for sharing Auto Adjust presets. Docs
FluxResolutionPrepare - Crops and resizes to the nearest Flux-friendly resolution, with optional pre-upscale. Docs
ImageMegapixelSelector - Chooses image sizes by target megapixels to match downstream model limits. Docs

Cropping, Framing, and Stitching

AutoCropBorders - Removes uniform borders using adaptive fuzzy detection. GPU acceleration is currently broken, so leave that off for now. Docs
CropImageByMargins - Manual margin-based cropper for RGB images. Docs
CropMaskByMargins - Margin cropper designed for MASK tensors. Docs
FitAspectHeadSafe - Rescales and pads while preserving face-safe regions for portrait framing. Docs
MQBBoxMin - Utility for merging bounding boxes while enforcing minimum sizes. Docs
StitchByMask - Composites foreground and background images using mask-driven blending. Docs

Prompting & Workflow Configuration

MultiPromptNode - Cycles through prompt variants with per-slot weights. Docs
WorkflowConfig - Centralized key/value store for workflow-wide settings. Docs
OutpaintConfigNode - Packs outpainting preferences (steps, padding, sampler choices). Docs
OutpaintPaddingComputeNode - Calculates padding offsets to feed outpaint chains as either percentage or absolute pixels, with gravity. Docs

I/O & Utility Helpers

LoadImageCombined - Hybrid single/batch image loader with auto-advance support. Docs
PairedImageLoader - Loads synchronized source/output pairs for A/B comparison workflows. Docs
ComparisonGate - Gates comparison outputs until two populated images are available. Docs
FilenameAppendSuffix - Adds suffixes to filenames while respecting multi-extension cases. Docs
GpuSyncCacheClear - Forces a CUDA sync and empties selected caches to avoid VRAM buildup. Docs
SeedVR2Prep - Convenience helper for SeedVR2/VRAM-heavy pipelines (cache priming & cleanup). Docs

License

This project is released under the MIT License.