Comfy CLI Troubleshooting Guide

Fix common Comfy CLI setup problems: missing git, Python and virtual environment requirements, headless Comfy Cloud auth, and GPU library installs.

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.10 or newer. Create and activate a virtual environment before running it:

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

Install the PyTorch build that matches your GPU

comfy install asks which GPU you have and installs the matching PyTorch build. Answer the prompt, or pass a GPU flag so the command can run unattended:

Platform	What comfy install installs	What you still need
NVIDIA	PyTorch with CUDA runtime (pip wheel)	Current GPU driver (not the full CUDA Toolkit)
AMD Linux	ROCm PyTorch wheels	ROCm-capable AMD GPU driver/stack for those wheels
AMD Windows	torch-directml	Compatible AMD GPU (DirectML; not ROCm)
Apple silicon	PyTorch nightly wheels (CPU index; Metal/MPS)	macOS on Apple silicon
Intel Arc	PyTorch XPU wheels	Compatible Intel Arc GPU / XPU stack
CPU	CPU PyTorch wheels	No discrete GPU required

comfy install --nvidia

Pass --skip-torch-or-directml if you install PyTorch yourself. comfy env prints the Python environment and workspace ComfyUI uses.

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.