ComfyUI Extension: SATA UtilityNode Node for ComfyUI
A collection of utility nodes including image upscale,touchpad support and CSV-driven prompt machine for ComfyUI.
Custom Nodes (0)
README
SATA Utility Node Suite for ComfyUI
Author: Satadal
Version: 1.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.
🧩 Node Features
🖼️ Upscale Machine
- 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.
💬 Prompt Machine
- 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.
🖱️ Touchpad Pan & Zoom
- 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.
📦 Installation
-
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.
📚 Node Inputs & Outputs
Upscale Machine
| Name | Type | Description |
|------------------|--------|--------------------------------------------------|
| image
| IMAGE | Input image tensor |
| upscale_model
| STRING | Model filename from upscale_models
folder |
| rescale_factor
| FLOAT | Scaling factor (aspect ratio preserved) |
| supersample
| STRING | "true"
or "false"
|
| rounding_modulus
| INT | Ensures dimensions are divisible by this value |
Outputs:
| Name | Type | Description |
|-------------|--------|------------------------------------|
| IMAGE
| IMAGE | The upscaled and resized image |
| show_help
| STRING | Link to documentation/help |
Prompt Machine
| Name | Type | Description |
|-------------|--------|------------------------------------|
| selection
| STRING | Prompt set name from CSV |
Outputs:
| Name | Type | Description |
|-------------|--------|------------------------------------|
| positive
| STRING | Positive prompt |
| negative
| STRING | Negative prompt |
Touchpad Pan & Zoom
- No node configuration required.
- Enables pan/zoom in the ComfyUI preview panel for large images.
📝 License
MIT License