comfy-cli

用于管理ComfyUI安装、自定义节点和模型的CLI工具。

快速开始

bash
comfy install # 安装ComfyUI + ComfyUI-Manager
comfy launch # 启动ComfyUI服务器
comfy node install ComfyUI-Impact-Pack # 安装自定义节点
comfy model download --url https://civitai.com/api/download/models/12345

安装

bash
comfy install # 交互式GPU选择
comfy install --nvidia # NVIDIA GPU
comfy install --amd # AMD GPU (Linux ROCm)
comfy install --m-series # Apple Silicon
comfy install --cpu # 仅CPU
comfy install --restore # 恢复现有安装的依赖
comfy install --pr 1234 # 安装特定PR
comfy install --version latest # 最新稳定版
comfy install --version 0.2.0 # 特定版本

GPU选项：--nvidia、--amd、--intel-arc、--m-series、--cpu

CUDA版本（NVIDIA）：--cuda 12.9、--cuda 12.6、--cuda 12.4、--cuda 12.1、--cuda 11.8

其他标志：--skip-manager、--skip-torch-or-directml、--skip-requirement、--fast-deps

启动

bash
comfy launch # 前台模式
comfy launch --background # 后台模式
comfy launch -- --listen 0.0.0.0 # 向ComfyUI传递参数
comfy stop # 停止后台实例
comfy launch --frontend-pr 1234 # 测试前端PR

工作区选择

全局标志（互斥）：

bash
comfy --workspace /path/to/ComfyUI ... # 显式路径
comfy --recent ... # 上次使用的实例
comfy --here ... # 当前目录
comfy which # 显示所选实例
comfy set-default /path/to/ComfyUI # 设置默认值

自定义节点

bash
comfy node show # 列出已安装节点
comfy node simple-show # 紧凑列表
comfy node install # 从注册表安装
comfy node install --fast-deps # 快速依赖安装
comfy node reinstall # 重新安装节点
comfy node uninstall # 移除节点
comfy node update all # 更新所有节点
comfy node disable # 禁用节点
comfy node enable # 启用节点
comfy node fix # 修复节点依赖

快照：
bash
comfy node save-snapshot # 保存当前状态
comfy node save-snapshot --output snapshot.json
comfy node restore-snapshot snapshot.json
comfy node restore-dependencies # 从节点恢复依赖

调试：
bash
comfy node bisect # 二分查找损坏节点
comfy node deps-in-workflow workflow.json # 从工作流提取依赖
comfy node install-deps --workflow workflow.json # 安装工作流依赖

发布：
bash
comfy node init # 初始化脚手架
comfy node scaffold # 通过cookiecutter创建项目
comfy node validate # 发布前验证
comfy node pack # 打包节点
comfy node publish # 发布到注册表

模型

bash
comfy model list # 列出可用模型
comfy model download --url # 从URL下载
comfy model remove # 移除模型

来源：CivitAI、Hugging Face、直接URL

门控模型的令牌：

• - --civitai-token 或配置 civitaiapitoken
• --hf-token 或配置 hfapitoken

运行工作流

bash
comfy run --workflow workflow_api.json
comfy run --workflow workflow.json --wait --verbose
comfy run --workflow workflow.json --host 192.168.1.10 --port 8188

需要运行中的ComfyUI实例。

ComfyUI-Manager

bash
comfy manager disable-gui # 在UI中隐藏管理器
comfy manager enable-gui # 在UI中显示管理器
comfy manager clear # 清除启动操作

更新

bash
comfy update all # 更新ComfyUI + 节点
comfy update comfy # 仅更新ComfyUI

其他命令

bash
comfy env # 显示配置和路径
comfy --version # 打印CLI版本
comfy pr-cache list # 列出缓存的PR构建
comfy pr-cache clean # 清除过期缓存
comfy standalone # 创建独立Python捆绑包
comfy tracking enable|disable # 管理分析
comfy feedback # 提交反馈

配置

位置：

• - Linux：~/.config/comfy-cli/config.ini
• macOS：~/Library/Application Support/comfy-cli/config.ini
• Windows：%APPDATA%\Local\comfy-cli\config.ini

键：defaultworkspace、defaultlaunchextras、civitaiapitoken、hfapi_token

提示

• - --skip-prompt 用于非交互模式（CI/脚本）
• 后台模式跟踪PID以实现干净的 comfy stop
• 快照保留精确的节点版本以确保可重现性
• comfy node bisect 二分查找找出哪个节点破坏了你的设置
• PR缓存避免重新构建之前测试过的前端PR