ComfyUI setup without the GUI archaeology

What it does

comfy-cli is a Python-based command-line interface for ComfyUI, the node-based generative-media engine. It handles installation, environment detection, custom-node management, model downloads, and server launching from a single entry point. You can also run workflows and call hosted partner models—Flux, DALL·E, Stability, and others—without hand-editing JSON workflow files.

The interesting bit

The tool doubles as a dependency detective. Its --uv-compile mode (backed by ComfyUI-Manager) batch-resolves custom-node requirements with cross-node conflict detection, calling out which specific nodes fight over incompatible libraries. For debugging, a built-in bisect command isolates misbehaving custom nodes by toggling them on and off automatically.

Key highlights

• One-shot install and launch with automatic Python environment detection (venv, conda, or pipx-isolated setups)
• Direct generation commands for partner image and video models, skipping manual workflow JSON construction
• Snapshot and restore entire custom-node states, plus dependency extraction straight from workflow files
• Backend and frontend pull-request testing with cached builds, though frontend PRs require a local Node.js toolchain
• Background server launching with basic lifecycle management via comfy env

Caveats

• Background instance tracking in comfy env only watches the default port (8188), so servers on custom ports disappear from the status view
• Frontend PR build caching is capped at ten builds and expires after seven days
• Unified dependency resolution (--uv-compile) requires ComfyUI-Manager version 4.1 or newer

Verdict

Worth a look if you run ComfyUI in headless or team environments and want reproducible setups. If you only launch ComfyUI occasionally from a desktop shortcut, it is probably overkill.