Update readme.md
This commit is contained in:
@@ -3,111 +3,131 @@ I have placed an example workflow for you to see how to connect it. Simple stuff
|
||||
|
||||

|
||||
|
||||
The Boyo Empty Latent node lets you supply the width then you just choose you aspect ratio and the node calcs the height for you. This is obviously model dependant. If the model does not support your resolution choice then the image will be garbage.
|
||||
|
||||
The Boyo Paired Saver node is designed for batch workflows where you're generating images from enhanced prompts. It saves both the generated image and the enhanced prompt text with matching sequential filenames (e.g., `prompt001.png` and `prompt001.txt`). Perfect for workflows using prompt injectors with Ollama enhancement - you can keep track of which enhanced prompt generated which image. Just connect your image output and enhanced prompt text, set a folder name and filename prefix, and it handles the rest. Files are saved in ComfyUI's output directory in your specified subfolder.
|
||||
|
||||
The Boyo Empty Latent node lets you supply the width then you just choose you aspect ratio and the node calcs the height for you. This is obviously model dependant. If the model does not support your resolution choice then the image will be garbage.
|
||||
The Image Saver node is WIP and this is just the first iteration. A path must be supplied for this to work but essentially you can save your files outside of the comfy environment. The second iteration will do loads of cool things so keep your eyes open for the updates.
|
||||
|
||||
The load image list lets you take images from a folder and then mass resize pad or crop for input into your workflow. I use this as an example of SD Upscaler where I resize all images prior to feeding into the upscaler workflow. I plop like 400 images in a folder then run the workflow and go to bed. Wake up all done.
|
||||
|
||||
Table of Contents
|
||||
|
||||
Installation
|
||||
MandelbrotVideoNode
|
||||
Overview
|
||||
Inputs
|
||||
Outputs
|
||||
Usage
|
||||
Troubleshooting
|
||||
|
||||
|
||||
Contributing
|
||||
License
|
||||
- Installation
|
||||
- MandelbrotVideoNode
|
||||
- Overview
|
||||
- Inputs
|
||||
- Outputs
|
||||
- Usage
|
||||
- Troubleshooting
|
||||
- Boyo Paired Saver
|
||||
- Overview
|
||||
- Inputs
|
||||
- Usage
|
||||
- Contributing
|
||||
- License
|
||||
|
||||
Installation
|
||||
Just plop this folder in custom nodes and then restart comfy. Most nodes (VAE, Boyo Empty Latent, Image Saver, Load Image List) have no install requirements other than ComfyUI itself. The MandelbrotVideoNode needs some extra stuff to work:
|
||||
Just plop this folder in custom nodes and then restart comfy. Most nodes (VAE, Boyo Empty Latent, Image Saver, Load Image List, Boyo Paired Saver) have no install requirements other than ComfyUI itself. The MandelbrotVideoNode needs some extra stuff to work:
|
||||
|
||||
Clone the Repository:git clone https://github.com/DragonDiffusionbyBoyo/Boyonodes.git
|
||||
|
||||
|
||||
Move to ComfyUI Custom Nodes:cp -r Boyonodes /path/to/ComfyUI/custom_nodes/
|
||||
Clone the Repository:
|
||||
```bash
|
||||
git clone https://github.com/DragonDiffusionbyBoyo/Boyonodes.git
|
||||
```
|
||||
|
||||
Move to ComfyUI Custom Nodes:
|
||||
```bash
|
||||
cp -r Boyonodes /path/to/ComfyUI/custom_nodes/
|
||||
```
|
||||
Typically, this is ComfyUI/custom_nodes/.
|
||||
Install Dependencies for MandelbrotVideoNode:
|
||||
Ensure you have Python 3.8+ and ComfyUI installed.
|
||||
Install required Python packages:pip install numpy==1.26 matplotlib pillow tqdm torch
|
||||
|
||||
Install Dependencies for MandelbrotVideoNode:
|
||||
- Ensure you have Python 3.8+ and ComfyUI installed.
|
||||
- Install required Python packages:
|
||||
```bash
|
||||
pip install numpy==1.26 matplotlib pillow tqdm torch
|
||||
```
|
||||
|
||||
Install ffmpeg for video output:
|
||||
On Windows: Download from ffmpeg.org or use choco install ffmpeg.
|
||||
On macOS: brew install ffmpeg
|
||||
On Linux: sudo apt-get install ffmpeg (Ubuntu/Debian) or equivalent.
|
||||
|
||||
|
||||
|
||||
- On Windows: Download from ffmpeg.org or use `choco install ffmpeg`.
|
||||
- On macOS: `brew install ffmpeg`
|
||||
- On Linux: `sudo apt-get install ffmpeg` (Ubuntu/Debian) or equivalent.
|
||||
|
||||
Restart ComfyUI:
|
||||
Launch or restart ComfyUI to load the nodes.
|
||||
|
||||
|
||||
|
||||
MandelbrotVideoNode
|
||||
Overview
|
||||
## MandelbrotVideoNode
|
||||
### Overview
|
||||
This node spits out random Mandelbrot or Julia set images or videos, perfect for trippy art projects in your ComfyUI workflow. Every time you run it, you get a fresh, wild fractal pattern. Check the Installation section for the stuff you need to make it work.
|
||||
Inputs
|
||||
|
||||
resolution: Pick your size:
|
||||
square (512x512)
|
||||
widescreen (720x480)
|
||||
vertical (480x836)
|
||||
### Inputs
|
||||
- **resolution**: Pick your size:
|
||||
- square (512x512)
|
||||
- widescreen (720x480)
|
||||
- vertical (480x836)
|
||||
- **output_type**: What you want out:
|
||||
- video: Gets you an MP4.
|
||||
- frames: Gives you a stack of images to play with.
|
||||
- **grayscale**: Check this for black-and-white vibes (default: off).
|
||||
|
||||
### Outputs
|
||||
- **frames**: A tensor of images (RGB, shape like (batch, height, width, 3)). Empty if you chose video.
|
||||
- **video_path**: Where the MP4 or frame folder lives.
|
||||
|
||||
output_type: What you want out:
|
||||
video: Gets you an MP4.
|
||||
frames: Gives you a stack of images to play with.
|
||||
### Usage
|
||||
1. Find Boyo Mandelbrot Generator in ComfyUI and drop it in your workflow.
|
||||
2. Set your resolution and output type:
|
||||
- Want frames? Pick frames and connect to SaveImage or VHS_VideoCombine.
|
||||
- Want a video? Pick video for a quick MP4.
|
||||
- Grayscale? Flip it on for that retro look.
|
||||
3. Run it. You'll get a new fractal every time.
|
||||
4. Frames land in ComfyUI/output/mandelbrot_frames/, videos as mandelbrot_XXXX.mp4 in ComfyUI/output/.
|
||||
|
||||
### Troubleshooting
|
||||
- **Error: "Frame output directory not found"**:
|
||||
- Make sure mandelbrot_video.py and mandelbrot_generator.py are in the Boyonodes folder.
|
||||
- Check you can write to ComfyUI/output/.
|
||||
- **Error: "Cannot handle this data type"**:
|
||||
- Peek at mandelbrot_frames/ and ensure images match your resolution (e.g., 512x512 for square).
|
||||
- Console will show tensor shapes—should be (batch, height, width, 3).
|
||||
- **No output**:
|
||||
- Run `ffmpeg -version` to confirm it's installed.
|
||||
- Check ComfyUI console for errors.
|
||||
- **Same fractal every time**:
|
||||
- It's built to be random. If it's not, look for a fixed random.seed() in mandelbrot_video.py.
|
||||
|
||||
grayscale: Check this for black-and-white vibes (default: off).
|
||||
## Boyo Paired Saver
|
||||
### Overview
|
||||
This node is perfect for batch workflows where you're using prompt injectors with text enhancement (like Ollama). It saves your generated image and the enhanced prompt text with matching sequential filenames, so you can always see which enhanced prompt created which image. Brilliant for keeping track of your workflow outputs when you're churning through hundreds of prompts.
|
||||
|
||||
Outputs
|
||||
### Inputs
|
||||
- **image**: The generated image from your workflow
|
||||
- **enhanced_prompt**: The enhanced/extended prompt text (usually from Ollama or similar)
|
||||
- **folder_name**: Name of the subfolder in ComfyUI's output directory (e.g., "batch_output")
|
||||
- **filename_prefix**: Prefix for your files (e.g., "enhanced_prompts")
|
||||
|
||||
frames: A tensor of images (RGB, shape like (batch, height, width, 3)). Empty if you chose video.
|
||||
video_path: Where the MP4 or frame folder lives.
|
||||
### Usage
|
||||
1. Drop the Boyo Paired Saver node into your workflow
|
||||
2. Connect your image generation output to the "image" input
|
||||
3. Connect your enhanced prompt text (from Ollama, etc.) to the "enhanced_prompt" input
|
||||
4. Set your folder name - this becomes a subfolder in ComfyUI/output/
|
||||
5. Set your filename prefix - this becomes the start of your filenames
|
||||
6. Run your workflow
|
||||
|
||||
Usage
|
||||
Files get saved as:
|
||||
- `ComfyUI/output/your_folder_name/your_prefix001.png`
|
||||
- `ComfyUI/output/your_folder_name/your_prefix001.txt`
|
||||
- `ComfyUI/output/your_folder_name/your_prefix002.png`
|
||||
- `ComfyUI/output/your_folder_name/your_prefix002.txt`
|
||||
- And so on...
|
||||
|
||||
Find Boyo Mandelbrot Generator in ComfyUI and drop it in your workflow.
|
||||
Set your resolution and output type:
|
||||
Want frames? Pick frames and connect to SaveImage or VHS_VideoCombine.
|
||||
Want a video? Pick video for a quick MP4.
|
||||
Grayscale? Flip it on for that retro look.
|
||||
|
||||
|
||||
Run it. You’ll get a new fractal every time.
|
||||
Frames land in ComfyUI/output/mandelbrot_frames/, videos as mandelbrot_XXXX.mp4 in ComfyUI/output/.
|
||||
|
||||
Troubleshooting
|
||||
|
||||
Error: "Frame output directory not found":
|
||||
Make sure mandelbrot_video.py and mandelbrot_generator.py are in the Boyonodes folder.
|
||||
Check you can write to ComfyUI/output/.
|
||||
|
||||
|
||||
Error: "Cannot handle this data type":
|
||||
Peek at mandelbrot_frames/ and ensure images match your resolution (e.g., 512x512 for square).
|
||||
Console will show tensor shapes—should be (batch, height, width, 3).
|
||||
|
||||
|
||||
No output:
|
||||
Run ffmpeg -version to confirm it’s installed.
|
||||
Check ComfyUI console for errors.
|
||||
|
||||
|
||||
Same fractal every time:
|
||||
It’s built to be random. If it’s not, look for a fixed random.seed() in mandelbrot_video.py.
|
||||
The node automatically handles sequential numbering and continues from where it left off if you run multiple batches.
|
||||
|
||||
If you ask me technical stuff I am likely to ask you to ask me one on sport as I vibe coded this.
|
||||
|
||||
Contributing
|
||||
Got ideas? Fork the repo, make a branch (git checkout -b cool-new-thing), commit your stuff (git commit -m "Added cool thing"), push it (git push origin cool-new-thing), and open a pull request. Add some docs for your changes, and we’re golden.
|
||||
Got ideas? Fork the repo, make a branch (`git checkout -b cool-new-thing`), commit your stuff (`git commit -m "Added cool thing"`), push it (`git push origin cool-new-thing`), and open a pull request. Add some docs for your changes, and we're golden.
|
||||
|
||||
License
|
||||
MIT License. Check the LICENSE file for the nitty-gritty.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user