你是不是 pip 源配好了,装插件不卡了,结果一加载工作流,报错说Cannot connect to huggingface.co?
别慌,我也踩过——pip 只管 Python 包,模型下载它管不了。HuggingFace 才是第二道坎。
这篇给你最省事的方案:设一个环境变量,把 HuggingFace 的地址永久指向国内镜像 hf-mirror.com,从此模型下载不再看运气。
本篇目标
读完这篇,你要能做到:
- 理解 ComfyUI 为什么需要连接 HuggingFace。
- 用环境变量
HF_ENDPOINT把 ComfyUI 的 HF 请求指向 hf-mirror.com。 - 用
huggingface-cli从镜像站手动下载模型。 - 知道 ModelScope 作为备选方案什么时候用、怎么用。
- 遇到
ConnectionError、SSLError、下载卡住时能快速排查。
前置条件
- 已完成第 6 篇,pip 源已配好。
- ComfyUI 能正常启动(AMD 或 NVIDIA 均可)。
- 知道 ComfyUI 根目录路径,例如
D:\ComfyUI。