%20(1).png)
ComfyUI HuggingFace Downloader 插件：新手小白完全指南
1. 插件简介
插件地址：https://github.com/jnxmx/ComfyUI_HuggingFace_Downloader
这个插件就像是一个"快递小哥"，专门帮你从HuggingFace这个"大仓库"里把AI模型文件快速下载到你的电脑上。
能给我们带来什么效果？ - 就像在淘宝上一键下单一样简单，直接在ComfyUI里面就能下载各种AI模型 - 下载速度超快，不用等很久 - 下载完的模型可以直接连接到其他节点使用，就像搭积木一样方便 - 支持下载单个文件（比如一个模型文件）或整个文件夹（比如一套完整的模型包）
2. 如何安装
安装这个插件就像安装手机APP一样简单：
- 打开你的ComfyUI安装目录
- 找到
custom_nodes文件夹（这就是放插件的地方） - 在这个文件夹里右键打开命令行窗口
- 输入以下命令：
git clone https://github.com/jnxmx/ComfyUI_HuggingFace_Downloader - 等待下载完成后，重启ComfyUI就可以使用了
3. 节点逐一解析
3.1 HuggingFace File Downloader 节点 - 单文件下载神器
这个节点就像一个"精准快递员"，专门负责从HuggingFace上下载单个文件，比如一个模型文件、一个配置文件等。
3.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | HuggingFace Link | hf_link | 文本输入框 | 完整的HF文件链接 | 就像网购时的商品链接，告诉快递员要去哪里取货 | 指定要下载的HuggingFace文件URL地址 | 比如：https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.ckpt | | Target Folder | target_folder | 下拉选择框 | 根据文件类型选择 | 就像收货地址，决定文件下载到电脑的哪个文件夹 | 指定模型文件的保存目录类型 | 选择"checkpoints"放AI模型，"loras"放LoRA文件 | | Custom Path | custom_path | 文本输入框 | 留空或自定义路径 | 如果你有特殊的收货地址要求，可以在这里写 | 自定义文件保存的具体路径 | 比如：D:\MyModels\特殊模型\ | | Model Name | model_name | 输出接口 | 自动生成 | 下载完成后，这里会显示文件名，可以连接到其他节点 | 返回下载完成的模型文件名称 | 下载完成后输出"v1-5-pruned.ckpt" |
3.3 HuggingFace Folder Downloader 节点 - 文件夹批量下载专家
这个节点就像一个"搬家公司"，可以把整个文件夹或者文件夹里的一部分全部搬到你的电脑上。
3.4 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 | | :— | :— | :— | :— | :— | :— | :— | | Repository URL | repo_url | 文本输入框 | 完整的HF仓库地址 | 就像告诉搬家公司要去哪个小区搬家 | 指定要下载的HuggingFace仓库地址 | 比如：https://huggingface.co/runwayml/stable-diffusion-v1-5 | | Subfolder Path | subfolder_path | 文本输入框 | 子文件夹路径或留空 | 如果只想搬家具的一部分（比如只要客厅的东西），就写具体位置 | 指定仓库中要下载的特定子文件夹 | 比如："text_encoder"只下载文本编码器部分 | | Target Folder | target_folder | 下拉选择框 | 根据内容类型选择 | 搬到新家的哪个房间存放 | 指定下载内容的保存目录类型 | 选择"models"放完整模型，"vae"放VAE文件 | | Custom Path | custom_path | 文本输入框 | 留空或自定义路径 | 如果你有特殊的存放要求，可以指定具体位置 | 自定义文件夹保存的具体路径 | 比如：D:\AIModels\StableDiffusion\ | | Folder Name | folder_name | 输出接口 | 自动生成 | 下载完成后，这里会显示文件夹名，可以连接到其他节点 | 返回下载完成的文件夹名称 | 下载完成后输出"stable-diffusion-v1-5" | | Token | token | 文本输入框 | HF访问令牌 | 就像VIP会员卡，有些特殊的文件需要这个才能下载 | HuggingFace访问令牌，用于下载受限模型 | 在HF官网个人设置里生成，格式：hf_xxxxxxxxxxxx |
4. 使用技巧和建议
4.1 下载速度优化小贴士
- 就像选择快递公司一样，网络好的时候下载会更快
- 大文件建议在网络空闲时下载，避免影响其他网络使用
- 可以分批次下载，不要一次性下载太多文件
4.2 存储空间管理
- 定期清理不用的模型文件，就像整理衣柜一样
- 大型模型文件建议存放在空间充足的硬盘上
- 可以建立分类文件夹，方便日后查找
4.3 连接其他节点的技巧
- 下载完成的模型名称可以直接连接到"Load Checkpoint"节点
- 文件夹名称可以连接到需要指定模型路径的节点
- 记住连接线的颜色代表不同的数据类型
5. 常见问题解答
Q1: 下载失败怎么办？
A: 就像快递失败一样，通常有几个原因： - 网络连接问题：检查网络是否稳定 - 链接地址错误：确认HuggingFace链接是否正确 - 权限问题：某些模型需要Token才能下载 - 硬盘空间不足：清理磁盘空间后重试
Q2: 什么时候需要Token？
A: 就像进入VIP区域需要会员卡一样，有些模型需要Token： - 受限制的商业模型 - 需要同意使用条款的模型 - 私有仓库的模型
Q3: 下载的文件在哪里？
A: 默认情况下，文件会保存在ComfyUI的相应文件夹里：
- 模型文件：ComfyUI/models/checkpoints/
- LoRA文件：ComfyUI/models/loras/
- VAE文件：ComfyUI/models/vae/
Q4: 如何获取HuggingFace Token？
A: 就像申请会员卡一样： 1. 访问HuggingFace官网并登录 2. 点击右上角头像，选择"Settings" 3. 在左侧菜单找到"Access Tokens" 4. 点击"New token"创建新令牌 5. 复制生成的Token到插件中使用
6. 实际使用案例
案例1: 下载Stable Diffusion模型
- 使用"HuggingFace File Downloader"节点
- 在HuggingFace Link中输入：
https://huggingface.co/runwayml/stable-diffusion-v1-5/resolve/main/v1-5-pruned.ckpt - Target Folder选择"checkpoints"
- 点击执行，等待下载完成
- 将输出的model_name连接到"Load Checkpoint"节点
案例2: 下载完整模型仓库
- 使用"HuggingFace Folder Downloader"节点
- 在Repository URL中输入：
https://huggingface.co/runwayml/stable-diffusion-v1-5 - Target Folder选择"models"
- 点击执行，等待下载完成
- 将输出的folder_name连接到需要的节点
7. 进阶玩法
7.1 批量下载工作流
- 可以在一个工作流中同时使用多个下载节点
- 通过"Primitive"节点预设常用的下载地址
- 使用"String Constant"节点管理Token
7.2 自动化下载管理
- 结合定时任务，可以实现自动下载更新
- 使用条件节点控制下载逻辑
- 通过文件监控节点检查下载状态
这个插件就像是给ComfyUI装上了一个"万能下载器"，让你轻松获取各种AI模型，再也不用手动下载和复制文件了。记住，熟练使用这个插件的关键是多练习，就像学开车一样，多试几次就熟练了！