Où se trouve le répertoire du cache Hugging Face ?

Pour le Hugging Face Hub, le répertoire de cache par défaut documenté est ~/.cache/huggingface/hub. Cependant, l'emplacement actif peut être modifié, donc vérifiez la configuration et le cache lui-même avant de considérer un dossier comme pouvant être supprimé.

Chemin par défaut et remplacements documentés

Le cache du Hub stocke les dépôts téléchargés de modèles, de jeux de données et de Space sous sa racine. La racine par défaut est ~/.cache/huggingface/hub. À l'intérieur, les dépôts portent généralement un nom tel que models--organization--repository, avec des répertoires pour les blobs, les snapshots et les références.

• HF_HUB_CACHE définit directement le répertoire du cache du Hub et est prioritaire.
• HF_HOME définit le répertoire d'accueil de Hugging Face ; lorsqu'il est défini, le cache du Hub se trouve sous HF_HOME/hub.
• Chaque appel de bibliothèque peut aussi préciser un répertoire de cache, de sorte qu'un projet peut utiliser un chemin différent du chemin global par défaut.

Vérifiez avant de libérer quoi que ce soit

Utilisez la CLI Hugging Face pour voir ce que son gestionnaire sait du cache actif. La commande documentée hf cache ls répertorie les dépôts mis en cache, leur taille et leurs informations d'accès. Si vous avez déplacé le cache, associez les commandes de gestion à l'option correspondante de répertoire du cache au lieu de supposer la valeur par défaut.

# Affichez l'emplacement que ce shell utilisera
printf '%s\n' "${HF_HUB_CACHE:-${HF_HOME:-$HOME/.cache/huggingface}/hub}"

# Inventoriez les dépôts mis en cache avant le nettoyage
hf cache ls

Avant de supprimer un instantané, identifiez le projet, l'environnement d'exécution et la révision qui l'utilisent. Un cache peut contenir bien plus que le fichier de modèle auquel vous pensez, et une arborescence source ou un workflow d'inférence local peut dépendre d'une révision mise en cache qui n'apparaît pas clairement dans l'explorateur de fichiers.

Nettoyage du cache par rapport à la conservation à long terme

Le cache Hugging Face est optimisé pour éviter les téléchargements inutiles. Il ne constitue pas automatiquement un catalogue à long terme des versions de modèles que vous souhaitez conserver. Si un ensemble d'artefacts de modèle terminés est important pour votre travail, décidez d'abord de ce que vous devrez récupérer plus tard et conservez une sauvegarde indépendante là où cela est approprié.

Tensor Archive intervient après cette décision : il peut conserver une famille locale associée, la vérifier et restaurer une copie exacte distincte avant que vous ne supprimiez manuellement une copie de travail redondante. Il ne remplace pas la gestion du cache propre à Hugging Face et n'indique pas à une bibliothèque active où télécharger les modèles.

Une séquence sûre

1. Vérifiez si HF_HUB_CACHE ou HF_HOME modifie l'emplacement actif.
2. Affichez le cache avec les outils Hugging Face et repérez les dépôts dont vous n'avez plus besoin immédiatement.
3. Conservez ou sauvegardez indépendamment toute version de modèle qui importe.
4. Pour une famille liée terminée, analysez-la, archivez-la, vérifiez-la et restaurez une copie séparée avant la récupération manuelle.

Si le cache se trouve sur le mauvais disque, changez le répertoire du cache Hugging Face avec la bonne variable d'environnement. Si le problème vient de révisions obsolètes, videz le cache Hugging Face en toute sécurité à l'aide du gestionnaire de cache. Pour les fichiers d'un autre environnement d'exécution, consultez le guide de stockage qui lui est propre.