comfy-cli

What it is and what it does

comfy-cli is a terminal interface for ComfyUI, the open-source generative-media engine. It handles the full lifecycle: installing and updating ComfyUI itself, managing custom nodes (install, update, snapshot, bisect), downloading models from CivitAI and Hugging Face, and running workflows either locally against a ComfyUI server or remotely via Comfy Cloud. It also provides direct command-line access to partner image and video generation APIs (Flux, DALL·E, Stability, and others) without requiring manual workflow JSON construction.

The tool is designed for both local GPU-based workflows and cloud-based execution. It includes fast dependency resolution via uv, cross-platform support (Windows, macOS, Linux), structured JSON output for programmatic use, and bundled prompts for AI agents (Claude, Cursor) to drive it natively. Setup is interactive by default but supports non-interactive mode for CI and scripted deployments.

Use it for:

• Install and launch ComfyUI locally with one command, including ComfyUI-Manager and custom node setup.
• Run generative workflows from JSON files against a local ComfyUI server or submit them to Comfy Cloud for GPU-less execution.
• Call partner image/video APIs (Flux, DALL·E, Stability, etc.) directly from the CLI without writing workflow JSON.
• Manage and update custom nodes across a ComfyUI installation, with snapshot and bisect tools for debugging.
• Download and organize models from CivitAI, Hugging Face, and direct URLs into a ComfyUI workspace.
• Integrate ComfyUI workflows into CI/CD pipelines or agent-driven automation via structured JSON output.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A command-line tool for installing, configuring, and running ComfyUI — an open-source generative-media engine — with support for custom nodes, model downloads, local workflows, and cloud-based job submission.

Yes, with conditions. The tool is actively maintained, has low install friction, and solves a real problem for ComfyUI users — automating setup and workflow execution. However, the GPL-3.0-only license is a hard blocker for proprietary projects, and two known vulnerabilities warrant review before deployment in security-sensitive environments. The 20 runtime dependencies are substantial but necessary for the feature set.

Install

comfy-cli on PyPI

pip install comfy-cli

uv add comfy-cli

poetry add comfy-cli

Installing comfy-cli

Before you install

Low install friction with a pure-Python wheel. Active maintenance — released 4 days ago with 942 repository stars. However, 20 runtime dependencies including heavy packages (requests, httpx, gitpython, ruff, uv) add some weight; installation is straightforward but the dependency tree is substantial.

License in practice

Licensed under GPL-3.0-only (copyleft). Any derivative work or distribution must also be GPL-3.0-compatible; proprietary or closed-source projects cannot incorporate this package without legal review.

Quickstart

pip install comfy-cli
comfy setup
comfy run --workflow ./workflow.json --where cloud
comfy jobs wait <prompt_id> --where cloud

Requires Python 3.10 or later. Cloud-based job submission requires Comfy Cloud authentication and an active subscription for generation credits.

Verify before relying

• Whether the two known vulnerabilities (GHSA-562r-8445-54r2, PYSEC-2026-1260) affect typical CLI usage or are transitive only.
• Whether cloud-based job submission requires active Comfy Cloud subscription or if free tier exists.
• Performance impact of the 20 runtime dependencies on CLI startup time.

Package facts

Evidence: comfy_cli-1.16.0-py3-none-any.whl

Keywords: comfyui, stable diffusion

Tags

More Build Tools packages

Further reading