WASasquatch/was-node-suite-comfyui

WAS-NS v3 Reborn; Tools for image processing, filters, masking, text, logic, numbers, latents, files, 3D scenes, and animation.

What is WAS Node Suite v3?

WAS Node Suite (WAS‑NS) is a collection of custom nodes for ComfyUI, the visual workflow tool used to build and run Stable Diffusion‑style image generation pipelines. The suite adds 532 ready‑to‑use nodes that cover a huge range of tasks – image filtering, colour correction, masking, text handling, logic flow, file I/O, animation, video, and even a few model‑related helpers. In short, it turns ComfyUI into a full‑featured graphics‑processing toolbox without you having to write any Python code.

Who might use it?

Artists & creators who build image‑to‑image or text‑to‑image workflows in ComfyUI and want more out‑of‑the‑box operations (e.g., face detection, gradient maps, video frame interpolation).
Educators & hobbyists who need a large library of nodes for teaching or experimenting with generative‑AI pipelines.
Developers who want a stable, MIT‑licensed base they can extend or embed in paid services.

Key Features (as described in the README)

Area	What the suite provides
Node count	532 nodes across 48 categories (masking, layers, colour/LUTs, HDR, logic, numbers, text, prompts, files, animation, LoRA, etc.).
No mandatory dependencies	After cloning into `ComfyUI/custom_nodes` the suite works with just ComfyUI 0.14+ and Python 3.10+. No pip install is performed automatically.
Optional feature groups	22 toggleable groups in `config.yaml`; 8 are disabled by default (e.g., document export, network‑heavy models).
Built‑in third‑party assets	Bundles fonts, three.js, face‑cascade files, several pre‑trained networks, and other libraries – all under permissive licences, no runtime downloads.
Security‑first	Outbound network calls are disabled by default; file access is gated by an allow‑list.
Upgrade path	Works with workflows saved in earlier versions; the README lists how retired or removed node IDs are handled.
Document export (optional)	With the `document_export` group enabled you can write `.docx`, `.odt`, or `.pdf` files directly from a workflow.
Three.js scene support	Nodes that render interactive 3‑D scenes using three.js; execution is gated by a config flag for safety.
Model‑weight handling	No weights are downloaded unless you enable `features.network`. When enabled the suite can pull the small set of bundled model files it ships with.

How to install

Via ComfyUI Manager – search for WAS Node Suite v3 and click install (recommended).
Manually – clone the repo into ComfyUI/custom_nodes:
```
cd ComfyUI/custom_nodes
git clone https://github.com/WASasquatch/was-node-suite-comfyui.git
```
The suite works with ComfyUI 0.14+ and Python 3.10+. No further pip commands are required unless you enable optional groups (e.g., document_export).

What’s new in version 3 vs. version 2?

More than double the nodes – from 220 to 532.
Zero default external packages – v2 installed ~20 packages; v3 installs none unless you opt‑in.
Optional feature groups – you can enable/disable whole categories via config.yaml.
Updated third‑party assets – now includes three.js, fonts, face cascades, and a few pre‑trained networks.
Improved node behavior – many nodes have been rewritten to run entirely on ComfyUI’s device (no OpenCV, no extra libs), and several have richer options (e.g., more blend modes, better grain handling).

Configuration & Extensibility

A config.yaml file is generated on first run under <ComfyUI user dir>/was-node-suite/. It mirrors config.example.yaml and lets you toggle the 22 feature groups, enable network downloads, or adjust security allow‑lists.
Nodes can be disabled per‑node via the same config, useful for trimming down a production environment.
Adding new third‑party code is possible, but any file access must be whitelisted in the config for security.

License & Community

MIT license – you can use, modify, and redistribute the suite freely.
All bundled third‑party files carry their own permissive licences and are included in docs/THIRD_PARTY.md.
The project welcomes contributions via GitHub issues and pull requests; a contributing guide is provided.
A small donation link (PayPal) is included for supporters.

Quick start checklist

Install ComfyUI 0.14+.
Add the suite via the manager or manual clone.
Launch ComfyUI – the suite will compile to bytecode on first run.
(Optional) Edit <ComfyUI user dir>/was-node-suite/config.yaml to enable extra groups like document_export or network.
Open the NODES.md file for a full list of node inputs/outputs, or browse the node palette inside ComfyUI.

In a nutshell: WAS Node Suite v3 is a massive, MIT‑licensed plug‑in for ComfyUI that gives you hundreds of ready‑made image‑processing and workflow‑control nodes, with a security‑first design and optional features that you can turn on as needed. It’s aimed at anyone building generative‑AI image pipelines in ComfyUI, from casual creators to developers building commercial services.