SATA Utility Node Suite for ComfyUI

Author: Satadal
Version: 1.2.0
License: MIT
Repository: https://github.com/SatadalAI/SATA_UtilityNode

🚀 Overview

SATA Utility Node Suite is a collection of custom nodes for ComfyUI designed to enhance your image processing and workflow experience.
It includes:

Upscale Machine: High-quality model-based image upscaling with aspect-ratio preserving rescale.
Prompt Machine: Easy prompt selection from a CSV for positive/negative prompt workflows.
Touchpad Pan & Zoom: Seamless navigation for large images in the ComfyUI preview panel.
Resolution Machine: Quick selection of model-specific image resolutions for popular models.
Save Image w/Metadata: saving images with meta data and with different file formats.
Prompt Autocomplete: Text widget with autocompletion, random selection, and preview capabilities.

Model-based Upscaling: Uses custom or pre-trained models from the upscale_models folder.
Aspect Ratio Preserving Rescale: Output size is always original size × rescale factor.
CPU-based Rescaling: Efficient resizing using OpenCV.
Supersampling: Optional detail preservation for downscaling/fractional resizing.
Rounding Modulus: Ensures output dimensions align with model/UI constraints.
Dual Output: Returns both the processed image and a help/documentation link.

CSV-based Prompt Selection: Select prompt sets from a CSV file (prompts.csv).
Positive/Negative Output: Outputs both positive and negative prompts as strings.
Easy Integration: Designed for use in prompt-driven workflows.

Preview Navigation: Enables smooth pan and zoom for large images in the ComfyUI preview panel.
User Experience: Makes inspecting high-res outputs fast and intuitive.

Model-aware Resolution Selection: Choose from a list of recommended resolutions for each supported model.
Auto-populate Width/Height: Selecting a resolution automatically fills in the correct width and height.
Manual Override: You can manually set width/height, which clears the preset selection.
Supports Many Models: Includes presets for SD1.5, SDXL, Illustrious XL, Pony XL, Flux.1 Dev, Qwen-Image, Wan2.2-S2V, SD3.5 Large, Lumina-Image 2.0, and more.
UI Integration: Intuitive dropdowns for model and resolution selection in the ComfyUI interface.

Single path+filename input: Provide a single required path_and_filename string (examples: comfy, Test/comfy, SDXL/Test/comfy). The last path segment is used as the filename; preceding segments become folders under the ComfyUI output directory.
Supported formats: PNG, JPEG (saved as .jpg), WEBP (choose with the extension dropdown).
Automatic folder creation: Any missing folders in the provided path are created automatically.
Metadata embedding: PNG files receive tEXt entries (parameters/prompt). JPEG/WEBP receive EXIF UserComment where possible.
Placeholder resolution: Filenames and paths accept %...% placeholders which are resolved from the node's prompt dictionary (best-effort). Example: if prompt contains {"title": "MyTitle"}, using %title%/img will save under MyTitle/img.png.
Collision-safe saving: If a file already exists the node will append _0001, _0002, ... to the base filename to avoid overwriting.

Autocompletion: Type # (configurable) to trigger a popup with suggestions from CSV/JSON files in the prompt folder.
Random Selection: Select 🎲 Random to insert a random item from a category.
Preview: View full text of long snippets before inserting.
Global Mode: Optional setting to enable autocompletion on ALL text widgets in ComfyUI.
Custom Data: Add your own .csv or .json files to the prompt folder to extend the library.

Clone or download this repository into your ComfyUI custom_nodes directory:
```
git clone https://github.com/SatadalAI/SATA_UtilityNode.git
```
(Optional) Install dependencies if not already present:
```
pip install -r requirements.txt
```
Restart ComfyUI.

Settings:

Trigger Character: Change the character that opens the popup (default: #).
Global Mode: Enable autocompletion for all text widgets in ComfyUI (default: false).

MIT License