Come controllare e pulire la cache di Hugging Face sul Mac

Individuare i dati da conservare

Il percorso abituale è ~/.cache/huggingface/hub. HF_HUB_CACHE seleziona la cache dei repository; HF_HOME comprende altro. Se HF_HOME non è impostata, XDG_CACHE_HOME può influenzare il valore predefinito; cache_dir può scegliere una posizione diversa. Controlla separatamente app grafiche, terminale e notebook. HF_HOME può contenere dati di autenticazione: non eliminarla tutta né pubblicarne il contenuto.

Checkpoint personalizzati, adapter, modifiche al tokenizer, conversioni, dati privati e configurazioni potrebbero non essere riscaricabili. Verifica i backup: alcuni strumenti escludono le cache con CACHEDIR.TAG. Conserva ciò che non sai ripristinare; una vecchia data di accesso non dimostra che un modello sia inutile.

Mostrare ID completi e avvisi

Ferma app, download e processi che usano la cache. Esegui hf cache ls --no-truncate, poi hf cache ls --revisions --no-truncate --show-warnings. La versione provata nasconde per impostazione predefinita gli avvisi dettagliati. Usa sempre lo stesso --cache-dir per una posizione personalizzata. Esamina problemi di lettura o struttura, registra spazio occupato e libero e non pubblicare elenchi di repository privati.

Controllare l’ambito prima di confermare

hf cache rm richiede l’ID completo della CLI. Mantieni model/ per i repository di modelli; il nome di una cartella che inizia con models-- non lo sostituisce. Per una revisione usa l’hash completo e verifica il repository. Inizia con --dry-run: è un riepilogo di obiettivi e spazio stimato, non un elenco di singoli file. Un repository selezionato comprende tutte le sue revisioni in cache.

Dopo il controllo togli --dry-run mantenendo obiettivo, percorso e richiesta di conferma. Se la selezione cambia o l’anteprima fallisce, sospendi l’eliminazione e indaga. I file vengono eliminati direttamente, senza Cestino: per ripristinarli serve un backup o un nuovo accesso al download. Snapshot e, in certi formati, repository condividono blob; lascia le referenze al gestore e non sommare semplicemente le dimensioni.

Distinguere prune e le altre cache

Nella versione 2.0.0 provata, hf cache prune --dry-run mostra revisioni detached e download incompleti. Un progetto può richiedere una revisione precisa anche senza un riferimento nominato. Controlla ogni obiettivo e ferma i download attivi. Inizia da un solo elemento chiaramente identificato.

I dati generati in HF_DATASETS_CACHE sono diversi dai download del Hub. Esamina separatamente trasferimenti Xet e output local_dir, conservando modifiche locali. Eliminare tutta HF_HOME non sostituisce questi controlli.

Caricare davvero i modelli conservati

Ripeti le misure, carica modelli e revisioni necessari ed esegui un piccolo compito con risultato noto. Importare una libreria Python non basta. Verifica l’uso offline scollegando realmente la rete. In caso di errore interrompi la pulizia e controlla ambiente, percorsi, file, accesso e spazio prima del ripristino. Riscaricare sempre lo stesso modello necessario richiede di rivedere la scelta o la capacità.

Per spostare la cache su disco esterno, verifica spazio, permessi e link simbolici. Copia link e destinazioni, configura ogni app e prova i suoi modelli prima di rimuovere l’originale. Il disco deve restare collegato durante l’utilizzo.

Ambito delle verifiche

Il 2026-09-29 sono state provate cache sintetiche temporanee offline con huggingface_hub 2.0.0: elenchi, ID completi, avvisi e dry-run. Le anteprime non hanno cambiato file; rimuovere una vecchia revisione ha conservato quella corrente e i dati condivisi. Non sono stati verificati inferenza reale, cache utente, pulizia di blob tra repository o migrazioni. Nessuna quantità fissa di spazio è garantita. Controlla la tua versione con hf cache --help.

Cosa controllare prima di eliminare

Verifica posizione reale, utilizzo e possibilità di ripristino. Questa tabella non è un elenco di eliminazione automatica e non promette una quantità fissa di spazio.

FAQ