comfyui-node-registry

1# Authoring & Publishing ComfyUI Custom Nodes
2 
3This skill covers writing a ComfyUI custom node pack and publishing it to the Comfy Registry (registry.comfy.org), the public catalog that powers ComfyUI-Manager. For *using* existing nodes in workflows, see the `comfyui-core` skill instead.
4 
5## Minimal Node Pack Structure
6 
7A node pack is a Python package placed under `ComfyUI/custom_nodes/<name>/`. The package `__init__.py` must export `NODE_CLASS_MAPPINGS` and `NODE_DISPLAY_NAME_MAPPINGS`; `WEB_DIRECTORY` is optional (only if the pack ships frontend JS).
8 
9```
10ComfyUI/custom_nodes/my-node-pack/
11├── __init__.py          # exports the mappings ComfyUI scans for
12├── nodes.py             # node class definitions
13├── pyproject.toml       # registry metadata (required to publish)
14├── requirements.txt     # optional Python deps
15├── .comfyignore         # optional — exclude files from the published archive
16├── LICENSE
17├── README.md
18└── web/js/              # optional frontend extension (see WEB_DIRECTORY)
19```
20 
21### `__init__.py`
22 
23```python
24from .nodes import NODE_CLASS_MAPPINGS, NODE_DISPLAY_NAME_MAPPINGS
25 
26# Optional: serve frontend JS/CSS from this folder (path relative to __init__.py)
27WEB_DIRECTORY = "./web/js"
28 
29__all__ = ["NODE_CLASS_MAPPINGS", "NODE_DISPLAY_NAME_MAPPINGS", "WEB_DIRECTORY"]
30```
31 
32### A minimal node class (`nodes.py`)
33 
34```python
35class ImageSelector:
36    CATEGORY = "example"          # menu path where the node appears
37 
38    @classmethod
39    def INPUT_TYPES(cls):
40…