AskClean

Comment vider le cache Hugging Face sur Mac

Équipe AskClean · Mis à jour 2026-11-02

Pour récupérer l’espace occupé par le cache Hugging Face sur un Mac, repérez le cache réellement utilisé par votre application, examinez-le avec hf cache ls, puis prévisualisez la suppression d’un dépôt ou d’une révision précise avec hf cache rm --dry-run. Conservez les modèles nécessaires hors ligne et votre propre travail. Ne supprimez jamais à l’aveugle les blobs partagés ni tout le dossier HF_HOME.

Illustration conceptuelle de révisions reliées à des données partagées, avec les projets conservés à part
Plusieurs révisions peuvent partager les mêmes fichiers. Conservez vos checkpoints et vos projets séparément. Illustration conceptuelle.

Localiser le cache et protéger votre travail

Le cache du Hub se trouve généralement dans ~/.cache/huggingface/hub. HF_HUB_CACHE désigne directement ce cache des dépôts ; HF_HOME déplace l’ensemble du répertoire Hugging Face, et XDG_CACHE_HOME peut modifier l’emplacement par défaut lorsque HF_HOME n’est pas défini. Un argument cache_dir dans une application peut aussi imposer un autre emplacement. Vérifiez l’environnement qui lance réellement chaque application, et contrôlez séparément les applications graphiques, les noyaux de notebook et les projets en ligne de commande : un dossier Hub par défaut vide ne signifie pas qu’aucun modèle n’est stocké sur votre Mac.

HF_HOME peut aussi contenir des données d’authentification : ne supprimez pas tout ce répertoire pour vider les modèles téléchargés, et ne partagez jamais son contenu. Vos checkpoints issus d’un fine-tuning, adaptateurs, modifications de tokenizer, conversions, jeux de données privés, notebooks, prompts et fichiers de configuration ne sont pas forcément retéléchargeables : sauvegardez-les et vérifiez la sauvegarde, car certains outils ignorent les caches marqués CACHEDIR.TAG. Si vous ne savez pas comment restaurer un élément et remettre l’application en état de marche, gardez-le pour l’instant.

Ces commandes ont été vérifiées avec huggingface_hub 2.0.0 le 29 septembre 2026. Exécutez d’abord hf cache --help dans votre environnement ; si votre version propose d’autres commandes ou options, suivez sa documentation.

Afficher les identifiants complets et les avertissements

Commencez par hf cache ls --no-truncate pour lister les identifiants complets des dépôts, puis exécutez hf cache ls --revisions --no-truncate --show-warnings pour voir les hashs complets des révisions et les éventuels problèmes du cache. La version testée masque par défaut les avertissements détaillés. Pour un cache personnalisé, passez la même valeur --cache-dir à chaque commande, et gardez la sortie confidentielle si elle révèle des projets privés.

La taille affichée d’une révision peut dépasser l’espace que sa suppression libérerait : des snapshots peuvent partager des données, et certaines organisations du cache partagent aussi des blobs entre dépôts. Additionner les tailles peut donc compter plusieurs fois les mêmes fichiers. Examinez les avertissements sur des entrées illisibles ou incohérentes avant toute suppression. Choisissez une cible précise, comme une expérience abandonnée ou une révision que votre projet n’utilise plus, et cherchez les révisions épinglées dans le code et la configuration : l’ancienneté seule ne justifie pas une suppression.

  1. Fermez les applications et les tâches qui utilisent le cache visé.
  2. Exécutez hf cache ls --no-truncate, puis hf cache ls --revisions --no-truncate --show-warnings, sur le chemin de cache vérifié.
  3. Vérifiez si une application ou un projet a encore besoin du dépôt et de la révision choisis.
  4. Notez la taille actuelle du dossier et l’espace disque disponible avant toute modification.

Contrôler la portée de la suppression

Passez à hf cache rm un identifiant de dépôt complet ou un hash de révision complet issu de votre inventaire, en ajoutant d’abord --dry-run. Pour un dépôt de modèle, gardez le préfixe model/ affiché par la CLI : un nom de dossier commençant par models-- n’est pas le même identifiant. Pour une seule révision, utilisez son hash complet et vérifiez à quel dépôt elle appartient. L’aperçu résume les cibles et l’espace estimé, pas chaque fichier ; cibler un dépôt couvre toutes ses révisions en cache.

Après vérification, relancez exactement la même commande sans --dry-run, avec la même cible et le même répertoire de cache, en laissant la demande de confirmation activée. Si la liste change de façon inattendue ou si l’aperçu échoue, arrêtez-vous et cherchez la cause. Laissez le gestionnaire de cache traiter les blobs partagés et les références de snapshots : supprimer des fichiers isolés dans le Finder peut casser d’autres révisions.

La suppression du cache efface les fichiers directement, sans passer par la Corbeille. Pour restaurer une révision supprimée, il faudra une sauvegarde fonctionnelle ou un nouveau téléchargement. Gardez une sauvegarde jusqu’à ce que vos vérifications réussissent, surtout pour les modèles privés, à accès restreint (gated), retirés de la publication, modifiés localement ou nécessaires hors ligne.

Utiliser prune avec prudence et séparer les autres caches

Dans la version 2.0.0 testée, hf cache prune --dry-run prévisualise les révisions détachées (detached) et les téléchargements incomplets. Une révision détachée n’a plus de référence nommée dans le cache, mais votre projet peut encore demander cette révision exacte. Vérifiez vos projets et arrêtez les téléchargements en cours ; pour un premier nettoyage, une suppression explicite est plus facile à évaluer qu’un balayage global.

Les données traitées sous HF_DATASETS_CACHE ne sont pas des téléchargements du Hub : supprimer des révisions du Hub ne retire pas forcément les fichiers Arrow ni les résultats de transformation de Datasets. Examinez aussi à part les téléchargements effectués avec local_dir, qui vont dans un dossier choisi par vous ou par l’application, ainsi que le stockage de transfert Xet. Préservez vos modifications locales : un nouveau téléchargement ne les restaurera pas.

Vérifier que les modèles conservés fonctionnent

Refaites l’inventaire et les mesures, puis chargez un modèle et une révision que vous vouliez garder et exécutez une petite tâche au résultat connu ; importer une bibliothèque Python ne vérifie pas les fichiers du modèle. Si vous avez besoin d’un accès hors ligne, testez avec le réseau coupé avant de compter sur ce Mac sans connexion. Si l’exécution suivante retélécharge le même modèle, le nettoyage a retiré des données encore nécessaires : revoyez la sélection, la capacité de stockage ou l’emplacement du cache plutôt que de supprimer et retélécharger sans fin.

Si les modèles dont vous avez régulièrement besoin dépassent la capacité de votre Mac, un disque externe peut aider. Vérifiez l’espace libre, les permissions et la prise en charge des liens symboliques, qui relient les snapshots aux blobs partagés ; copiez ces liens avec les fichiers vers lesquels ils pointent. Configurez chaque application pour le nouvel emplacement et testez-y ses modèles avant de supprimer l’original. Gardez le disque branché chaque fois que ces applications en ont besoin. Si une vérification échoue, suspendez le nettoyage et réglez le problème avant de supprimer une autre entrée.

Comment ces commandes ont été vérifiées

Le 29 septembre 2026, nous avons testé hors ligne, avec huggingface_hub 2.0.0, des caches temporaires synthétiques : listes, identifiants complets, avertissements et aperçus (dry run). Les aperçus n’ont pas modifié les fichiers, et la suppression d’une ancienne révision a conservé la révision actuelle et ses données partagées, en ne supprimant que le blob propre à l’ancienne révision. Ces tests n’ont porté ni sur de vrais téléchargements de modèles, ni sur l’inférence, ni sur le cache d’un utilisateur, ni sur un changement de disque, ni sur des blobs partagés entre dépôts. Ils ne prédisent pas l’espace que votre Mac libérera.

AskClean peut vous montrer où l’espace est utilisé sur votre Mac. L’analyse de votre Mac et l’aperçu des résultats sont gratuits ; l’analyse IA et le nettoyage nécessitent Pro. Le nettoyage du disque supprime définitivement les éléments confirmés. Gérez les révisions en cache et leurs fichiers partagés avec la CLI Hugging Face, et laissez vos travaux originaux hors de la sélection.

Ce qui peut être recréé, et ce qu’il faut garder

Examinez chaque catégorie séparément. Ce tableau indique ce qu’il faut préserver ou restaurer ; il ne désigne aucun fichier à supprimer automatiquement.

ÉlémentOù vérifierÀ contrôler avant la suppression
Dépôt ou révision du Hubhf cache ls --revisionsVérifiez la sélection exacte. La restaurer peut exiger un nouveau téléchargement et l’accès au même dépôt.
Blobs et snapshots partagésCache du Hub vérifiéPassez par le gestionnaire de cache : des révisions, et dans certaines organisations des dépôts, partagent les mêmes fichiers.
Révisions détachéeshf cache prune --dry-runUn projet peut encore exiger une révision exacte, même sans référence nommée dans le cache.
Cache des jeux de données générésHF_DATASETS_CACHE / réglages de cache de DatasetsDistinct des téléchargements du Hub ; le recréer peut demander du temps de traitement et les données sources.
Checkpoints, adaptateurs et sources personnelsVos dossiers de projet et de sauvegardeConservez votre travail original et vérifiez que les sauvegardes l’incluent, surtout s’il se trouve dans un dossier de cache.
Répertoire Hugging Face et authentificationHF_HOMENe supprimez pas tout ce répertoire pour retirer des entrées du cache de modèles.

Le test de régression local a utilisé un minuscule cache synthétique. Sa taille n’est ni un banc d’essai ni une estimation des gains réels.

FAQ

Puis-je supprimer ~/.cache/huggingface sur mon Mac ?

Ne considérez pas tout ce dossier comme jetable. Repérez le cache du Hub actif, préservez les données d’authentification et votre travail original, puis prévisualisez la suppression de dépôts ou de révisions précis avec la commande hf cache installée.

Pourquoi supprimer une révision libère-t-il moins que sa taille affichée ?

Des révisions peuvent partager des fichiers, et certaines organisations du cache les partagent aussi entre dépôts. Consultez l’estimation de l’aperçu, puis comparez l’occupation et l’espace disponible avant et après. Additionner les tailles affichées peut compter plusieurs fois les mêmes fichiers.

Une révision détachée est-elle forcément inutilisée ?

Non. Un projet peut épingler une révision exacte même sans référence nommée dans le cache. Vérifiez les besoins du projet avant d’utiliser prune.

Mes modèles resteront-ils disponibles hors ligne après le nettoyage ?

Seuls les fichiers de cache conservés et complets peuvent servir aux tâches qui en ont besoin. Testez un chargement hors ligne représentatif avant de supprimer votre sauvegarde ou de compter sur la machine sans connexion.

hf cache rm peut-il supprimer mon modèle affiné ?

Oui, si vos fichiers personnalisés se trouvent dans l’entrée de cache sélectionnée. Gardez checkpoints, adaptateurs et fichiers modifiés hors des entrées à supprimer, et vérifiez leurs sauvegardes. Un dossier nommé cache peut contenir l’unique copie d’un travail important.

Sources

Autres guides sur le stockage des modèles et du développement