%20(1).png)
ComfyUI-HfLoader 插件超详细新手教程
1. 插件简介
ComfyUI-HfLoader 是一个超级简单好用的插件，专门用来从 Hugging Face 网站上直接下载和加载各种模型。你可以把它想象成一个"网络搬运工"，它能帮你从 Hugging Face 这个大型模型仓库里，直接把你想要的模型文件搬到你的 ComfyUI 里面使用。
插件地址： https://github.com/olduvai-jp/ComfyUI-HfLoader
主要作用： - 直接从 Hugging Face 下载 LoRA 模型（就像给画风添加特效滤镜） - 直接从 Hugging Face 下载其他各种模型文件 - 不用手动下载文件，插件帮你自动搞定 - 支持私有模型（需要账号密码）
能带来什么效果： - 省去手动下载模型的麻烦 - 直接在工作流中使用最新的网络模型 - 可以快速尝试各种不同的模型效果 - 节省本地存储空间（不用提前下载一堆模型）
2. 如何安装
方法一：使用 ComfyUI Manager（推荐）
- 打开 ComfyUI
- 点击右侧的 "Manager" 按钮
- 点击 "Install Custom Nodes"
- 搜索 "HfLoader"
- 找到 "ComfyUI-HfLoader" 并点击 "Install"
- 重启 ComfyUI
方法二：手动安装
- 找到你的 ComfyUI 安装目录
- 进入
custom_nodes文件夹 - 打开命令行（Windows 用户在地址栏输入
cmd回车） - 输入以下命令：
git clone https://github.com/olduvai-jp/ComfyUI-HfLoader.git - 安装依赖包：
pip install huggingface-hub - 重启 ComfyUI
3. 节点详细解析
3.1 LoraLoaderFromHF 节点
这个节点就像一个"特效滤镜下载器"，专门用来从 Hugging Face 下载 LoRA 模型。LoRA 模型就像是给你的画风添加特殊效果的小插件，比如让人物更卡通、让风景更梦幻等等。
3.2 LoraLoaderFromHF 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 仓库名称 | repo_name | 文本输入 | 比如 "stabilityai/stable-diffusion-xl-base-1.0" | 这就像告诉快递员你要的东西在哪个商店，填写 Hugging Face 上模型的地址 | 指定 Hugging Face 上的模型仓库路径 | 输入 "username/model-name" 格式，比如 "runwayml/stable-diffusion-v1-5" |
| 文件名 | filename | 文本输入 | 比如 "model.safetensors" | 这就像告诉快递员你要商店里的哪个具体商品，指定要下载的模型文件名 | 指定要下载的具体模型文件名称 | 输入完整文件名，比如 "pytorch_model.bin" 或 "model.safetensors" |
| 访问密钥 | api_token | 文本输入 (可选) | 留空或填入你的 HF Token | 这就像你的会员卡，如果模型是私有的就需要这个来证明你有权限使用 | Hugging Face 的访问令牌，用于下载私有模型 | 如果是公开模型就留空，私有模型需要从 HF 官网获取 token |
| 模型强度 | strength_model | 数值滑块 | 1.0 | 这就像调节特效的强弱程度，数值越大特效越明显，可以是负数来减弱效果 | 控制 LoRA 对基础模型的影响程度 | 一般用 0.5-1.5 之间，负数会产生相反效果 |
| 文本理解强度 | strength_clip | 数值滑块 | 1.0 | 这就像调节模型对你文字描述理解的敏感度，影响它如何理解你的提示词 | 控制 LoRA 对 CLIP 文本编码器的影响程度 | 一般用 0.5-1.5 之间，负数会产生相反效果 |
3.3 LoadModelFromHF 节点
这个节点就像一个"万能模型下载器"，可以从 Hugging Face 下载各种类型的模型文件。它比上面那个节点更通用，不仅限于 LoRA 模型。
3.4 LoadModelFromHF 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 (能干嘛的) | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| 仓库名称 | repo_name | 文本输入 | 比如 "stabilityai/stable-diffusion-xl-base-1.0" | 这就像告诉快递员你要的东西在哪个商店，填写 Hugging Face 上模型的地址 | 指定 Hugging Face 上的模型仓库路径 | 输入 "username/model-name" 格式，比如 "runwayml/stable-diffusion-v1-5" |
| 文件名 | filename | 文本输入 | 比如 "model.safetensors" | 这就像告诉快递员你要商店里的哪个具体商品，指定要下载的模型文件名 | 指定要下载的具体模型文件名称 | 输入完整文件名，比如 "pytorch_model.bin" 或 "config.json" |
| 访问密钥 | api_token | 文本输入 (可选) | 留空或填入你的 HF Token | 这就像你的会员卡，如果模型是私有的就需要这个来证明你有权限使用 | Hugging Face 的访问令牌，用于下载私有模型 | 如果是公开模型就留空，私有模型需要从 HF 官网获取 token |
4. 使用技巧和建议
4.1 如何找到正确的仓库名称和文件名
- 打开 Hugging Face 网站 (https://huggingface.co/)
- 搜索你想要的模型
- 进入模型页面，看地址栏，比如
https://huggingface.co/runwayml/stable-diffusion-v1-5 - 仓库名称就是
runwayml/stable-diffusion-v1-5 - 点击 "Files" 标签查看所有文件，选择你需要的文件名
4.2 关于强度参数的调节
- strength_model 和 strength_clip 通常保持一致
- 从 1.0 开始尝试，如果效果太强就降低到 0.7-0.8
- 如果效果太弱就提高到 1.2-1.5
- 负数会产生相反效果，比如 -0.5 会减弱某些特征
4.3 网络连接优化
- 如果下载速度慢，可以尝试使用国内的镜像站点
- 建议在网络状况良好时使用，避免下载中断
- 大文件下载可能需要一些时间，请耐心等待
4.4 存储空间管理
- 插件会自动缓存已下载的模型
- 相同的模型不会重复下载
- 定期清理不需要的模型文件以节省空间
5. 常见问题解答
Q1: 下载速度很慢怎么办？
A: 这通常是网络问题。可以尝试： - 使用科学上网工具 - 选择网络状况好的时间段 - 尝试下载小一点的模型文件
Q2: 提示"找不到文件"怎么办？
A: 检查以下几点： - 仓库名称是否正确（注意大小写） - 文件名是否正确（包括扩展名） - 模型是否为私有（需要 API Token）
Q3: API Token 在哪里获取？
A: 1. 登录 Hugging Face 网站 2. 点击右上角头像，选择 "Settings" 3. 找到 "Access Tokens" 选项 4. 点击 "New token" 创建新的访问令牌 5. 复制令牌粘贴到插件中
Q4: 模型效果不明显怎么办？
A: - 尝试调高 strength_model 和 strength_clip 的值 - 确保模型与你的基础模型兼容 - 检查模型说明，看是否有特殊的使用要求
Q5: 下载的模型保存在哪里？
A:
- 模型会自动保存在 Hugging Face 的缓存目录中
- 通常在用户目录的 .cache/huggingface/ 文件夹内
- 插件会自动管理这些文件，一般不需要手动操作
6. 进阶使用技巧
6.1 批量测试不同模型
你可以复制多个 LoraLoaderFromHF 节点，连接到同一个工作流中，快速对比不同模型的效果。
6.2 结合其他插件使用
这个插件可以和其他 ComfyUI 插件完美配合，比如： - 与图片放大插件结合，先用 HfLoader 加载风格模型，再进行放大 - 与控制网结合，使用不同的控制模型
6.3 创建模型库
建议创建一个文档，记录你常用的模型仓库名称和文件名，方便以后快速调用。
7. 总结
ComfyUI-HfLoader 是一个非常实用的插件，它让我们可以直接从 Hugging Face 获取最新的模型，无需手动下载和管理文件。掌握了这个插件，你就相当于拥有了一个连接到全世界最大模型库的直通车，可以随时尝试各种有趣的新模型和效果。
记住最重要的几点： 1. 仓库名称和文件名要准确 2. 网络连接要稳定 3. 强度参数从 1.0 开始调节 4. 私有模型需要 API Token
现在就去试试吧，用这个插件来探索更多有趣的模型效果！