[StreamDiffusion] 修復 ImportError: cannot import name 'cached_download' from 'huggingface_hub' 錯誤

2025.03.26 / StreamDiffusion
近期在研究 StreamDiffusion,發現在 Python 3.10 中執行時會出現「ImportError: cannot import name ‘cached_download’ from ‘huggingface_hub’」錯誤,導致無法下載模型。查資料後得知是因為 Hugging Face 的破壞性變更棄用了 cached_download 方法,直接原地改成 huggingface_hub 即可,本文將說明如何動手修正此問題。

重現錯誤

這個錯誤是在 安裝 StreamDiffusion 開發環境 時發生的,當時的系統環境是這樣:

軟體名稱版本
Windows 1123H2
Python3.10
CUDA12.4
PyTorch2.6.0

在安裝 StreamDiffusion 需要的 TensorRT 時會出現「ImportError: cannot import name ‘cached_download’ from ‘huggingface_hub’」錯誤。

解決方法

點一下錯誤說明中最後列出的 dynamic_modules_utils.py 路徑,再點「在編輯器中開啟檔案」。

刪除第 28 行中的 cached_download:

往下滑到 285 行,將 cached_download 改成 hf_hub_download,最後長這樣:

存檔,重新執行之前的指令,問題應已解決!

參考資料

網路論壇

相關文章

Ted Liou

雲科碩士在讀中,專注於 Unity C#、TouchDesigner 技術。
只要願意以超連結標註本文,歡迎轉載或用於教材製作!