install_custom_node
Install a ComfyUI custom node pack by registry ID, git URL, or name. Uses the ComfyUI-Manager HTTP API for remote instances or falls back to cm-cli subprocess when forced.
Instructions
Install a ComfyUI custom node pack by registry id (e.g. 'comfyui-impact-pack'), git URL, or name. Uses the ComfyUI-Manager HTTP API (works against remote instances) and falls back to the cm-cli subprocess when forced. A ComfyUI restart may be required to load newly installed nodes.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Registry id, git URL, or node-pack name to install. | |
| ref | No | Git ref (commit SHA, branch, or tag) to pin when installing a git URL. Overrides any ref parsed from the URL and any `version` value. Ignored for registry-id installs. | |
| mode | No | ComfyUI-Manager data source mode (default 'remote'): 'remote' fetches the live node list, 'local'/'cache' use bundled/cached data. | |
| source | No | How to interpret `id` (default 'auto', which detects git URLs vs registry ids). | |
| channel | No | ComfyUI-Manager channel name (default 'default'). | |
| version | No | Version to install (e.g. 'latest', 'nightly', or a semver). For git installs, this is treated as a git ref unless `ref` is also provided. Registry installs default to 'latest'. | |
| useCmCli | No | Force the cm-cli.py subprocess instead of the ComfyUI-Manager HTTP API. Requires a local ComfyUI install (COMFYUI_PATH); errors in remote --comfyui-url mode. |