ComfyUI Plugins

Starter infrastructure for developing custom ComfyUI nodes in this repository.

What is included

• ComfyUI plugin entrypoint in __init__.py
• Node modules under nodes/
• Native image sizes node in nodes/native_image_sizes.py
• Local test setup in tests/
• Python project metadata in pyproject.toml
• Development dependency file in requirements-dev.txt
• VS Code Python + Ruff defaults in .vscode/
• Windows helper script to link this repo into ComfyUI: scripts/link_to_comfyui.ps1

Quick start

1. Create and activate a Python virtual environment.

2. Install development dependencies:

   pip install -r requirements-dev.txt
   

3. Link this repo into your local ComfyUI installation:

   .\scripts\link_to_comfyui.ps1 -ComfyUIPath "C:\path\to\ComfyUI"
   

   If a target already exists, replace it with:

   .\scripts\link_to_comfyui.ps1 -ComfyUIPath "C:\path\to\ComfyUI" -Force
   

4. Start ComfyUI and search for the node named "NativeImageSizes" in category "image/resolution".

Repository layout

.
├── __init__.py
├── nodes/
│   └── native_image_sizes.py
├── tests/
│   └── test_native_image_sizes.py
├── scripts/
│   └── link_to_comfyui.ps1
├── pyproject.toml
└── requirements-dev.txt

Running tests and lint

pytest
ruff check .
ty check nodes

Add a new node

1. Create a new module in nodes/, for example nodes/image_nodes.py.
2. Define one or more node classes with ComfyUI fields such as:
   • INPUT_TYPES
   • RETURN_TYPES
   • FUNCTION
   • CATEGORY
3. Export the class from NODE_CLASS_MAPPINGS and NODE_DISPLAY_NAME_MAPPINGS.
4. Import and merge those mappings in top-level __init__.py.

Notes

• The link helper script attempts a symbolic link first, then falls back to a junction on Windows.
• This repository is intentionally minimal and ready for expansion into multiple node modules.