Comfy Node Scan and Clone 是一个基于 Gradio 的 GUI 工具,专为简化 ComfyUI 中 custom_nodes 的管理而设计。它提供了一个可视化界面,帮助用户轻松扫描、导出和克隆自定义节点仓库,并支持实时状态反馈。
该项目还附带一套 Windows 环境下的安装脚本,可一键部署完整的 ComfyUI 环境(包括依赖项和 ComfyUI-Manager),非常适合初学者快速上手。

核心功能
| 功能模块 | 描述 |
|---|---|
| 🔍 节点扫描器 | 扫描 custom_nodes 文件夹中的 Git 仓库并提取 GitHub URL 和名称,支持导出列表用于备份或共享 |
| 📦 简单克隆器 | 上传由扫描器生成的 URL 列表,一键克隆所有节点到新目录(已存在的节点将跳过) |
| 🧩 高级克隆器 | 提供复选框形式的交互界面,选择性地克隆特定节点;支持“全选”、“逐个选择”等操作 |
| ⚙️ Windows 安装助手 | 提供批处理脚本(.bat)实现一键安装 ComfyUI 及其依赖,自动检测 Python、Git 和 CUDA 版本 |

使用场景
你是否遇到以下问题?
- 想迁移到新的 ComfyUI 环境,但不想手动重新安装几十个 custom_nodes?
- 想分享自己的 custom_nodes 配置给他人?
- 想从别人那里导入精选的 custom_nodes 列表?
Comfy Node Scan and Clone 就是为此而生的工具。无论你是新手还是资深开发者,都能从中获得高效便捷的节点管理体验。

🛠 技术架构概览
该项目构建于以下核心组件之上:
- Python + Gradio:实现轻量级 GUI 界面
- Git CLI:用于仓库扫描与克隆
- 批处理脚本(Windows):自动化安装 ComfyUI 及相关依赖
- 兼容性优化:适配 Python 3.10~3.12,确保稳定运行
安装步骤(Windows)
✅ 推荐方式:一键安装脚本
首次使用时,运行提供的 install.bat 脚本即可完成完整环境部署:
双击 Install_ComfyUI.bat
该脚本会自动执行以下操作:
- 检查 Python 版本(3.10~3.12)
- 检查 Git 是否安装
- 检测 CUDA 支持情况
- 安装 ComfyUI 主体及依赖
- 安装 ComfyUI-Manager
- 设置基础环境路径
完成后即可运行 launch.bat 启动 GUI 应用。
🖥 手动安装(开发者适用)
git clone https://github.com/formulake/comfyuinode-scan-clone.git
cd comfyuinode-scan-clone
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
python app.py
📝 使用说明
🔍 节点扫描器(Scanner)
- 扫描指定的
custom_nodes目录; - 从
.git/config文件中提取 GitHub 仓库信息; - 支持导出为
.txt或.md文件,便于分享或存档。
📦 简单克隆器(Simple Cloner)
- 上传由扫描器导出的 URL 列表;
- 一键克隆所有仓库到目标
custom_nodes文件夹; - 已存在节点将被自动跳过,避免重复操作。
🧩 高级克隆器(Advanced Cloner)
- 支持上传
.txt或.md文件; - 显示复选框列表,自由选择需克隆的节点;
- 实时终端输出显示克隆进度;
- 支持“全选”按钮,一键克隆所有条目。
🧪 兼容性测试版本
| 组件 | 版本 |
|---|---|
| Gradio | 4.18.0 |
| Python | 3.12(通过 tomli 保证兼容性) |
| Git | Windows 命令行版 |
| ComfyUI | 最新主分支版本 |
📌 注意事项
- 当前仅支持 Windows 系统,批处理脚本针对 Win 平台优化;
- 推荐使用 Python 3.10 或 3.11,若使用 3.12,请确认依赖库已更新;
- Git 必须已加入系统 PATH,以便命令行调用;
- GUI 界面默认监听本地端口
7860,可通过浏览器访问。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
相关文章
暂无评论...















