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 + AutoColorConfigNode - Global tone balancing with reusable toggle bundles. Docs
AutoWBColorMatch - White-balances and colour matches against a reference image using several algorithms. 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 + CropMaskByMargins - Aligned margin croppers for RGB images and masks. Docs
FitAspectHeadSafe + MQBBoxMin - Subject-aware boxing with headroom-aware aspect fitting. 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 + OutpaintPaddingComputeNode - Preference capture plus per-edge padding conversion. 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
SimpleImageSaver - Minimal saver with PNG/JPG, metadata toggle, and filename suffix controls. 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.