```markdown
<p align="center"> <a href="https://github.com/Eagle-CN/ComfyUI-Addoor" target="blank"> <img src="https://i.ibb.co/6nJzL9n/1.png" alt="Logo" width="156" height="156"> </a> <h2 align="center" style="font-weight: 600">ComfyUI-Addoor</h2> <p align="center"> Powerful plugin for ComfyUI <br /> <a href="https://github.com/Eagle-CN/ComfyUI-Addoor" target="blank"><strong>📘 Explore the docs</strong></a> | <a href="#%EF%B8%8F-installation" target="blank"><strong>📦️ Installation</strong></a> | <a href="https://github.com/Eagle-CN/ComfyUI-Addoor/issues" target="blank"><strong>🐛 Report Bug</strong></a> <br /> <br /> </p> </p>✨ Features
- 🔄 CSV reading and processing
- 📁 Batch image loading and file operations
- 🗜️ ZIP file creation
- 💾 Image and text saving
- 🧮 Training step calculation
- 🔄 Prompt replacement and styling
- 🌐 Hugging Face model downloading
- 🎨 Image color filtering
- 📊 Text to CSV conversion
- ...and more features in development!
📦️ Installation
- Make sure you have ComfyUI installed.
- Clone this repository into the
custom_nodes
directory of ComfyUI:
```sh cd ComfyUI/custom_nodes git clone https://github.com/Eagle-CN/ComfyUI-Addoor.git ```
- Install the dependencies:
```sh cd ComfyUI-Addoor pip install -r requirements.txt ```
- Restart ComfyUI, and the ComfyUI-Addoor nodes will appear in the node list.
- For Chinese localization:
- Download the
addoor_zh.json
file. - Place it in the
/ComfyUI/custom_nodes/AIGODLIKE-COMFYUI-TRANSLATION/zh-CN/Nodes
directory. - Restart ComfyUI.
🚀 Usage
ComfyUI-Addoor adds several new nodes to ComfyUI, each with specific functionality:
- CSV Reader: Read and process CSV files.
- Batch Image Load: Load images in batch from a specified directory.
- Text List To String: Convert a list of text files to a string.
- Any File List: List files in a directory with various filtering options.
- Zip Save: Create ZIP archive files.
- Image Saver: Save images to a specified directory.
- Flux Train Step Math: Calculate training steps for machine learning models.
- Text Saver: Save text content to a file.
- Prompt Replace: Replace specific content in text.
- Hugging Face Download: Download models or datasets from Hugging Face.
- Image Color Filter: Apply various color adjustments and filter effects.
- CSV Prompt Styler: Style prompts using styles from a CSV file.
- Txt To CSV Combiner: Combine multiple text files into a single CSV file.
Each node can be found in the ComfyUI interface and can be connected with other nodes to create complex workflows.
📘 Node Descriptions and Usage Notes
- CSV Reader (AD_CSVReader)
- Description: Reads CSV files and outputs their content.
- Note: Supports selecting specific columns and random row selection.
- Batch Image Load (AD_BatchImageLoadFromDir)
- Description: Loads multiple images from a specified directory.
- Note: Supports various image formats including jpg, jpeg, png, bmp, gif, and webp.
- Text List To String (AD_TextListToString)
- Description: Loads text files and combines their contents.
- Note: Supports txt and csv files.
- Any File List (AD_AnyFileList)
- Description: Lists files in a directory with various filtering options.
- Note: Useful for file management and content extraction.
- Zip Save (AD_ZipSave)
- Description: Creates a zip archive of a specified directory.
- Note: Useful for backing up or sharing multiple files at once.
- Image Saver (AD_ImageSaver)
- Description: Saves images to a specified directory with customizable naming.
- Note: Supports metadata saving and automatic file numbering.
- Flux Train Step Math (AD_FluxTrainStepMath)
- Description: Calculates training steps for machine learning models.
- Note: Useful for planning and optimizing training processes.
- Text Saver (AD_TextSaver)
- Description: Saves text content to a file with customizable naming and formatting.
- Note: Supports time-based tokens in directory and filename prefix.
-
Prompt Replace (AD_PromptReplace)
- Description: Replaces text in a prompt based on specified criteria and random selection.
- Note: Useful for creating variations in prompts or text content with controlled randomness.
-
Hugging Face Download (AD_HFDownload)
- Description: Downloads models or datasets from Hugging Face.
- Note: Supports using mirror sites and authentication.
- Image Color Filter (AD_ImageColorFilter)
- Description: Applies various color adjustments and filter effects to images.
- Note: Provides comprehensive image color and quality adjustment capabilities.
- CSV Prompt Styler (AD_CSVPromptStyler)
- Description: Styles prompts using styles defined in a CSV file.
- Note: Allows easy application of predefined prompt styles.
- Txt To CSV Combiner (AD_TxtToCSVCombiner)
- Description: Combines multiple text files into a single CSV file.
- Note: Supports file sorting and optional header addition.
🤝 Contributing
Contributions, issues, and feature requests are welcome! Please check our Contributing Guide for more information.
📜 License
This project is licensed under the MIT License. See the LICENSE file for details.
🙏 Acknowledgements
- Thanks to the ComfyUI team for creating such a powerful framework.
- Thanks to all the developers who have contributed to this project. ```