comfy-cli
A CLI tool for installing and using ComfyUI.
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Cloud-based job submission requires Comfy Cloud authentication and an active subscription for generation credits.
- Low install friction with a pure-Python wheel.
License · maintenance · safety
GPL-3.0-only (copyleft) — 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.
last release 2026-08-10 (4 days) · last repo commit 2026-08-14 · 942 stars
2 known vulnerabilities (OSV.dev, 2026-08-14) · 106,623 downloads/mo, #12,646 on PyPI
Alternatives
Verify before relying
pip install comfy-cli
comfy setup
comfy run --workflow ./workflow.json --where cloud
comfy jobs wait <prompt_id> --where cloud- 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.
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 on it.
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
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.
Requires Python 3.10 or later. Cloud-based job submission requires Comfy Cloud authentication and an active subscription for generation credits.
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 cloudVerify 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
| License | GPL-3.0-only copyleft |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 20 packagescharset-normalizercookiecuttergitpythonhttpxmixpanelpackagingpathspecposthogpsutilpyyamlquestionaryrequestsrichruffsemvertomlkittypertyping-extensionsuvwebsocket-client |
| Maintenance | Actively maintained 4 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 106,623 / month, #12,646 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | 2 GHSA-562r-8445-54r2, PYSEC-2026-1260 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: GNU General Public License v3 (GPLv3)Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13 |
Evidence: comfy_cli-1.16.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “comfyui command line tool”
- comfy-cliA command-line tool for installing, configuring, and running ComfyUI…
- lamin_cliProvides a command-line interface for managing database instances,…
- comfyui-workflow-templatesProvides a curated collection of workflow templates and subgraph…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also comfyui-manager · comfyui-workflow-templates-media-image · comfyui-workflow-templates-media-video · comfyui-workflow-templates-media-api · comfyui-embedded-docs · comfyui-workflow-templates-media-assets-01 · comfyui-workflow-templates · comfyui-workflow-templates-media-other · comfyui-workflow-templates-json · lamin_cli