Comfy Chair:为 ComfyUI 开发者打造的 CLI 管理神器

插件5个月前发布 小马良
137 0

Comfy Chair 是一个专为 ComfyUI 开发者设计的命令行工具,整合了开发者regiellis此前使用的多个 Bash 脚本,提供更高效、统一的开发体验。

🔥 核心功能亮点

功能描述
🚀 快速节点脚手架一键生成符合模板的 ComfyUI 自定义节点
🛠️ UV 加速依赖管理使用 UV 实现更快的 Python 包安装和更新
🔄 实时重载监控代码变化,自动重启 ComfyUI
📦 节点打包一条命令将节点打包为 zip 文件
🧹 清理与列出节点快速查看、删除或导出节点
💻 跨平台支持支持 Linux、macOS 和 Windows,各平台均有预编译二进制
🧑‍💻 开发者友好自动检测虚拟环境,避免手动操作
🛡️ 端口冲突检测启动前检查 8188 是否被占用,自动提示切换端口
🏠 可移植路径支持支持 {HOME}{USERPROFILE} 等跨平台变量

📌 提示(Quick Start)

无需安装 Go 即可使用 Comfy Chair。它是一个自包含的二进制文件,无须额外依赖即可运行:

  •  发布页面 下载最新版本。
  • 在 Linux/macOS 上设置可执行权限并添加至 PATH:
    chmod +x ./comfy-chair-linux-amd64
    sudo mv ./comfy-chair-linux-amd64 /usr/local/bin/comfy-chair
    comfy-chair help # 验证是否安装成功

⚠️ 若需使用 install  update 命令,需先安装 UV(用于 Python 包管理),但运行 ComfyUI 本身不强制要求 UV。

🛠 安装方式

✅ 二进制下载(推荐)

前往 GitHub Releases 页面 下载对应系统的二进制文件。

🧱 源码构建(适用于开发者)

git clone https://github.com/regiellis/comfy-chair-go.git
cd comfy-chair
go build -o comfy-chair .
./comfy-chair help

📦 使用 Taskfile 构建(本地开发)

task build # 构建二进制
./comfy-chair # 运行

🧰 主要命令一览

命令别名描述
startstart_fg, start-fg前台启动 ComfyUI
backgroundstart_bg, start-bg后台启动 ComfyUI
stop停止当前运行的 ComfyUI
restart重启 ComfyUI
update更新 ComfyUI 至最新版
reload实时监控并重载 ComfyUI
watch_nodes选择监控哪些节点目录以触发重载
create_nodecreate-node创建新的自定义节点
list_nodeslist-nodes列出所有已安装的节点
delete_nodedelete-node删除指定节点
pack_nodepack-node打包节点为 zip 文件
install安装或重新配置 ComfyUI
status查看当前运行状态及环境信息
help-h, --help显示帮助信息

🧪 先决条件

  • Go 1.23+(仅源码构建需要)
  • Python 3.x
  • UV(用于安装/更新命令)
  • ComfyUI 安装路径
    • 需在项目目录下创建 .env 文件,并设置 COMFYUI_PATH=/path/to/your/ComfyUI
    • 示例 .env 内容如下:
      COMFYUI_PATH=/home/user/comfyui
      COMFY_RELOAD_EXTS=.py,.js,.css
      COMFY_RELOAD_DEBOUNCE=5
      GPU_TYPE=nvidia
      PYTHON_VERSION=3.12
      
    • 若未找到 .env,程序会引导你交互式设置

🧼 虚拟环境支持(venv/.venv)

Comfy Chair 自动识别 venv 或 .venv 虚拟环境,确保跨平台兼容性和稳定性:

  • 若未找到虚拟环境,系统将提示你创建或重新配置
  • 不支持自定义虚拟环境名称(如 my_venv),仅接受标准命名:venv  .venv

🧰 新增功能(2025年5月更新)

  • GPU 类型识别与 PyTorch 安装
    安装过程中自动提示选择 GPU 类型(NVIDIA、AMD、Intel、Apple Silicon、DirectML、Ascend、Cambricon 或 CPU),并安装对应的 PyTorch 包。
  • Python 版本选择
    支持 Python 3.12(推荐)和 3.13(部分节点可能不兼容)
  • 增强的 .env 配置项
    支持 GPU_TYPE 和 PYTHON_VERSION 设置,实现更可靠的环境复现
  • 回退机制支持
    若 UV 不可用,则使用原生 python -m venv  pip 进行安装

🧪 故障排查建议

  • 找不到 Python 可执行文件?
    确保 ComfyUI 文件夹中存在 venv  .venv 目录。
  • 无法启动 ComfyUI?
    使用 comfy-chair status 检查进程状态及 PID 文件是否异常。
  • 节点修改未生效?
    使用 watch_nodes 添加需监听的节点目录,或检查 COMFY_RELOAD_EXTS 设置。
© 版权声明

相关文章

暂无评论

none
暂无评论...