Comfy-Org/comfy-cli

comfy‑cli 的功能

comfy‑cli 是一個基於 Python 的命令列介面，可協助您 安裝、執行與擴充 ComfyUI，這是一款開源的 AI 引擎，可用於生成影像、影片及其他媒體（例如 Stable Diffusion、Flux、DALL·E 等）。您無需手動克隆 ComfyUI 倉儲、安裝 Python 相依性，或手動編輯 JSON 工作流程檔案，只需輸入簡單的指令，例如 comfy install、comfy run 或 comfy generate 即可完成操作。

核心功能

功能	對您的意義
一鍵安裝與啟動	`comfy setup`（或 `comfy install` + `comfy launch`）可在一步驟內下載最新的 ComfyUI 程式碼、其管理器及所有必要的 Python 套件。
直接呼叫模型	`comfy generate` 可直接與合作的影像/影片節點（如 Flux、DALL·E、Stability AI 等）對接，無需手動建立 UI 工作流程的 JSON 檔案。
自訂節點管理	使用 `comfy node install <id>` 和 `comfy node update all` 等指令，可從 Comfy Registry 或 GitHub 安裝、更新、建立快照或回溯自訂節點套件。
快速相依性解析	使用 `--fast-deps` 或 `--uv-compile` 標籤，可啟用 `uv` 解析器，為所有節點編譯單一鎖定檔，使安裝速度明顯加快。
模型下載	僅需一個指令即可從 CivitAI、Hugging Face 或任何 URL 下載模型。
執行本機或雲端工作流程	`comfy run --workflow file.json --where cloud` 可將工作流程傳送至 Comfy Cloud（無需 GPU）。相同指令亦可對應至本機執行的 ComfyUI 伺服器。
適合代理的 JSON 輸出	加上 `--json` 參數後，每個指令都會輸出結構化資料，讓基於 LLM 的代理（如 Claude、Cursor 等）可解析並執行動作。
跨平台支援	支援 Windows、macOS 與 Linux；可安裝於 virtualenv、conda 環境，或透過 `pipx` 安裝。
Shell 自動補全	`comfy --install-completion` 可為所有子指令與選項啟用標籤補全功能。

常見工作流程

安裝 CLI – pip install comfy-cli（需 Python 3.10+）。
設定 ComfyUI – comfy setup（互動式精靈）或 comfy install。
新增節點或模型 – comfy node install comfyui‑impact‑pack 或 comfy model download <url>。
執行生成 – comfy generate --prompt "a cyberpunk city at night"（本機執行）或加上 --where cloud 在主機服務上執行。
取得結果 – comfy download <prompt_id> -o ./outputs。

為何重要

ComfyUI 是一款強大但手動操作繁瑣的 AI 媒體創作平台。comfy‑cli 消除了設定、相依性衝突與僅限 JSON 工作流程執行的障礙，讓開發者、CI 管道與需要程式化呼叫影像生成的 AI 代理都能輕鬆使用此引擎。

快速參考（選定指令）

comfy install – 下載 ComfyUI + 管理器。
comfy launch – 啟動 UI 伺服器（加入 --background 可以後台執行）。
comfy generate – 從終端機直接呼叫合作模型。
comfy run --workflow FILE.json [--where cloud] – 執行儲存的工作流程。
comfy node install <registry‑id> – 新增自訂節點套件。
comfy update all – 更新 ComfyUI 與所有已安裝的節點。
comfy cloud login / comfy cloud status – 管理主機的 Comfy Cloud 帳戶。
comfy --json <subcommand> – 提供機器可讀的輸出，供 LLM 代理使用。

哪些人應該使用它？

開發者：希望撰寫安裝腳本、CI 測試或自動化生成流程。
研究人員：需要可重現的環境來進行生成式媒體實驗。
基於 LLM 的代理（如 Claude、Cursor 等）：需要穩定的 JSON 介面來驅動影像生成。
藝術家：熟悉終端機操作，希望更快地啟動 ComfyUI 並存取多個模型提供者。

如何進一步學習

GitHub 倉儲 – https://github.com/Comfy-Org/comfy-cli（README、問題追蹤器、CI 狀態徽章）。
ComfyUI 專案 – https://github.com/comfyanonymous/ComfyUI（此 CLI 所包裝的引擎）。
Comfy Cloud – https://www.comfy.org/（透過 --where cloud 使用的主機 GPU 服務）。

以上所有資訊皆直接取自專案的 README；未推論任何額外功能。