ComfyUI_Soze

Quality-of-life custom nodes for ComfyUI: batch processing helpers, CSV-driven prompt iteration, file/folder loaders, string and JSON utilities, and integrations for ComfyDeploy, FAL, ElevenLabs, and Azure Blob Storage.

Originally bundled the now-abandoned Comfy_KepListStuff helpers.

Install

Clone into ComfyUI/custom_nodes/:

cd ComfyUI/custom_nodes
git clone https://github.com/SozeInc/ComfyUI_Soze.git
pip install -r ComfyUI_Soze/requirements.txt

Or install via Comfy Registry / ComfyUI Manager.

Configuration

Some nodes need credentials in environment variables (or a .env file in the repo root):

| Variable | Used by | |---|---| | CD_API_KEY | ComfyDeploy nodes | | ELEVENLABS_API_KEY | ElevenLabs voice retriever | | SOZE_AZURE_STORAGE_CONNECTION_STRING | ComfyDeploy image parameter upload | | FAL_KEY (or [API] FAL_KEY in config.ini) | FAL nodes (e.g. Veo3.1) |

The repo's .gitignore excludes .env and config.ini. Never commit credentials. If you suspect a key has leaked, rotate it.

Node groups

• CSV — CSV Reader, CSV Reader X Checkpoint, CSV Reader X Lora, CSV Writer. The X Checkpoint/X Lora variants iterate index across rows × models, so a single counter walks every (row, checkpoint) pair.
• Files / folders — Load Files From Folder, Load Files With Pattern, File Loader, Does File Exist, Save Image With Absolute Filename, Save Text File To Output, Append To Text File.
• Images — Load Image, Load Images From Folder, Load Images From Folder X Lora, Load Image From URL, Load Image From Filepath, Image Batch Process Switch, Image Overlay, Empty Images, Variable Image Builder, Shrink Image, Pad Mask, Get Most Common Image Colors, Multi Image Batch, Soze Image Size With Maximum.
• Video — Append To Video (ffmpeg concat with audio), Load Videos From Folder.
• Strings — Multiline Concatenate, Multi Find And Replace, Special Character Replacer, Text Contains, String Functions, String Splitter, Empty String Replacement, Prompt Cache, Output Filename.
• JSON — JSON Value Parser, JSON Path Extractor, JSON Array Iterator, JSON File Loader, JSON Formatter, JSON Get Array Count, Create Image Batch From JSON Array, Load Images From JSONArray.
• Range / XY — Int/Float Range (Step), Int/Float Range (Num Steps), XY Any, XY Image.
• Converters — Int/Float/Bool/String cross-conversion nodes, Boolean Inverter.
• Loaders — Lora File Loader (load by absolute path), Checkpoint File Loader (load by absolute path).
• Integrations — ComfyDeploy API queue / cache / download nodes, ElevenLabs voice retriever, FAL Veo3.1 ref-img-to-video.

ffmpeg

Append To Video shells out to ffmpeg; it must be on PATH.

Contributing

Issues and PRs welcome. All respect to the original creators of any subsumed nodes — happy to upstream changes if you'd prefer them in your repo.

License

MIT — see LICENSE.