一站式 ComfyUI 管理 CLI,支持安装部署、节点管理、模型下载、工作流执行与故障排查
说明:
## 核心用法
`comfy-cli` 是 ComfyUI 生态的官方命令行管理工具,旨在解决 AI 绘画工作流部署中的环境配置复杂、依赖冲突频繁、节点版本碎片化等痛点。核心功能覆盖完整生命周期:
**安装部署**:一键完成 ComfyUI 本体安装,自动识别 NVIDIA/AMD/Intel Arc/Apple Silicon 等硬件平台,支持 CUDA 版本精准指定与特定 PR/版本锁定。`–restore` 模式可为现有安装修复依赖。
**节点管理**:围绕 Custom Nodes 提供完整工具链——从 `install`/`uninstall`/`update` 基础操作,到 `save-snapshot`/`restore-snapshot` 实现环境快照与回滚,`bisect` 二分查找故障节点解决冲突,`deps-in-workflow` 从工作流反向提取依赖。内置脚手架支持节点开发、验证与 Registry 发布。
**模型管理**:打通 CivitAI 与 Hugging Face 双平台,支持 Token 鉴权下载 gated 模型,统一管理模型目录。
**工作流执行**:通过 `comfy run` 直接调用 API 工作流 JSON,支持远程主机与等待/日志选项,便于 CI/CD 集成。
## 显著优点
– **硬件适配全面**:覆盖主流 GPU 与 CPU 方案,CUDA 版本细粒度控制
– **故障排查专业**:`bisect` 与快照机制显著降低节点冲突诊断成本
– **生态整合深度**:原生对接 ComfyUI-Manager、CivitAI、Hugging Face
– **开发友好**:节点发布全流程支持,降低社区贡献门槛
## 潜在局限
– 依赖 Python/uv 环境,Windows 用户可能需额外配置
– 部分高级功能(如 `–fast-deps`)依赖实验性解析器,稳定性待验证
– Registry 节点质量参差不齐,`comfy node install` 不保证节点可用性
## 适合人群
ComfyUI 重度用户、AI 绘画工作流开发者、需要批量部署或版本锁定的团队/实验室。
## 常规风险
– 执行 `update all` 或快照恢复时可能引入破坏性变更,建议配合版本控制
– 模型下载涉及第三方平台 Token,需妥善保管 API Key
– 背景模式 (`–background`) 需手动 `comfy stop`,存在僵尸进程风险







