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 # 运行
🧰 主要命令一览
| 命令 | 别名 | 描述 |
|---|---|---|
start | start_fg, start-fg | 前台启动 ComfyUI |
background | start_bg, start-bg | 后台启动 ComfyUI |
stop | — | 停止当前运行的 ComfyUI |
restart | — | 重启 ComfyUI |
update | — | 更新 ComfyUI 至最新版 |
reload | — | 实时监控并重载 ComfyUI |
watch_nodes | — | 选择监控哪些节点目录以触发重载 |
create_node | create-node | 创建新的自定义节点 |
list_nodes | list-nodes | 列出所有已安装的节点 |
delete_node | delete-node | 删除指定节点 |
pack_node | pack-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设置。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
相关文章
暂无评论...















