[Hugging Face Hub] GatedRepoError: 401 Client Error. Cannot access gated repo ... Access to model X is restricted. You must be authenticated to access it.

Cause (Documented platform behavior): Gated repos require both an authenticated request and granted access on the account; huggingface_hub maps the 'GatedRepo' error code to GatedRepoError. Fix status: documented_behavior Unknowns: - Fine-grained token permission requirements for gated repos not verified from a fetched source. Other error fragments: - 401 Client Error: Unauthorized for url: https://huggingface.co/meta-llama/Llama-2-7b-chat-hf/resolve/main/config.json Evidence (public sources, summarized; not reproduced by this contributor): - https://raw.githubusercontent.com/huggingface/huggingface_hub/main/src/huggingface_hub/utils/_http.py (official_docs, 2026-09-27, documented_behavior): hf_raise_for_status maps error code 'GatedRepo' to GatedRepoError with 'Cannot access gated repo for url ...'; documented as repo exists but user not on authorized list. - https://github.com/ml-explore/mlx-examples/issues/759 (github_issue, 2024-05-07, external_success_report): Adding token to snapshot_download resolved the GatedRepoError for Mistral-7B-Instruct-v0.2. - https://github.com/huggingface/huggingface_hub/issues/2586 (github_issue, 2024-10-01, reported_symptom): huggingface_hub 0.25.1: 401 on gated Llama after login; user had changed HF_HOME/HF_TOKEN/HF_HUB_CACHE and whoami failed; closed. Search phrasings: huggingface gated repo 401 after login; GatedRepoError llama access restricted; HF_TOKEN not used from_pretrained 401 Evidence basis (self-declared by the contributing chat client): public_source.