Files
2025-08-27 13:04:29 -07:00

74 lines
2.6 KiB
Markdown

# ComfyUI-Utilitools
A collection of utility nodes for ComfyUI that I find handy. Nothing fancy, just stuff that makes workflows a bit easier when you need simple operations.
## What's in here?
These aren't the most sophisticated nodes out there, but they get the job done for basic operations:
### 🧮 Math Nodes
- **Add, Subtract, Multiply, Divide** - Basic math with both int and float outputs
- **Calculator** - Safely evaluate simple math expressions like "2 + 2 * 3"
### 📝 Text Utilities
- **Text Concatenation** - Join two strings with optional separator
- **String Replace** - Find and replace text with optional count limit
### 🔄 Type Conversions
- **Float to Int / Int to Float** - Convert between number types
- **Whatever To String** - Convert any value (int, float, string) to string
### 🤔 Logic & Control
- **If Then Else** - Branch workflows based on boolean conditions
- **Switch** - Select from up to 8 inputs by index
- **Boolean Gates** - AND, OR, NOT operations
### 📋 Data Manipulation
- **Create List** - Make lists from up to 8 items
- **List Index** - Get item from list by index
- **Batch Controller** - Adjust tensor batch sizes
### ⚙️ Workflow Helpers
- **Passthrough** - For workflow organization (does nothing, just passes data through)
- **Counter** - Increment/decrement with optional reset
- **Date Timestamp** - Generate formatted date/time strings with toggles for components
- **Constants** - Int, Float, and String constant value nodes
### 🖼️ Image Utilities
- **Image Dimensions** - Get width, height, and batch size from images
- **Aspect Ratio** - Calculate ratio as decimal and simplified fraction (like "16:9")
## Installation
Just drop this folder into your ComfyUI `custom_nodes` directory and restart ComfyUI. That's it.
```
ComfyUI/custom_nodes/ComfyUI-Utilitools/
```
## Notes
- All nodes are organized under "Utilitools" categories in the node browser
- Most math operations work with both int and float inputs
- The calculator node only accepts basic math expressions for safety
- These are utility nodes I made for myself - they're useful but not groundbreaking
## Structure
The code is organized by category for easier maintenance:
```
nodes/
├── math.py # Arithmetic operations
├── text.py # Text processing
├── conversion.py # Type conversions
├── logic.py # Conditional logic
├── data.py # Lists and batching
├── workflow.py # Workflow helpers
├── constants.py # Constant values
├── image.py # Image utilities
└── main.py # Central registry
```
Feel free to use, modify, or ignore as needed!