151 lines
4.4 KiB
Markdown
151 lines
4.4 KiB
Markdown
# ComfyUI Logic Support
|
|
|
|
A collection of logic and utility nodes for ComfyUI to enhance workflow capabilities.
|
|
|
|
Version: 0.4.0
|
|
|
|
[한국어 README](README_ko.md)
|
|
|
|
## Overview
|
|
|
|
ComfyUI Logic Support is a custom node extension that provides various logic and utility nodes to enhance your ComfyUI workflows. These nodes enable more complex conditional logic, string manipulation, and numerical operations.
|
|
|
|
|
|
|
|
## Installation
|
|
|
|
1. Clone this repository into your ComfyUI custom_nodes directory:
|
|
```bash
|
|
cd /path/to/ComfyUI/custom_nodes
|
|
git clone https://github.com/yourusername/Comfyui-Logic-Support.git
|
|
```
|
|
|
|
2. Restart ComfyUI or refresh the page if it's already running.
|
|
|
|
## Nodes
|
|
|
|
### NumberRangeIndex
|
|
|
|
Determines which range a number belongs to and returns the corresponding index.
|
|
|
|
- **Inputs**:
|
|
- `number`: The input number to check
|
|
- `base_type`: Range calculation method ("L <= n < R" or "L < n <= R")
|
|
- `value_1` to `value_15`: Boundary values for ranges
|
|
- `default_index`: Starting index for results (default: 0)
|
|
|
|
- **Outputs**:
|
|
- `INDEX`: The index of the range the number belongs to
|
|
|
|
### BooleanIndexAdder
|
|
|
|
Adds the index of the first true value among 15 boolean inputs to a base number.
|
|
|
|
- **Inputs**:
|
|
- `base_number`: The number to add the index to
|
|
- `bool1` to `bool15`: Boolean inputs
|
|
|
|
- **Outputs**:
|
|
- `NUMBER`: The result of adding the index to the base number
|
|
|
|
### NumberConditionChecker
|
|
|
|
Checks if a number is within specified bounds and returns a boolean result.
|
|
|
|
- **Inputs**:
|
|
- `lower_value`: Lower bound value
|
|
- `lower_op`: Lower bound operator ("NONE", "<", "<=")
|
|
- `number`: The number to check
|
|
- `upper_op`: Upper bound operator ("NONE", "<", "<=")
|
|
- `upper_value`: Upper bound value
|
|
|
|
- **Outputs**:
|
|
- `BOOLEAN`: True if the number satisfies all conditions, otherwise False
|
|
|
|
### StringConcatenator
|
|
|
|
Concatenates up to 15 input strings into a single output string with a specified separator.
|
|
|
|
- **Inputs**:
|
|
- `separator_type`: Type of separator ("EMPTY", "COMMA", "SPACE", "PIPE")
|
|
- `string1` to `string15`: Strings to concatenate
|
|
|
|
- **Outputs**:
|
|
- `STRING`: The concatenated string
|
|
|
|
### StringSwitchByNumber
|
|
|
|
Outputs a string based on a numeric index input, supporting up to 15 strings.
|
|
|
|
- **Inputs**:
|
|
- `number`: Index of the string to output (1-based)
|
|
- `string1` to `string15`: Available strings
|
|
|
|
- **Outputs**:
|
|
- `STRING`: The selected string
|
|
|
|
### NumberSequenceGenerator
|
|
|
|
Generates a sequence of numbers within a specified range, repeating each number a specified number of times. Maintains state between workflow executions.
|
|
|
|
- **Inputs**:
|
|
- `start_number`: Starting number of the sequence
|
|
- `end_number`: Ending number of the sequence
|
|
- `repeat_count`: Number of times to repeat each number
|
|
- `reset`: Whether to reset the sequence ("no" or "yes")
|
|
|
|
- **Outputs**:
|
|
- `NUMBER`: Current number in the sequence
|
|
|
|
- **Features**:
|
|
- State is maintained per workflow, allowing independent use in multiple workflows
|
|
- State persists across ComfyUI restarts (file-based state saving)
|
|
- State is maintained during repeated operations (multiple Run executions)
|
|
|
|
## Examples
|
|
|
|
### Using NumberRangeIndex for Conditional Processing
|
|
|
|
```
|
|
[Number Input: 15] → [NumberRangeIndex] → [Index determines further processing]
|
|
```
|
|
|
|
### Creating Dynamic Text with StringConcatenator
|
|
|
|
```
|
|
[Text Input 1: "Hello"] → [StringConcatenator: SPACE] → [Output: "Hello World"]
|
|
[Text Input 2: "World"] ↗
|
|
```
|
|
|
|
### Conditional Logic with BooleanIndexAdder
|
|
|
|
```
|
|
[Base Number: 10] → [BooleanIndexAdder] → [Output: 12]
|
|
[Boolean Input 1: False] ↗
|
|
[Boolean Input 2: True] ↗
|
|
```
|
|
|
|
### Sequential Number Generation with NumberSequenceGenerator
|
|
|
|
```
|
|
[NumberSequenceGenerator: start=1, end=3, repeat=2] → [Output sequence: 1,1,2,2,3,3,1,1,...]
|
|
```
|
|
|
|
## License
|
|
|
|
MIT License
|
|
|
|
## Contributing
|
|
|
|
Contributions are welcome! Please feel free to submit a Pull Request.
|
|
|
|
## Example Workflow
|
|
|
|
The repository includes an example workflow (`logic_support_example.json`) that demonstrates how to use the logic nodes to create dynamic text prompts based on numeric inputs like age. This workflow uses:
|
|
|
|
- `NumberRangeIndex` to determine age ranges
|
|
- `StringSwitchByNumber` to select appropriate text based on the age range
|
|
- `StringConcatenator` to combine multiple text elements into a final prompt
|
|
|
|
You can load this example in ComfyUI by using the "Load" button and selecting the `logic_support_example.json` file.
|