2026年 HF Hub 大規模重み：跨境プルの決定マトリクス

Runner で大容量重みを引くとき、RTT・帯域・ディスクのいずれかが支配的になります。上から潰すチェックリストです。

• 回線：高 RTT ならタイムアウト先。並列は後回し。
• 容量：HF_HUB_CACHE と HF_XET_CACHE を合算で見積もる。
• 認証：ゲート repo は HF_TOKEN。暗黙送信は HF_HUB_DISABLE_IMPLICIT_TOKEN で制御。
• NAS／混在 OS：HF_HUB_DISABLE_SYMLINKS=1 で symlink 地獄を避ける（容量増）。
• 混雑 Runner：HF_XET_HIGH_PERFORMANCE と高並列は CPU・I/O を奪い合う。

CI で頻出のキーのみ。import 前に export。

export HF_HOME="${HF_HOME:-$HOME/Library/Caches/huggingface-ci}"
export HF_HUB_CACHE="${HF_HUB_CACHE:-$HF_HOME/hub}"
export HF_XET_CACHE="${HF_XET_CACHE:-$HF_HOME/xet}"
# export HF_ENDPOINT="https://huggingface.co"
export HF_HUB_ETAG_TIMEOUT=60
export HF_HUB_DOWNLOAD_TIMEOUT=300
export HF_XET_HIGH_PERFORMANCE=1
export HF_XET_NUM_CONCURRENT_RANGE_GETS=16
python -c "import huggingface_hub; print(huggingface_hub.__version__)"

未完了ファイルを活かすため失敗直後にキャッシュ全削除しない。Runner ローカルと actions/cache を分けて設計します。

path は HF_HUB_CACHE（＋必要なら Xet）。restore-keys の緩さはヒット率 vs 壊れた中間ファイルのトレードオフ。

タイムアウトを上げてからミラー A/B。429 は指数バックオフ＋Retry-After。プロキシは HTTPS_PROXY／NO_PROXY、TLS 検査は CA 明示。HF_HUB_OFFLINE=1 でキャッシュ命中をスモーク。

詳細 Q&A は本文下の FAQPage JSON-LD と同期。

2026 年はXet 系＋タイムアウトが主戦場。HF_ENDPOINT と HF_HUB_CACHE 境界をセットで固定すると再現性が出ます。