comfyui-node-migration
ComfyUI V1 → V3 Migration Guide
Migrate existing V1 nodes to the modern V3 API. V3 uses classmethods, typed inputs/outputs, and ComfyExtension registration.
Migration Checklist
- Change base class to
io.ComfyNode - Replace
INPUT_TYPES()withdefine_schema()returningio.Schema - Rename execution function to
executeand make it a@classmethod - Replace return tuples with
io.NodeOutput(...) - Replace
IS_CHANGEDwithfingerprint_inputs - Replace
VALIDATE_INPUTSwithvalidate_inputs - Convert
check_lazy_statusto@classmethod - Replace
NODE_CLASS_MAPPINGSwithComfyExtension+comfy_entrypoint() - Access hidden inputs via
cls.hiddeninstead of kwargs - Remove
__init__methods (no instance state in V3)
Side-by-Side Comparison
More from jtydhr88/comfyui-custom-node-skills
comfyui-node-packaging
ComfyUI custom node project structure - directory layout, __init__.py, registration, requirements.txt, publishing, WEB_DIRECTORY. Use when setting up a new custom node project, packaging nodes, or publishing to the registry.
39comfyui-node-advanced
ComfyUI advanced node patterns - MatchType, Autogrow, DynamicCombo, node expansion, MultiType, wildcard inputs. Use when building complex nodes with dynamic inputs, type matching, or node expansion.
37comfyui-node-frontend
ComfyUI frontend JavaScript extensions - hooks, widgets, sidebar tabs, commands, settings, toasts, dialogs. Use when adding UI features to custom nodes, creating custom widgets, or extending the ComfyUI frontend.
35comfyui-node-basics
ComfyUI custom node fundamentals - V3 node structure, Schema, inputs/outputs, registration. Use when creating new ComfyUI custom nodes, defining node classes, or setting up a custom node project.
32comfyui-node-outputs
ComfyUI node output types - NodeOutput, UI outputs, PreviewImage, PreviewMask, SavedImages, PreviewAudio, PreviewText, PreviewVideo. Use when returning results from nodes, displaying previews, or saving output files.
31comfyui-node-lifecycle
ComfyUI node execution lifecycle - caching, fingerprint_inputs/IS_CHANGED, validate_inputs/VALIDATE_INPUTS, check_lazy_status, execution order. Use when debugging execution, implementing caching control, input validation, or understanding execution flow.
27