Skip to content

feat: add essentials_category and main_category#12357

Open
Yourz wants to merge 20 commits intoComfy-Org:masterfrom
Yourz:rizz--essential-category
Open

feat: add essentials_category and main_category#12357
Yourz wants to merge 20 commits intoComfy-Org:masterfrom
Yourz:rizz--essential-category

Conversation

@Yourz
Copy link

@Yourz Yourz commented Feb 8, 2026

Changes

essentials_category

Based on Essentials Nodes Categorization - Implementation Status

  • Add essentials_category field to V3 node schema (io.Schema) and legacy ESSENTIALS_CATEGORY class attribute
  • Expose essentials_category in /object_info API response

main_category

Based on Nodes Proposed New Descriptions

  • Add main_category field to V3 node schema and legacy MAIN_CATEGORY class attribute
  • Expose main_category in /object_info API response
  • Add MAIN_CATEGORY_OVERRIDES mapping in comfy/node_categories.py for nodes that need category reassignment

Node categorization

  • Add comfy/node_categories.py with all essentials and main category constants + override mappings
  • Assign essentials_category and main_category to all core, extras, and API nodes
  • Display name update for essentials tab nodes

Essentials categories

Category Description
Basic Core workflow nodes (encode, sample, save, etc.)
Image Generation Text/image/pose/canny/depth to image
Image Tools Preprocessing, post-processing, compositing
Text Generation LLM text generation nodes
Video Generation Text/image/pose/canny to video
Video Tools Video utility nodes
Audio Audio generation and processing
3D 3D model generation

Main categories

Basics, Model Loading, Generation Setup, Image Processing, Animation & Video, AI Models & Controls, Upscaling & Enhancement, Utilities, Specialized Workflows, Development, Misc, Other

API Node PR Checklist

Scope

  • Is API Node Change

Pricing & Billing

  • Need pricing update
  • No pricing update

If Need pricing update:

  • Metronome rate cards updated
  • Auto‑billing tests updated and passing

QA

  • QA done
  • QA not required

Comms

  • Informed Kosinkadink

Marked nodes:
- Basic: LoadImage, SaveImage, LoadVideo, SaveVideo, Load3D, CLIPTextEncode
- Image Tools: ImageScale, ImageInvert, ImageBatch, ImageCrop, ImageRotate, ImageBlur
- Image Tools/Preprocessing: Canny
- Image Generation: LoraLoader
- Audio: LoadAudio, SaveAudio

Amp-Thread-ID: https://ampcode.com/threads/T-019c2b25-cd90-7218-9071-03cb46b351b3
- SaveGLB (Basic)
- GetVideoComponents (Video Tools)
- TencentTextToModelNode, TencentImageToModelNode (3D)
- RecraftRemoveBackgroundNode (Image Tools)
- KlingLipSyncAudioToVideoNode (Video Generation)
- OpenAIChatNode (Text Generation)
- StabilityTextToAudio (Audio)

Amp-Thread-ID: https://ampcode.com/threads/T-019c2b69-81c1-71c3-8096-450a39e20910
The field is used for top-level tabs in the node library, not just
the Essentials tab. Rename to main_category to support Partner Nodes,
Basic, and other main categories.

Amp-Thread-ID: https://ampcode.com/threads/T-019c2b69-81c1-71c3-8096-450a39e20910
@Yourz Yourz force-pushed the rizz--essential-category branch from 5cd68dd to 2ec5489 Compare February 16, 2026 07:00
@Yourz Yourz changed the title feat: add comfy_essentials with python_module 'essentials' feat: add essentials_category and main_category Feb 16, 2026
@Yourz Yourz changed the base branch from essentials-category to master February 16, 2026 09:18
@christian-byrne christian-byrne added the Core Core team dependency label Feb 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Core Core team dependency

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants