alphard/Endless-Nodes
1
0
Fork 0
mirror of https://github.com/tusharbhutt/Endless-Nodes.git synced 2026-03-21 20:42:12 -03:00
Code Issues Packages Projects Releases Wiki Activity

Update README.md

Browse Source 
README for new nodes
This commit is contained in:
tusharbhutt
2025-06-21 19:05:14 -06:00
committed by GitHub
parent 04a8027b46
commit 8dd96f7988
1 changed files with 96 additions and 204 deletions
Download Patch File Download Diff File Expand all files Collapse all files

300
README.md
View File

@@ -1,269 +1,173 @@
# Endless-Nodes
Some basic custom nodes for the ComfyUI user interface for Stable Diffusion. Features:
+ **True batch multiprompting capability for ComfyUI**
+ An image saver for images and JSON files to base folder, custom folders for one, or custom folders for both. Also allows for Python timestamping
+ Two aesthetic scoring models, one based on the same as AUTO1111, the other based on Image Reward
+ Converters for various numerical functions to the other (int, float, number) and to strings. Still in beta
+ Switches for text and numbers
+ Parameter collection nodes
+ Random prompt selectors
+ Image Analysis nodes for novelty and complexity
+ MORE TO COME
When using the [ComfyUI](https://github.com/comfyanonymous/ComfyUI) interface for [Stable Diffusion](https://github.com/Stability-AI/stablediffusion), I sometimes find that the standard nodes and the many, many, many custom nodes out there don't work the way I want them to, or how I think they do.
When using the [ComfyUI](https://github.com/comfyanonymous/ComfyUI) interface for AI art generation, I sometimes find that the standard nodes and the many custom nodes out there don't work the way I want them to, or how I think they should.
Rightly or wrongly, I am pretending to teach myself a bit of Python to get some nodes up and running to do what I'd like. Yes, I am using ChatGPT, and yes I am a glutton for punishment. There are no promises that these nodes will work for you or that I will maintain them. Feel free to do with them as you wish, according to the license model.
Rightly or wrongly, I am teaching myself a bit of Python to get some nodes up and running to do what I'd like. Yes, I am using ChatGPT, Copilot, Claude and others, and yes, I am a glutton for punishment. There are no promises that these nodes will work for you or that I will maintain them. Feel free to do with them as you wish, according to the license model.
**UPDATE: JUN 21, 2025**
**UPDATE: Aug 19 2024**
**Blew everything up and removed all the old nodes. Nodes with new coding have been uploaded and will be updated semi-frequently until mid-July 2025**
+ ***Fixed Image Saver node so it appears again**
## Installation Instructions
**UPDATE: Oct 16 2023**
It’s preferable to install from the ComfyUI Node Manager, but for direct installation, do this:
+ ***Added a node that allows for six float values to output to six different output slots**
**UPDATE: Oct 14, 2023**
+ ***REINSTATED the Aesthetic Scorers and provided instructions on how to add Clip to your system if you are having issues***
+ Added the Global Envoy, which allows you to add height, width, and steps to many modules. *** Currently not working ***: The steps include start, stop and when to cut over to refinement, if you want (either as discrete steps, or a percentage)
**UPDATE: Oct 8, 2023**
+ ***Added a standalone saver node. Fixed bug in this node and main node where image files were overwritten***
**UPDATE: Oct 7, 2023**
+ ***REMOVED THE AESTHETIC SCORERS, TOO MANY PEOPLE CAN'T GET CLIP LOADED. WILL REVISIT AFTER VACATION***
**UPDATE: Oct 4, 2023**
+ Squished the bugs in the numeric to numeric and string nodes. Special thanks to [chrisgoringe](https://github.com/chrisgoringe) for some vital insight into correcting messy commas in the tuples for the converter nodes, much appreciated!
+ Added nodes to convert from string to numeric values, with some basic error checking.
**UPDATE: Oct 3, 2023**
+ Added an Image Saver that can place JSON files ***in separate folders***
+ Added nodes to convert from one numeric type to another, and to string.
**UPDATE: Sep 24, 2023**
+ Took the node from https://github.com/ZaneA/ComfyUI-ImageReward that uses Image Reward and repurposed it
+ Took the node from https://github.com/strimmlarn that does aesthetic scoring and repurposed it
**UPDATE: Sep 20, 2023**
+ Added an eight-input number switch because I needed it
**UPDATE: Sep 18, 2023**
+ Added the Endless Nodes Parameterizer with Text_G and Text_L prompt box
+ Added the Parameterizer with a score for both pos/neg
+ Added the Parameterizer with a score for both pos/neg and Text_G and Text_L prompt box
+ Fixed some typos
**UPDATE: Sep 17, 2023**
+ Added the Endless Nodes Parameterizer
## Install and Requirements
Navigate to your /ComfyUI/custom_nodes/ folder
In Windows, you can then right-click to start a command prompt and type:
+ Navigate to your /ComfyUI/custom_nodes/ folder
+ In Windows, you can then right-click to start a command prompt and type:
`git clone https://github.com/tusharbhutt/Endless-Nodes`
You can also get the nodes via the [ComfyUI Manager](https://github.com/ltdrdata/ComfyUI-Manager)
If installed correctly, you should see an menu choice in the main ComfyUI menu that look like this:
**NOTE: Requires CLIP and Pytorch-Lightning for the Aesthetic Scorer and ImageReward for my take on the Image Reward node scorer. Also require colorama for error messages to console. I've added them in the requirement file but if it doesn't work, you will need to download manually**
Endless 🌊✨
## IF YOU HAVE ISSUES WITH CLIP....
with several submenus for you to select from.
Some people are reporting having issues with installing Clip from OpenAI, especially if using ComfyUI Manager. I can tell you in looking at the issues on OpenAI's GitHub, it's not an uncommon complaint. So, I started from scratch on a new PC that had no software on it other than Windows and tested to see if I could get CLIP installed. After some minor issues, I was able to get the Python module loaded and working. If I can do this, I'm sure you can as well, but it will take a bit of effort and you need to have some basic skill in installing software in Windows. For users of other platforms or if you installed the other Windows version, I'm assuming you have Python and GIT installed already, so the first few instructions will not apply, but the remainder could.
## Assistance Requests
This is what I did:
**TL;DR: Install GIT and Python, ensure the location of Python and Pip are in your PATH, and then use GIT to install Endless-Nodes**
- Installed the Windows standalone version of ComfyUI
- This will install a portable version of Python for you and add the Python folder to your Win
- Downloaded GIT from here: https://git-scm.com/download/win
- **IMPORTANT** This is where having the standalone version may trip you up: both the C:\ComfyUI\python_embeded\Scripts _and_ C:\ComfyUI\python_embeded\ folders need to be in the PATH section of your system variables (_not_ the user variables). If I recall only the former is added, so you will have to add the second one manually
![environ](./img/environ.png)
- If you do not know how to add environmental variables, [here's a link for you to read](https://www.howtogeek.com/787217/how-to-edit-environment-variables-on-windows-10-or-11/)
- If you do not have both folders added, the program will fail to find Pip and will not correctly install Clip
- Once you have added that PATH, go to the custom folder for Endless Nodes, open up a command prompt (right-click and choose "Command Prompt here") and type the following:
```python -m pip install -r requirements.txt```
- Note the '-m' and '-r' in the command! You should see a tonne of programs loading and then a success notice. Now Endless-Nodes should load properly
- If you did a GIT install of ComfyUI and the ComfyUI Manager fails you, using the command noted above should work for you too, or you may be able to drop the -m part
### What to do if installation fails
You can try to install Clip directly via the following commands (still within the Endless-Nodes folder):
```pip install ftfy regex tqdm
pip install git+https://github.com/openai/CLIP.git
```
If **_that_** does not work, then it likely some configuration on your machine is preventing the install. Ask me **nicely** for a specific module if you're looking for one and I'll see if I can separate it out for you. Your tone matters, I'm too old to pay attention to people who think I blew up their machines and I will be as short and presumptuous with you as you are with me. If that bothers you, some self-reflection may be in order.
I am not a programmer, nor do I care to be. I have a fulltime job that eats up 50-60 houts a week and I made these nodes for myself. I’ve tested the nodes on my system and uploaded them as they see to work. They may or may not work for you or on your system.
If you have issues, ask me **nicely** for help. Your tone matters; I'm too old and tired to pay attention to people who think I blew up their machines and I will be as short and presumptuous with you as you are with me. If how I react to you if you are difficult bothers you, some self-reflection is in order on your part. In simple terms: the world has too many self-important people, so stop adding to the list.
## Node List
### Batch Multiprompt Node for SD, SDXL, and FLUX
### NEW! Six Float Value Output
![fluxbatch](./img/batchprompts.png)
Allows you to connect six float values to any other float input. What is the use case here? It works well for allowing the same settings to be used for the base and refiner encoders or FreeU inputs
See the video!
![sample](./img/batchsample.gif)
![sixfloatout](./img/sixfloatout.png)
As far as I know, ComfyUI does not have native capability to allow for different prompts to be run within the *same* batch. I always found this to be a waste if you have a fast card with a lot of VRAM. With ComfyUI native, you can set the batch size to, say, create 56 images of the same prompt, or you can change the queue to have multiple runs of different prompts; if you have a fast card, this may not be an issue for you.
Also, there are some nodes that will create multiple prompts in batches, but the ones I looked at showed they were just doing what is essentially queue management and prompts were still being done only one at a time. This set of nodes will allow you to create as many prompts as your VRAM can hold and does them simultaneously. Nodes are available for SDx, SDXL, and Flux.
Try this out too: pair a node with an endless queue and use wildcards to make an endless random image generator.
![dynamicbatch](./img/dynamic.png)
**Nodes available:**
+ SD node for SD1.x and 2.x
+ SDXL node
+ Negative prompt node … yep, make your negative prompts go through simultaneously too
+ Flux node with built-in guidance scale
+ Prompt Counter node can show you the prompts that were run
Inputs:
+ CLIP
+ Prompts: enter up to 64 prompts at once, the node figures out how many you have. You can enter prompts directly or via multiline input node.
+ Print output to console
+ Maximum batch size (leave at zero to match your line input)
Output:
+ Conditioning: works with standard KSampler
+ Prompt List: For downstream node usage
+ Prompt Count: Counts how many prompts you had
The image below should have a Flux workflow built in, but if not, check out the workflows folder too. The image is set up for the Flux node, but all you have to do is swap out the Batch Flux node for the other variants in the Endless 🌊✨/BatchProcessing menu.
![fluxbatchworkflow](./img/fluxbatchworkflowembedded.png)
## Endless Image Saver
***UPDATED*** to allow the user to save JSON data to the image (default is OFF); the previous versions automatically saved the JSON data but if you have other nodes doing it, this is redundant. ***_Warning:_*** turning this off will not allow you to drag and drop an image into ComfyUI to rework it unless you had some other mechanism to save the JSON to metadata.
![imagesaver](./img/imagesaver.png)
This is why I tried my hand at Python in the first place! There are many, many, many, good image saver nodes out there, so why one more? Well:
This is why I tried my hand at Python in the first place! There are many good image saver nodes out there, so why one more? Well:
+ The default saver does not save to UNC in Windows, even if you try to put it in the extra paths YAML file
+ Some savers will allow you to save to UNC but have restricted built-in folder formats
+ You can cobble some savers to save an image together with a text file, but the timestamp on the text file tends to be 2-3 seconds off from the image
+ No saver I know of lets you save the JSON file to a **completely different folder**
So… this node will allow you to save your image file wherever you want, with full support for standard [Python date and time conventions](https://strftime.org/) and you can save the JSON file somewhere else.
So… this node will allow you to save your image file wherever you want, with full support for standard [Python date and time conventions](https://strftime.org/) and you can save the JSON file somewhere else. The feature list includes:
I have more plans for this, but it’s ready for release now.
![imagesaver](./img/imagesaverone.png)
Does it work... ?
+ Allows multiprompts to be saved as part fo the file name via the prompt_list input
+ Add timestamps in varying formats
+ image format for PNG, JPG, WEBP
+ Custom delimiter
+ Add set number of words from the positive prompt to the file name
+ Embed JSON metadata
+ Save separate JSON file
+ Filename number padding at start or end (placed *after* timestamp if timestamp is enabled)
+ Filename prefix
+ OS independent, UNC enabled custom JSON and Output folders, which can be separate from one another
+ Negative prompt list (**meh**, not sure if it really works yet)
Does it work...? You betcha!
![imagesaverfile](./img/imagesaverfile.png)
JSONs to the left of me, images to the right of me, and here I am stuck in the middle with you! It works!
** NOTE: this module is [available separately here](https://github.com/tusharbhutt/Endless-Nodes/blob/main/endless_nodes.py), just toss it in the ComfyUI custom_nodes folder if you don't want the remaining nodes
### A note on timestamp formats
*A note on timestamp formats*
This module uses the standard Python date and time stamp formats, it **_does not_** use the date and time format popular in the WAS Suite. See below for equivalency examples:
- WAS Suite would use: ```[time(%Y-%m-%d__%I-%M%p)]```
- Python standard is: ```%Y_%m_%d__%I-%M%p```
Note that there is no need to use "\[time(your string here)\]"
### Image Analysis Nodes
You can use these two node to see how novel or complex your images are. The Novelty Score node match your image against one or more reference images and computes how different your image is. The higher the score, the more novel your image is.
## Aesthetic Scorer
![noveltyscore](./img/novelty.png)
This node will output a predicted aesthetic score as a number and display it with the appropriate node (e.g., rgthree's ["Any"](https://github.com/rgthree/rgthree-comfy#display-any) node). I took the node from https://github.com/strimmlarn that does aesthetic scoring and repurposed it so that it is simpler and outputs the score as a number. I combined the model loader and score calculator into one, and removed the Aesthetic Score Sorter.
Similarly, the Complexity Score node indicate how complex an image is, with more complex images scoring higher. This is based on edge detection and other variances found in the image.
![aestheticone](./img/aestheticone.png)
![complexitycore](./img/complexity.png)
You can load a number of scoring models, I use the "chadscorer" model found here:
### Randomizer Nodes
https://github.com/grexzen/SD-Chad/blob/main/chadscorer.pth
There are two sets of nodes, for text selection and to randomize parameters.
As for the original node from strimmlarn, please refer to this GitHub if you would like to examine it:
**Text Randomizers**
https://github.com/strimmlarn/ComfyUI-Strimmlarns-Aesthetic-Score
These nodes will randomly select text from the input. There are two nodes, one that picks one line from the list, and one that selects *x* lines from the list. Useful for randomly picking prompts.
The scorer adds about 7-10 seconds to a workflow on my Nvidia 3060 12 GB card, your mileage may vary
![textrandom](./img/randomprompts.png)
## Image Reward
**Parameter Randomizers**
This node will output a predicted aesthetic score as a number and display it with the appropriate node (e.g., rgthree's ["Any"](https://github.com/rgthree/rgthree-comfy#display-any) node). I took the node from https://github.com/ZaneA/ComfyUI-ImageReward that in turn scores images using [ImageReward](https://github.com/THUDM/ImageReward). I combined the model loader and score calculator into one and added output nodes for both the standard deviation calculation (which is what Zane's node does) and the score on a scale of one to ten based on some simple statistic calculations.
There are two nodes: Endless Mayhem and Endless Chaos. Both allow you to randomly select parameters such as steps, CFG value, height, width, and the seed. The Chaos node will also randomly flip the height and width values on you, so the image moves from portrait to landscape, for example.
The difference between this node and the Aesthetics Scorer is that the underlying ImageReward is based on Reward Feedback Learning (ReFL) and uses 137K input samples that were scored by humans. It often scores much lower than the Aesthetics Scorer, but not always!
![random](./img/randomizers.png)
![imagereward](./img/imagereward.png)
### Text Input Switch
As with the Aesthetics Scorer, the Image Reward node adds about 7-10 seconds to a workflow on my Nvidia 3060 12 GB card, your mileage may vary.
Allows the user to select between four, six, and eight text inputs and uses a selector at top to make the selection. Useful for multiple inputs for prompt creation.
Note: you need a minimum of one input, the rest are optional.
For added GPU cycle time consumption, put them both in and watch how often they vehemently disagree with the scoring :)
![textswitch](./img/textswitch.png)
![disagree](./img/disagree.png)
### Integer Input Switch
As above, but for integers. There is also an Integer Input Switch Widget (not shown)
### Endless Node Parameterizer
![integerswitch](./img/integerswitch.png)
This node has a collection of inputs for the CLIP text Encoder and Refiners for SDXL based workflows
Inputs include:
- base width: set width for the base encoder
- base height: set height for the base encoder
- base cropped width: crop width for the base encoder
- base cropped height: crop height for the base encoder
- base target width: target width for the base encoder
- base target height: target height for the base encoder
- refiner width: crop width for the refiner if you have included one
- refiner height: crop height for the refiner if you have included one
- refiner aesthetic score: set the score value for the refiner
You can set up two of these one for the positive and one for the negative prompt
![parameterizer](./img/parameterizer.png)
## Parameterizer with prompt
As above, but with TEXT_G and TEXT_L outputs
![parameterizerprompt](./img/parameterizerprompt.png)
## COMBO Parameterizer with and without prompt
After making the Parameterizer, I realized having two separate ones for both the positive and negative CLIP encoders is not optimal, because almost everyone will use the same resolution for both the positive and negative base and refiners. However, you may (well, you *should…*) want separate aesthetic scorers for the positive and negative CLIPs, so I came up with one that does this for you. Also comes in a variant that has the prompt boxes for you.
![comboparameterizer](./img/comboparameterizer.png)
![comboparameterizerprompt](./img/comboparameterizerprompt.png)
### Six Text Input Switch
Allows the user to select between six text inputs and uses a slider to make the selection. Useful for multiple inputs for prompt creation
![sixtext](./img/sixtext.png)
**NOT SHOWN: There is an eight input variant now too, as of Sep 20, 2023**
### Six Integer Input to Six Integer Output
I've seen a fair number of 3-, 4-, or more X-way text input and outputs, I wanted to do something for numbers as well. Use it as you wish.
![sixintconnect](./img/sixintconnect.png)
### Six Integer Widget
As above, but with widgets for entry instead of connectors
![sixintwidget](./img/sixintwidget.png)
### Various converters
You've seen them elsewhere too, but there are few that do X to float or vice versa, so I threw them in. *Still in beta*, sometimes they work, other times the downstream node complains.
![converters](./img/converters.png)
### Nodes that don’t work (yet!)
I do have some nodes that are half-way done, but not ready for prime time. They’ll be uploaded when I get to them.
+ Image Aesthetic Scoring (Aesthetic values, NIMA, and BRISQUE methods)
+ Batch image loader
+ Multiple input/output converter
+ Additional image analysis nodes
## Usage License and Restrictions
See GPL Licensing V3 for usage. You may modify this code as long as you keep the credits for this repository and for those noted in the credit section below. **YOU ARE EXPRESSLY FORBIDDEN FROM USING THIS NODE TO CREATE ANY IMAGES OR ARTWORK THAT VIOLATES THE STABLE DIFFUSION USAGE NOTES [HERE](https://huggingface.co/stabilityai/stable-diffusion-2#misuse-malicious-use-and-out-of-scope-use) AND [HERE](https://huggingface.co/stabilityai/stable-diffusion-2#misuse-and-malicious-use).**
See GPL Licensing V3 for usage. You may modify this code as long as you keep the credits for this repository and for those noted in the credit section below. **YOU ARE EXPRESSLY FORBIDDEN FROM USING THESE NODES TO CREATE ANY IMAGES OR ARTWORK THAT VIOLATES THE STABLE DIFFUSION [ACCEPTABLE US POLICY] (https://stability.ai/use-policy) OR THE USAGE POLICY FROM [BLACK FOREST LABS]( https://bfl.ai/legal/usage-policy).**
For example, don't be a mouth-breather who creates fake celebrity nudes or sexual content of **anyone, even if you have their consent**. JUST. DON’T. BE. A. DICK/BITCH.
For example, don't be a mouth-breather who creates fake nudes or sexual content of **anyone, even if you have their consent**. JUST. DON’T. BE. AN. ASSHOLE.
The author expressly disclaims any liability for any images you create using these nodes.
@@ -273,19 +177,7 @@ These nodes may or may not be maintained. They work on my system but may not on
## Credits
+ [Comfyroll Custom Nodes](https://github.com/RockOfFire/ComfyUI_Comfyroll_CustomNode) for the overall node code layout, coding snippets, and inspiration for the text input and number switches.
+ Claude and ChatGPT for coding creation/assistance
+ Thanks to all the node creators out there, most who toil away with little or no appreciation
+ [WLSH Nodes](https://github.com/wallish77/wlsh_nodes) for some coding for the Integer Widget.
+ [ComfyUI](https://github.com/comfyanonymous/ComfyUI) Interface for the basic ideas of what nodes I wanted.
+ [ComfyUI-Strimmlarns-Aesthetic-Score](https://github.com/strimmlarn/ComfyUI-Strimmlarns-Aesthetic-Score) for the original coding for the Aesthetic Scorer. The original scorer, and therefore my derivative too, use the [MLP class code](https://github.com/christophschuhmann/improved-aesthetic-predictor) from Christoph Schuhmann
+ [Zane A's ComfyUI-ImageReward](https://github.com/ZaneA/ComfyUI-ImageReward) for the original coding for the Image Reward node. Zane's node in turn uses [ImageReward](https://github.com/THUDM/ImageReward)
+ [Mikey nodes](https://github.com/bash-j/mikey_nodes) to grab code snippet to pass scoring metadata to image
+ Took some base code from the [WAS save image node](https://github.com/WASasquatch/was-node-suite-comfyui) to repurpose it
+ Thanks to [chrisgoringe](https://github.com/chrisgoringe) for some vital insight into correcting messy commas in the tuples for the converter nodes, much appreciated!
#