Tech

Hugging Faceの「We couldn't connect to https://huggingface.co」の対処

モデルを読み込もうとすると、こう止まることがある。

OSError: We couldn't connect to 'https://huggingface.co' to load this file

Hugging Faceに接続できていない。原因はいくつかある。ネットワークやプロキシ、HF側の一時的な不調、あるいはモデル名のスペルミスでリポジトリが見つからない場合もこの形で出ることがある。

ネットワークとモデル名を確認する

まず普通にネットにつながるか、社内プロキシ環境なら設定が必要だ。

Terminal window
export HTTPS_PROXY=http://proxy.example.com:8080

あわせて、モデルIDのスペルも見直す。typoでリポジトリが見つからず、接続エラーのように見えることがある。

一度落としたものはオフラインで使う

すでにキャッシュ済みのモデルなら、オフラインモードで接続を試みずに使える。

Terminal window
export HF_HUB_OFFLINE=1

ダウンロードを安定・高速にする

大きなモデルで切れやすいなら、高速転送を有効にすると安定することがある。

Terminal window
pip install hf_transfer
export HF_HUB_ENABLE_HF_TRANSFER=1

まとめ

  • 原因はネットワーク/プロキシ、HF側の不調、またはモデル名のtypo
  • プロキシ設定とモデルIDのスペルを確認する
  • キャッシュ済みなら HF_HUB_OFFLINE=1 で使う
  • 切れやすいなら hf_transfer で安定化
  • 一時障害なら時間をおいて再試行する