--- id: comfy-cli version: "1.16.0" license: GPL-3.0-only license_treatment: copyleft maintenance: active --- # comfy-cli — A CLI tool for installing and using ComfyUI. License: copyleft · Maintenance: active · Downloads: 106.6K/mo ## 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 above — 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 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 --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 - License: GPL-3.0-only (copyleft) - Python support: supports_current - Install friction: low - Maintenance: active - Downloads: 106.6K/month (top 15,000 on PyPI) - Known vulnerabilities: 2 ## Tags comfyui command line tool, stable diffusion cli setup, generative media workflow runner, custom node manager comfyui, comfyui cloud job submission, ai image generation cli, comfyui installation automation, generative-ai, workflow-automation, cli-tool [View on SkillFed](https://skillfed.io/packages/comfy-cli) · [View on PyPI](https://pypi.org/project/comfy-cli/)