Vérifier et nettoyer le cache Hugging Face sur Mac

Localiser le cache et protéger votre travail

Le chemin habituel est ~/.cache/huggingface/hub. HF_HUB_CACHE cible le cache des dépôts ; HF_HOME couvre un espace plus large. Sans HF_HOME, XDG_CACHE_HOME peut modifier le chemin par défaut ; cache_dir peut le remplacer. Vérifiez séparément applications graphiques, terminal et notebook. HF_HOME peut contenir des données d’authentification : ne le supprimez pas entièrement et n’en publiez pas le contenu.

Vos checkpoints affinés, adapters, modifications de tokenizer, conversions, données privées et configurations ne sont pas forcément retéléchargeables. Vérifiez les sauvegardes : certains outils ignorent les caches marqués CACHEDIR.TAG. Gardez ce dont la restauration n’est pas établie ; une ancienne date d’accès ne prouve pas qu’un modèle est inutile.

Afficher les identifiants complets et les avertissements

Arrêtez les applications, téléchargements et tâches utilisant le cache. Exécutez hf cache ls --no-truncate, puis hf cache ls --revisions --no-truncate --show-warnings. La version testée masque par défaut les avertissements détaillés. Indiquez toujours le même --cache-dir pour un cache personnalisé. Examinez les anomalies de lecture ou de structure, notez occupation et espace libre, et gardez les listes de dépôts privés confidentielles.

Contrôler la portée de la suppression

hf cache rm attend l’identifiant complet du CLI. Conservez le préfixe model/ pour un modèle ; un nom de dossier commençant par models-- ne convient pas. Pour une révision, utilisez son hash complet et vérifiez son dépôt. Commencez avec --dry-run. Le résultat résume les cibles et l’espace estimé, pas chaque fichier. Une cible de dépôt couvre toutes ses révisions en cache.

Après vérification, retirez seulement --dry-run en gardant cible, chemin et demande de confirmation. Si la sélection change ou si l’aperçu échoue, suspendez la suppression et recherchez la cause. Les fichiers sont supprimés directement, sans corbeille ; restaurer exige une sauvegarde ou un nouvel accès au téléchargement. Les snapshots, et parfois les dépôts, partagent des blobs : laissez le gestionnaire traiter les références et n’additionnez pas simplement les tailles.

Distinguer prune et les autres caches

Dans la version 2.0.0 testée, hf cache prune --dry-run prévisualise les révisions detached et les téléchargements incomplets. Sans référence nommée, un projet peut encore imposer une révision exacte. Vérifiez chaque cible et arrêtez les téléchargements actifs. Commencez par un seul élément bien identifié.

Les données générées sous HF_DATASETS_CACHE diffèrent des téléchargements du Hub. Examinez séparément les transferts Xet et les sorties local_dir, en conservant les modifications locales. Supprimer HF_HOME ne remplace pas cet examen.

Charger réellement les modèles conservés

Refaites les mesures, chargez modèles et révisions nécessaires, puis exécutez une petite tâche au résultat connu. Importer une bibliothèque Python ne suffit pas. Testez l’usage hors ligne réseau coupé. En cas d’échec, arrêtez le nettoyage et vérifiez environnement, chemins, fichiers, accès et espace avant restauration. Retélécharger sans cesse un modèle nécessaire appelle une autre sélection ou davantage de capacité.

Pour un disque externe, vérifiez espace, permissions et prise en charge des liens symboliques. Copiez liens et cibles, configurez chaque application et validez ses modèles avant de retirer l’original. Gardez le disque connecté pendant l’utilisation.

Portée des vérifications

Le 2026-09-29, des caches synthétiques temporaires ont été testés hors ligne avec huggingface_hub 2.0.0 : listes, identifiants complets, avertissements et dry-run. Les aperçus n’ont pas modifié les fichiers ; supprimer une ancienne révision a conservé la version courante et les données partagées. Aucune inférence réelle, aucun cache utilisateur, nettoyage de blobs partagés entre dépôts ou déplacement de disque n’a été validé. Aucun gain fixe n’est garanti. Vérifiez votre version avec hf cache --help.

À vérifier avant toute suppression

Vérifiez l’emplacement réel, l’usage et la possibilité de restauration. Ce tableau n’est pas une liste de suppression automatique et ne garantit aucun volume libéré.

FAQ