comfyui 报错 huggingface

报错信息

huggingface_hub.errors.LocalEntryNotFoundError: An error happened while trying to locate the file on the Hub and we cannot find the requested files in the local cache.

这个错误表示请求没有取得文件，本地缓存也没有可用副本。先查看完整异常链，分清网络连接、仓库或文件名、访问权限以及离线模式等原因；它不代表换镜像就一定能解决。

先排查

1. 确认正在运行的 ComfyUI 环境和模型仓库、文件名正确。
2. 如果仓库需要登录或授权，先完成相应授权；镜像不能绕过访问权限。
3. 检查是否误设 HF_HUB_OFFLINE，或插件启用了 local_files_only=True。离线模式需要文件已经存在于本地缓存。
4. 若是连接失败，检查当前进程使用的代理和证书配置，再考虑镜像。

需要镜像时，在启动前设置

以下示例仅对当前终端及其启动的子进程生效。先进入 ComfyUI 目录并激活对应 Python 环境，再运行其中一种写法。

PowerShell：

$env:HF_ENDPOINT = "https://hf-mirror.com"
python main.py

CMD：

set "HF_ENDPOINT=https://hf-mirror.com"
python main.py

便携版应在同一终端启动对应的启动脚本，使其继承变量；已经运行的 ComfyUI 需要退出后重启。

如果确实要在 Python 中设置，必须先导入 os，并放在导入 Hugging Face 相关模块之前：

import os
os.environ["HF_ENDPOINT"] = "https://hf-mirror.com"

# 然后再导入 huggingface_hub、transformers 或启动应用

通常直接设置启动环境即可，无需修改 ComfyUI 的 main.py。该地址是第三方镜像，其可用性和资源同步情况需要另行确认。

恢复默认端点时，先停止 ComfyUI，在 PowerShell 中执行下面的命令，再重新启动：

Remove-Item Env:HF_ENDPOINT -ErrorAction SilentlyContinue