Comfy CLI 是一个专为 ComfyUI 设计的命令行工具，旨在简化其安装、配置和日常管理工作。它通过统一的接口让用户能够快速部署 ComfyUI 实例，并根据自身硬件环境（如 NVIDIA GPU、AMD GPU、Apple Silicon 或 CPU）灵活选择运行环境。该工具不仅支持一键启动本地服务器，还集成了对自定义节点的全生命周期管理功能，包括安装、更新、调试及版本回滚等操作。此外，Comfy CLI 提供了模型下载与管理工作区切换能力，用户可直接从 CivitAI、Hugging Face 等平台获取所需模型文件，并自动处理认证令牌等敏感信息。整体设计注重自动化与可复现性，尤其适合需要频繁测试节点兼容性或在 CI/CD 环境中部署的场景。
核心功能特点
- 支持多平台 GPU 选择与 CUDA 版本指定，适配 NVIDIA、AMD、Apple M 系列及纯 CPU 环境
- 提供交互式安装向导与预设参数模式，可跳过提示以支持脚本化部署
- 内置 ComfyUI-Manager 集成，实现自定义节点的批量安装、禁用、快照保存与依赖修复
- 具备工作流运行能力，允许通过命令行触发 API 工作流并控制输出格式与等待行为
- 支持模型从 CivitAI/Hugging Face 直接下载，自动识别 gated 资源并注入 API token
- 引入 bisect 调试机制，通过二分法快速定位导致 ComfyUI 异常的自定义节点
适用场景
Comfy CLI 特别适合那些希望摆脱图形界面繁琐操作、追求高效开发与调试流程的 AI 开发者。在持续集成（CI）环境中，开发者可通过 `–skip-prompt` 参数实现无人值守的安装与启动，确保每次构建都基于最新稳定版或特定提交进行测试。对于频繁更换硬件或使用不同操作系统（Windows/macOS/Linux）的研究人员而言，CLI 提供的跨平台一致性极大降低了环境配置成本。当项目涉及多个自定义节点时，利用快照功能可以精确还原某一时间点的节点状态，避免因版本漂移引发的兼容问题。此外，在团队协作中，通过 `comfy node save-snapshot` 生成的配置文件可作为共享基准，保证所有成员使用完全相同的依赖组合。对于那些需要远程部署 ComfyUI 服务的情况，`comfy launch –background –listen 0.0.0.0` 命令能快速建立后台守护进程，便于后续通过 API 调用执行复杂推理任务。