%20(1).png)
NX_HuggingFace_Flux 插件完整教程
1. 插件简介
NX_HuggingFace_Flux 插件（GitHub地址：https://github.com/Franck-Demongin/NX_HuggingFace_Flux）是一个让你直接在 Hugging Face 云端生成图像的神奇小工具。就像是把 Hugging Face 的强大画图功能搬到了 ComfyUI 里面，让你不用在本地下载巨大的模型文件，就能享受到 Flux 模型的超强画图能力。
这个插件就像是一个"云端画师"，你给它一个描述，它就会通过网络连接到 Hugging Face 的服务器，让那边的强大电脑帮你画图，然后把结果传回来。这样做的好处是： - 不占用你电脑的存储空间（不用下载几十GB的模型文件） - 不消耗你的显卡性能（云端服务器帮你算） - 能用到最新最强的 Flux 模型
2. 如何安装
方法一：使用 Git（推荐）
- 打开 ComfyUI 安装目录下的
custom_nodes文件夹 - 在这个文件夹里面按住 Shift 键，右键点击空白处，选择"在此处打开命令窗口"
- 输入命令：
git clone https://github.com/Franck-Demongin/NX_HuggingFace_Flux.git - 等待下载完成
方法二：直接下载
- 去 GitHub 页面下载 ZIP 文件
- 解压到 ComfyUI 的
custom_nodes文件夹 - 把文件夹重命名为
NX_HuggingFace_Flux
重要的配置步骤
- 激活虚拟环境（这步很重要，不要跳过）
- 在 ComfyUI 主目录打开命令窗口
- Windows 用户输入：
venv\Scripts\activate - Linux/Mac 用户输入：
source venv/bin/activate -
你会看到命令前面出现
(venv)字样，说明激活成功 -
安装依赖包
-
输入命令：
pip install -r requirements.txt -
配置 Hugging Face 令牌
- 把
.env.example文件复制一份，重命名为.env - 打开
.env文件，填入你的 Hugging Face 访问令牌 -
没有令牌？去 Hugging Face 注册账号，在设置里生成一个
-
重启 ComfyUI
- 完成上述步骤后，重启 ComfyUI
- 在节点列表的
NX_Nodes分类里就能找到这个插件了
3. 节点详解
3.1 Hugging Face Flux 节点
这个节点是整个插件的核心，就像是一个"云端画图机"。你告诉它你想画什么，它就会连接到 Hugging Face 的服务器，用强大的 Flux 模型帮你生成图像。
3.2 参数详解
| 参数名 (UI显示) | 参数名 (代码里) | 参数值 | 建议值 | 通俗解释 | 专业解释 | 怎么用/举个例子 |
|---|---|---|---|---|---|---|
| Prompt | prompt | 文本框 | 详细描述 | 这就是你想画什么的描述，越详细越好 | 用于引导模型生成图像的文本提示词 | 比如"一只穿着小西装的可爱橘猫，坐在咖啡厅里喝咖啡" |
| Template | template | Flux-Dev / Flux-Schnell | Flux-Dev（质量优先）或 Flux-Schnell（速度优先） | 选择用哪个画图引擎，就像选择用油画还是水彩画 | 选择使用的 Flux 模型版本 | 想要高质量就选 Dev，想要快速出图就选 Schnell |
| Seed | seed | 数字 | -1（随机）或固定数字 | 这就像抽奖的种子号，同样的种子会画出同样的图 | 控制随机数生成的种子值，确保结果可重现 | 想要固定结果就填具体数字，想要随机就填 -1 |
| Width | width | 像素数值 | 1024 | 画面的宽度，就像调整画纸的宽度 | 生成图像的宽度像素值 | 一般用 1024，想要宽屏可以用 1344 |
| Height | height | 像素数值 | 1024 | 画面的高度，就像调整画纸的高度 | 生成图像的高度像素值 | 一般用 1024，想要竖屏可以用 1344 |
| CFG Scale | cfg_scale | 1.0-20.0 | 3.5-8.0 | 控制画图时听话程度，数值越高越听你的话 | 控制模型对提示词的遵循程度 | Dev 模型建议 3.5-8.0，Schnell 模型这个参数基本不起作用 |
| Steps | steps | 正整数 | Dev: 25-50, Schnell: 4 | 画图的精细程度，步数越多越精细但越慢 | 推理步数，影响图像质量和生成时间 | Dev 模型用 25-50 步，Schnell 模型用 4 步就够了 |
4. 使用技巧和建议
4.1 模型选择建议
- Flux-Dev：适合追求高质量的场景，画面更精细，但生成时间较长
- Flux-Schnell：适合快速出图，4步就能生成不错的效果，但质量略逊于 Dev
4.2 参数调优经验
- CFG Scale 调节：Dev 模型建议 2.5-8.0 之间，太高会过度饱和，太低会偏离提示词
- Steps 设置：Dev 模型至少 25 步，推荐 30-50 步；Schnell 模型 4 步即可
- 尺寸选择：建议使用 1024x1024 或其倍数，比如 1024x1344（竖屏）或 1344x1024（横屏）
4.3 提示词优化建议
- 使用英文描述，效果更好
- 描述要具体：不要只说"一只猫"，而要说"一只橘色的长毛猫，蓝色眼睛，坐在木质桌子上"
- 可以加上风格描述："photorealistic"（写实风格）、"anime style"（动漫风格）等
5. 常见问题解答
5.1 为什么经常出现生成失败？
原因：Hugging Face 的 GPU 资源有限，经常出现排队或超时的情况 解决方案： - 错峰使用，避开欧美白天时间段 - 多试几次，有时候是暂时的网络问题 - 考虑升级 Hugging Face 的付费计划
5.2 Hugging Face 令牌在哪里获取？
- 访问 Hugging Face 注册账号
- 点击右上角头像，选择 "Settings"
- 在左侧菜单找到 "Access Tokens"
- 点击 "New token" 创建新令牌
- 复制令牌到插件的配置文件中
5.3 生成的图片质量不满意怎么办？
- 检查提示词是否够详细和准确
- 尝试调高 Steps 数值（仅限 Dev 模型）
- 调整 CFG Scale 值
- 尝试不同的 Seed 值
5.4 插件安装后在 ComfyUI 里找不到？
- 确认文件夹名称是否正确：
NX_HuggingFace_Flux - 检查是否激活了虚拟环境并安装了依赖
- 确认
.env文件配置正确 - 重启 ComfyUI
6. 性能优化建议
6.1 网络优化
- 确保网络连接稳定
- 如果在中国大陆，可能需要使用代理访问 Hugging Face
- 避免在网络高峰期使用
6.2 参数优化
- 对于快速预览，使用 Schnell 模型 + 4 步
- 对于最终输出，使用 Dev 模型 + 30-50 步
- 批量生成时，可以固定 Seed 值以确保一致性
6.3 工作流程建议
- 先用 Schnell 模型快速测试提示词效果
- 确认提示词无误后，再用 Dev 模型生成高质量图片
- 保存好用的 Seed 值，方便后续微调
7. 补充说明
7.1 使用限制
- 需要稳定的网络连接
- 依赖 Hugging Face 的服务器状态
- 有每日使用配额限制（取决于你的 Hugging Face 账户类型）
7.2 适用场景
- 快速概念验证和原型制作
- 学习和实验 Flux 模型的效果
- 在显卡性能不足的情况下体验最新模型
- 不想占用本地存储空间的用户
7.3 注意事项
- 生成的图片会经过 Hugging Face 服务器，注意隐私保护
- 遵守 Hugging Face 的使用条款和内容政策
- 商业用途需要查看相关许可证要求
这个插件是一个很好的"云端画图"解决方案，特别适合想要体验 Flux 模型强大功能但不想在本地部署大模型的用户。通过合理的参数设置和网络优化，可以获得非常不错的使用体验。