comfy-org/comfy-cli

comfy-custom-nodes-api-schema

Packaged fallback for ComfyUI V3 and legacy V1 custom-node schema shape.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/comfy-org/comfy-cli --skill comfy-custom-nodes-api-schema

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

API/schema fallback

V3 uses io.ComfyNode, io.Schema, ComfyExtension, and module-level comfy_entrypoint. define_schema and execute are classmethods; execute parameter names equal input ids; return io.NodeOutput in output order. node_id is stable workflow identity; display_name may change. Useful schema tools include io.Autogrow, io.DynamicCombo, and io.MatchType; previews belong in io.NodeOutput, progress uses the runtime execution API, and terminal nodes set is_output_node. Keep tensor batch dimensions: IMAGE [B,H,W,C], MASK [B,H,W]; do not assume a fixed LATENT shape.

V1 uses INPUT_TYPES, RETURN_TYPES, FUNCTION, CATEGORY, and NODE_CLASS_MAPPINGS. Translate deliberately; do not mix registrations.

If a pack ships frontend code, export WEB_DIRECTORY and keep saved widget values JSON-like and stable. Preserve old workflow identity during V1-to-V3 migration by registering the node_replacement; constructing a replacement descriptor alone does nothing.

Related by task

from this repository

More skills

All skills
comfy-org
Community

comfy

Generate images, videos, audio, and 3D via ComfyUI — CLI surface, workflow creation hierarchy (template → fragment → raw JSON), domain gotchas, cloud auth, multi-stage orchestration.

installs
2
GitHub stars
1K
Updated
Oct 20
comfy-org
Community

comfy-agent-permissions

Use when a permission blocks the local comfy agent — a folder it cannot read or write, a host a download was refused for, a shell it does not have — to know what the agent may reach by default, how a request is recorded (requestpath, requesthost) and how only the user approves it (the agent panel or the in-chat card), the start-time settings, and what can never be granted.

installs
2
GitHub stars
1K
Updated
Oct 20
comfy-org
Community

comfy-build

Build a custom ComfyUI environment on the Comfy developer platform with comfy-cli: turn a local install, a ComfyUI Desktop snapshot, a workflow JSON, or nothing but a Dockerfile, a Modal script or a sentence into a committed comfy-build.yaml and a green release. Use whenever the user wants to package, build, pin, or reproduce a ComfyUI environment, decide the dependency pins before the first cut, or read a failed build's log. Stops at a green release; comfy-deploy takes it from there.

installs
2
GitHub stars
1K
Updated
Oct 20
comfy-org
Community

comfy-build-authoring

Reference skill cited by comfy-build. Read it with comfy skills show comfy-build-authoring when authoring a comfy-build.yaml definition by hand — the user has no ComfyUI install to scan, or you are editing a spec's models and customNodes directly. Covers searching the node registry, resolving model filenames to public sources, choosing the directory a weight lands in, and every field of the definition schema.

installs
2
GitHub stars
1K
Updated
Oct 20