Hugging Face のキャッシュディレクトリはどこ？

Hugging Face Hub で文書化された既定キャッシュディレクトリは ~/.cache/huggingface/hub です。ただし有効な場所は上書きできるため、フォルダーを削除可能とみなす前に、設定およびキャッシュ自体を確認してください。

既定パスと文書化された上書き

Hub キャッシュは、キャッシュルートの下にダウンロードしたモデル、データセット、Space のリポジトリを保存します。既定ルートは ~/.cache/huggingface/hub です。その中では、リポジトリは通常 models--organization--repository のように命名され、ブロブ、スナップショット、参照のディレクトリがあります。

• HF_HUB_CACHE は Hub キャッシュディレクトリを直接設定し、優先されます。
• HF_HOME は Hugging Face のホームディレクトリを設定します。この変数が設定されると、Hub キャッシュは HF_HOME/hub の下に置かれます。
• 各ライブラリ呼出しでもキャッシュディレクトリを指定できるため、プロジェクトがグローバル既定値とは異なるパスを使う場合があります。

何かを空ける前に確認

Hugging Face CLI を使い、キャッシュマネージャーが有効キャッシュについて把握している内容を確認します。文書化された hf cache ls コマンドは、キャッシュ済みリポジトリ、サイズ、アクセス情報を一覧表示します。キャッシュを移動した場合、既定値を前提にせず、キャッシュ管理コマンドを対応するキャッシュディレクトリオプションと組み合わせてください。

# このシェルが使用する場所を表示
printf '%s\n' "${HF_HUB_CACHE:-${HF_HOME:-$HOME/.cache/huggingface}/hub}"

# 整理前にキャッシュ済みリポジトリを棚卸し
hf cache ls

スナップショットを削除する前に、それを使用するプロジェクト、ランタイム、リビジョンを特定してください。キャッシュには、想定しているモデルファイル以外も含まれる場合があります。ソースツリーまたはローカル推論ワークフローが、ファイルブラウザーからは分かりにくいキャッシュ済みリビジョンへ依存している可能性もあります。

キャッシュ整理と長期保持の違い

Hugging Face キャッシュは、不要な再ダウンロードの回避に最適化されています。保存したいモデルバージョンの長期カタログに自動的になるわけではありません。完成済みモデル成果物の一群が作業に重要なら、まず後で復元すべきものを決め、必要に応じて独立バックアップを保持してください。

Tensor Archive を使うのはその判断の後です。重複した作業コピーを手作業で回収する前に、関連するローカルファミリーを保存、検証し、別の完全なコピーを復元できます。Hugging Face 自身のキャッシュ管理に代わるものではなく、有効なライブラリにモデルのダウンロード先を指示することもありません。

安全な手順

1. HF_HUB_CACHE または HF_HOME が有効な場所を変更しているか確認します。
2. Hugging Face ツールでキャッシュを一覧表示し、すぐには不要なリポジトリを特定します。
3. 重要なモデルバージョンは保持するか、独立してバックアップ
4. 完成済みの関連ファミリーについては、手作業で容量を回収する前に解析、アーカイブ、検証し、別のコピーを復元します。

キャッシュが誤ったディスクにあるなら、正しい環境変数でHugging Face のキャッシュディレクトリを変更します。古いリビジョンが問題なら、キャッシュマネージャーからHugging Face のキャッシュを安全に消去します。別のランタイムに属するファイルには、そのランタイム固有のストレージガイドが必要です。