An error happened while trying to locate the files on the Hub and we cannot find the appropriate snapshot folder for the specified revision

快速结论：此报错通常在使用 ComfyUI 的自定义节点（特别是 comfyui-mimicmotionwrapper）加载 DWPose 模型时触发，优先排查网络是否能正常访问 Hugging Face Hub，以及是否因网络封锁导致模型自动下载失败。

问题场景

用户在 ComfyUI 中使用 comfyui-mimicmotionwrapper 自定义节点（MimicMotionGetPoses，节点 ID 42）加载工作流时触发。该节点尝试通过 snapshot_download 从 Hugging Face Hub 的 yzd-v/DWPose 仓库下载模型文件，但下载失败。

报错原文

An error happened while trying to locate the files on the Hub and we cannot find the appropriate snapshot folder for the specified revision on the local disk. Please check your internet connection and try again.

Exception Type: huggingface_hub.utils._errors.LocalEntryNotFoundError

原因分析

根据 Issue 开发者回复，该报错最直接的原因是你的网络环境无法正常访问 Hugging Face Hub，模型自动下载被阻断。这通常是网络封锁导致的，与 ComfyUI 核心无关。如果已有自定义节点（comfyui-mimicmotionwrapper）但网络依然不通，也会引发此错误。

环境排查

网络环境：确认是否能直接访问 huggingface.co，可尝试浏览器打开 https://huggingface.co/yzd-v/DWPose 验证。
ComfyUI 版本：报错环境使用 v0.3.10-38-g4209edf4（集成包 aki-v1.4），非核心版本问题。
自定义节点：是否已安装 comfyui-mimicmotionwrapper（仓库：kijai/ComfyUI-MimicMotionWrapper），以及该节点是否能自动触发下载。
显卡与显存：如有报错涉及显存不足（用户反馈 3060 遇到），也需要检查 VRAM 是否足够处理工作流（报错用户显卡为 RX 6600）。
Python 环境：Python 3.10.11，PyTorch 2.3.1+cu118，huggingface_hub 库版本需正常。

解决步骤

使用 VPN 或代理：这是 Issue 维护者推荐的首选方案。开启能稳定访问 Hugging Face 的 VPN，然后重启 ComfyUI 并重新加载工作流，让节点自动触发模型下载。
手动下载模型（备选方案）：如果无法使用 VPN，可以手动从 Hugging Face Hub 下载 yzd-v/DWPose 仓库的模型文件。下载后，将文件放置到 huggingface_hub 的缓存目录（通常在 ~/.cache/huggingface/hub/ 或 ComfyUI 集成包内的 python\lib\site-packages\huggingface_hub\ 相关位置）。请注意：具体缓存路径取决于你的 huggingface_hub 配置，如果无法确定，可优先尝试 VPN 方法。
检查节点更新：确保 comfyui-mimicmotionwrapper 是最新版本，可联系其维护者（kijai）获取帮助，因为 Issue 已确认此问题不是 ComfyUI 核心错误。
排查显存（如遇其他报错）：如果问题伴随显存溢出（OOM），考虑升级显卡或降低工作流分辨率/批次大小。

可优先尝试：步骤 1（使用 VPN）。

验证方法

重新运行之前报错的工作流（即 Issue 中提供的 JSON 文件），观察 MimicMotionGetPoses 节点是否能正常完成模型加载和推理。如果没有再抛出 LocalEntryNotFoundError，且节点输出正常，则问题已解决。

参考来源

Comfy-Org/ComfyUI #6430

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。

An error happened while trying to locate the files on the Hub and we cannot find the appropriate snapshot folder for the specified revision