Comfy CLI Troubleshooting Guide - ComfyUI

Most Comfy CLI failures come from a missing prerequisite or a setup step that was skipped. Check the items below before reporting a problem.

Prerequisites

Comfy CLI needs git installed on your system. Install it first, so comfy install and comfy update can clone ComfyUI and its custom nodes.

Install ComfyUI in a virtual environment

comfy install installs ComfyUI into the active Python environment, which must be Python 3.9 or newer. Create and activate a virtual environment before running it:

python3 -m venv comfy-env
source comfy-env/bin/activate
comfy install

Install GPU libraries separately

comfy install does not install CUDA or ROCm. Install the GPU libraries that match your hardware before launching, otherwise comfy launch starts a ComfyUI that cannot use your GPU.

Set up Comfy Cloud without a browser

comfy setup signs in through your browser, so it cannot complete in CI, a devcontainer, or a headless server. Pass an API key and run non-interactive instead:

comfy setup --where cloud --api-key comfyui-... --non-interactive

Get more help

Get Started with Comfy CLI covers install, routing, and generation.
Comfy CLI Command Reference lists every command and flag.
Report a reproducible CLI bug in the comfy-cli repository.