comfy-cli

用命令行快速安装、运行和管理 ComfyUI，告别繁琐点击。

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署图像生成 🍴 复刻 174 🐛 待处理 120 👀 关注 12

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 1048

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源 CLI 工具，本地部署，完全免费。

项目预览

项目数据

分类图像生成

开发团队Comfy-Org

官网地址https://docs.comfy.org/comfy-cli/getting-started

GitHubhttps://github.com/Comfy-Org/comfy-cli

定价模式🏷️完全免费

价格说明开源 CLI 工具，本地部署，完全免费。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议GPL-3.0

主要语言Python

技术栈/模型ai,comfyui,command-line,stable-diffusion

GitHub 星标★ 1048

上线时间2024-04-14 00:00:00

代码更新2026-11-08

仓库体积18.7 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

comfy-cli 是 ComfyUI 的官方命令行工具，旨在通过终端高效管理 ComfyUI 的安装、运行、插件管理和工作流操作。它解决了 ComfyUI 用户依赖图形界面操作、流程繁琐的问题，提供了一键安装、启动、更新 ComfyUI 及其自定义节点的能力。核心能力包括：快速创建和管理多个 ComfyUI 实例，支持自定义节点和模型的安装与更新，提供工作流的导入导出和运行命令，并集成了 ComfyUI 生态的注册表服务。通过简单的命令，用户可以在服务器或无头环境中部署和使用 ComfyUI，适合自动化脚本和远程开发场景。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1048

技术标签

ai comfyui command-line stable-diffusion

使用教程

难度：入门约 10 分钟部署方式：命令行工具 6 步

环境要求

Python 3.10 或更高版本
已安装 pip（用于 pip install comfy-cli）
建议先创建并激活虚拟环境（venv 或 conda）
使用 Comfy Cloud 时需要 Comfy 账号且账户有额度/有效订阅

安装与启动步骤

1准备Python环境

确认 Python 版本为 3.10+，并按 README 建议先激活 venv 或 conda 虚拟环境，避免污染系统环境。
2安装comfy-cli

使用 pip 从 PyPI 安装 comfy-cli 命令行工具，安装完成后终端即可使用 comfy 命令。
```
pip install comfy-cli
```
3交互式初始化

运行 setup 向导，逐步完成本地或云端路由、认证以及 agent 技能安装；CI/脚本场景可加 -y 跳过交互。
```
comfy setup
```
4安装ComfyUI

下载并安装最新版 ComfyUI 和 ComfyUI-Manager。未指定路径时默认安装到 <HOME>/comfy。
```
comfy install
```
5登录Comfy云

没有本地 GPU 时使用云端，先执行 cloud login 浏览器 OAuth 登录，再确认账号与额度。
```
comfy cloud login
comfy cloud whoami
comfy cloud status
```

6云端运行工作流

用 API 格式工作流提交任务，命令返回 prompt_id，再用 jobs 和 download 查询与取回结果。

comfy run --workflow ./workflow.json --where cloud
comfy jobs wait <prompt_id> --where cloud
comfy download <prompt_id> --where cloud -o ./outputs

关键配置

配置项	必填	说明	示例
`--workspace`	否	指定 ComfyUI 安装目录，未指定时默认 <HOME>/comfy	`/your/path`
`--where`	否	指定运行位置为本地或云端，可通过 set-default 设为默认	`cloud`
`--launch-extras`	否	设置默认启动时附加的参数，启动时再次指定则忽略此设置	`--launch-extras="<extra args>"`
`--fast-deps`	否	安装时改用 uv 解析依赖，加快核心与自定义节点依赖安装	`comfy install --fast-deps`
`--skip-manager`	否	安装 ComfyUI 但跳过默认的 ComfyUI-Manager	`comfy install --skip-manager`

如何确认成功

登录状态可用 comfy cloud whoami 确认；任务状态用 comfy jobs status <prompt_id> --where cloud 查看，能返回状态即正常。

常见问题

Q：comfy node install 和 comfy node registry-install 有什么区别？

A：node install 走 ComfyUI-Manager，需工作区已装 Manager，支持 --channel/--mode/--fast-deps；registry-install 直连 Comfy Registry，不需要 Manager，只支持 --force-download。

Q：没有本地 GPU 能用吗？

A：可以。给命令加 --where cloud，把工作流提交到 Comfy Cloud 运行，无需本地安装 ComfyUI 和 GPU，但需要账号有额度。

Q：运行提示 cloud_unauthorized 怎么办？

A：说明登录态失效或未登录，重新执行 comfy cloud login 完成浏览器 OAuth 登录，并用 comfy cloud whoami 确认身份。

Q：comfy run --prompt 报缺少 checkpoint？

A：默认 text2img 图使用 v1-5-pruned-emaonly.ckpt，comfy-cli 不会自动下载。请自行放入 models/checkpoints，或用 --set checkpoint=<name> 指定已有模型。

Q：云端会消耗额度吗？

A：会。comfy run --where cloud 和 comfy generate 会消耗 Comfy Cloud 额度并需有效订阅；查询类命令如 whoami、status、jobs ls、templates ls 不消耗。

注意事项

云端运行时模型和自定义节点必须已存在于云端资产中，可用 comfy models search --where cloud 和 comfy nodes ls --where cloud 查看。
工作流建议在 ComfyUI 里用 File → Export (API) 导出为 API 格式，UI 格式 JSON 会被自动转换。
--where cloud 只对单次调用生效，可用 comfy set-default --where cloud 设为默认，--where local 临时覆盖，comfy set-default --clear-where 清除。
comfy run 默认异步提交并返回 prompt_id，需要阻塞等待可加 --wait，或把 prompt_id 管道传给 comfy download。

核心亮点

一键安装和启动 ComfyUI，简化部署流程
支持自定义节点和模型的命令行管理，提升效率
提供工作流运行和导入导出功能，便于自动化

不足之处

文档/社区待观察
依赖 ComfyUI 生态，功能受限于官方更新

适用场景

在服务器或无头环境部署 ComfyUI
通过脚本自动化管理多个 ComfyUI 实例
快速安装和更新自定义节点与模型

替代项目

ComfyUI Manager、Stable Diffusion WebUI、InvokeAI

上一篇：ComfyUI-MultiGPU

下一篇：SeargeSDXL