%20(1).png)
ComfyUI-IF_AI_HFDownloaderNode 插件完整教程
1. 插件简介
插件地址： https://github.com/if-ai/ComfyUI-IF_AI_HFDownloaderNode
这个插件就像是你的专属"模型管家"，帮你从 Hugging Face（一个超大的人工智能模型仓库）直接下载各种模型文件到你的电脑上。
能给我们带来什么好处？ - 告别手动下载： 不用再打开浏览器一个个下载模型文件了 - 精准下载： 可以只下载你需要的那一个文件，而不是整个文件夹 - 自动整理： 下载完成后，文件会自动放在你指定的位置 - 支持大文件： 那些几个GB的大模型文件，这个插件都能轻松处理
简单来说，这就像是给你的ComfyUI装了一个"外卖员"，你只需要告诉它你想要什么模型，它就会帮你"送货上门"。
2. 如何安装
方法一：通过ComfyUI Manager（推荐）
- 打开ComfyUI
- 点击"Manager"按钮
- 在搜索框输入"IF_AI_HFDownloaderNode"
- 找到插件后点击"Install"
- 重启ComfyUI
方法二：手动安装
- 打开ComfyUI的安装文件夹
- 进入
custom_nodes文件夹 - 在这里打开命令行窗口
- 输入：
git clone https://github.com/if-ai/ComfyUI-IF_AI_HFDownloaderNode.git - 重启ComfyUI
3. 节点详解
3.1 HF Downloader 节点
这个节点就像是一个"智能快递员"，专门负责从 Hugging Face 网站上帮你取文件。你只需要告诉它要下载什么，它就会帮你搞定。
3.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 仓库ID | repo_id | 文本输入 | 根据需要填写 | 就像是淘宝店铺的地址，告诉插件要去哪家"店"取货 | 指定Hugging Face上的模型仓库标识符 | 比如：runwayml/stable-diffusion-v1-5 |
| 文件名 | filename | 文本输入 | 根据需要填写 | 就像是具体的商品名，告诉插件要拿哪个文件 | 指定要下载的具体文件名称 | 比如：v1-5-pruned.ckpt |
| 下载模式 | download_mode | 单选框 | individual | 选择是要一个文件还是整个文件夹，就像选择买一个苹果还是买一箱苹果 | 设置下载整个仓库还是单个文件 | individual（单个文件）或 repo（整个仓库） |
| 本地文件夹 | local_dir | 文件夹路径 | 你的模型文件夹 | 告诉插件把下载的文件放在电脑的哪个位置 | 指定文件保存的本地目录路径 | 比如：models/checkpoints/ |
| 访问令牌 | token | 文本输入 | 可选 | 就像是进入某些私人会所需要的会员卡，有些特殊模型需要这个 | Hugging Face的访问令牌，用于下载私有模型 | 从Hugging Face账户设置中获取 |
| 强制下载 | force_download | 勾选框 | False | 就像是"重新下载"按钮，即使文件已经存在也重新下载一遍 | 强制重新下载文件，即使本地已存在 | 勾选后会覆盖已存在的文件 |
| 恢复下载 | resume_download | 勾选框 | True | 就像是"断点续传"功能，下载中断后可以从断点继续 | 支持中断后恢复下载功能 | 推荐保持勾选状态 |
3.3 输入输出接口
| 接口类型 | 接口名称 | 数据类型 | 说明 |
|---|---|---|---|
| 输入 | - | - | 该节点为起始节点，不需要输入 |
| 输出 | download_path | 文本 | 输出下载完成的文件路径，可以连接到其他节点 |
| 输出 | status | 文本 | 输出下载状态信息（成功/失败/进行中） |
4. 使用技巧和建议
4.1 新手使用建议
- 第一次使用时： 先试试下载一个小文件，比如配置文件，熟悉流程
- 文件夹管理： 提前在电脑上创建好分类文件夹，比如
models/checkpoints/、models/loras/等 - 网络环境： 确保网络稳定，大文件下载可能需要较长时间
4.2 高级使用技巧
- 批量下载： 可以复制多个下载节点，同时下载不同的模型
- 令牌管理： 如果需要下载私有模型，记得在Hugging Face申请访问令牌
- 文件校验： 下载完成后，建议检查文件大小是否正确
4.3 注意事项
- 隐私保护： 不要在工作流中保存你的访问令牌，更不要分享包含令牌的工作流
- 存储空间： 某些模型文件可能很大（几GB），确保硬盘空间充足
- 版本管理： 记录下载的模型版本，方便后续管理
5. 常见问题解答
Q1：下载速度很慢怎么办？
A： 这通常是网络问题。可以尝试： - 更换网络环境（比如用手机热点） - 使用科学上网工具 - 选择非高峰时段下载
Q2：下载失败了怎么办？
A： 检查以下几点： - 仓库ID和文件名是否正确 - 网络连接是否稳定 - 是否需要访问令牌（某些模型需要） - 本地文件夹路径是否存在
Q3：如何找到正确的仓库ID？
A：
1. 打开 Hugging Face 网站
2. 找到你想要的模型页面
3. 网址中的用户名/模型名就是仓库ID
4. 比如：https://huggingface.co/runwayml/stable-diffusion-v1-5，仓库ID就是 runwayml/stable-diffusion-v1-5
Q4：访问令牌在哪里获取？
A： 1. 登录 Hugging Face 网站 2. 点击右上角头像，选择 "Settings" 3. 在左侧菜单选择 "Access Tokens" 4. 点击 "New token" 创建新令牌
Q5：下载的文件放在哪里了？
A： 文件会保存在你设置的"本地文件夹"参数指定的位置。如果不确定，可以查看节点的输出信息，里面会显示具体的文件路径。
6. 实际使用示例
示例1：下载Stable Diffusion模型
仓库ID: runwayml/stable-diffusion-v1-5
文件名: v1-5-pruned.ckpt
下载模式: individual
本地文件夹: models/checkpoints/
示例2：下载LoRA模型
仓库ID: Lykon/DreamShaper
文件名: DreamShaper_8_pruned.safetensors
下载模式: individual
本地文件夹: models/loras/
示例3：下载整个仓库
仓库ID: stabilityai/stable-diffusion-2-1
下载模式: repo
本地文件夹: models/stable-diffusion-2-1/
这个插件就像是你的"模型管家"，让原本繁琐的下载过程变得简单轻松。掌握了这个工具，你就能更方便地管理和获取各种AI模型，让你的ComfyUI工作流更加高效！