Hugging Faceで「Cannot access gated repo / 401」が出るときの対処

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

GatedRepoError: 401 Client Error. Cannot access gated repo for url ...
Access to model X is restricted. You must be authenticated to access it.

これはモデルが「ゲート付き」または非公開で、ライセンス同意とトークン認証が必要、というサインだ。ダウンロードが拒否されている。

まずモデルページでライセンスに同意する

ブラウザでHugging Faceにログインし、そのモデルのページを開く。「Agree and access repository」などのボタンを押して、利用条件に同意する。ここを済ませないと、認証してもアクセスできない。

Settings の Access Tokens から、read権限のトークンを作成する。

ターミナルでログインし、トークンを貼る。

huggingface-cli login

コードの中で渡す方法もある。

from transformers import AutoModel
model = AutoModel.from_pretrained("org/model", token="hf_xxx")

環境変数 HF_TOKEN を設定しておくと、自動で使われる。