Come svuotare in sicurezza la cache di Hugging Face

Usa i comandi hf cache attuali per esaminare la cache prima di eliminare qualsiasi cosa. Rimuovi un repository o una revisione noti con hf cache rm; usa hf cache prune per le revisioni non più referenziate. Non trattare la directory della cache come un mucchio di file indipendenti: gli snapshot possono condividere gli stessi blob.

Perché l'eliminazione manuale è ingannevolmente rischiosa

La cache Hub è progettata per evitare di scaricare due volte contenuti identici. Sotto la cache hub, un repository contiene normalmente refs, snapshots e blobs. Uno snapshot presenta una revisione come directory utilizzabile, mentre i suoi file possono rimandare a contenuti condivisi in blobs. Due revisioni possono quindi sembrare contenere lo stesso grande file di pesi senza consumare due copie complete.

Questa struttura è efficiente, ma rende «elimina la cartella che sembra più grande» una regola inadeguata. Rimuovere manualmente un blob attivo può compromettere più di uno snapshot. Rimuovere un solo snapshot può liberare molto meno spazio della sua dimensione apparente perché altre revisioni fanno ancora riferimento allo stesso contenuto.

Misura la cache che stai usando davvero

Per prima cosa individua la directory attiva della cache di Hugging Face. HF_HOME, HF_HUB_CACHE e le variabili correlate potrebbero averla spostata rispetto al percorso predefinito. Chiedi quindi alla CLI di mostrarti la cache:

hf cache ls
hf cache ls --revisions

Il primo comando elenca i repository nella cache; il secondo mostra le singole revisioni. Usa i filtri o l'ordinamento della CLI attuale quando l'elenco è lungo. La decisione da prendere non è semplicemente «che cosa è vecchio?», bensì «quale repository o revisione esatti posso scaricare di nuovo e quale sostiene il lavoro attuale?».

Rimuovi consapevolmente un repository o una revisione

Quando sai che un intero repository nella cache è eliminabile, passa il suo identificatore di cache a hf cache rm. La documentazione attuale usa un identificatore di repository come:

hf cache rm model/gpt2

Per una pulizia più mirata, seleziona l'identificatore specifico della revisione indicato da hf cache ls --revisions. Leggi con attenzione l'anteprima e la conferma. La CLI può calcolare che cosa non sarà più referenziato; una selezione nel file system non può spiegarti queste relazioni.

Elimina le revisioni scollegate, non il tuo insieme di lavoro

hf cache prune prende di mira le revisioni a cui non fa più riferimento nulla. È lo strumento giusto per i dati di revisioni obsolete rimasti quando cambiano i riferimenti a branch o tag, ma non garantisce che scompaia ogni vecchio modello che non ricordi più. Eseguilo dopo aver controllato la rimozione proposta, non come riflesso automatico al termine di ogni sessione.

hf cache prune

Se la cache è gestita da più utenti, container o processi pianificati, interrompi prima i download attivi. Una pulizia eseguita mentre un altro processo sta materializzando uno snapshot crea ambiguità inutili, anche quando l'implementazione della cache è progettata per recuperare.

Verifica che cosa rimane

1. Esegui di nuovo hf cache ls e registra la nuova dimensione.
2. Usa hf cache verify <repo> per un repository conservato che ti interessa.
3. Avvia un flusso reale che carichi un modello conservato.
4. Controlla se parte un nuovo download: un modello che viene riscaricato senza avviso non era completamente disponibile in locale.

Scaricare di nuovo non è sempre un problema — la cache è una cache — ma è importante quando lavori offline, fissi una revisione specifica o dipendi da un file upstream che potrebbe scomparire.

La pulizia della cache e la conservazione a lungo termine risolvono problemi diversi

La cache Hub è ottimizzata per il riuso e il nuovo download. Non è un registro curato dei motivi per cui un modello, un tokenizer, una configurazione o un adapter facevano parte della stessa famiglia. Prima di svuotare una revisione difficile da riprodurre, identifica la famiglia completa necessaria per usarla. Per un adapter PEFT, può comprendere un modello di base compatibile e la configurazione; per un risultato di addestramento, può includere più dei soli pesi.

Tensor Archive deve stare dalla parte consapevole di questa distinzione. Conserva una famiglia locale completata, verifica l'archivio e dimostra un ripristino esatto. La cache può quindi tornare a essere un'infrastruttura eliminabile invece di un museo accidentale.

Guide correlate

Se la cache attuale si trova semplicemente sul disco sbagliato, segui la guida separata per cambiare la directory della cache di Hugging Face. Se la libreria si estende su più runtime, usa la checklist di conservazione prima di decidere che cosa sia soltanto uno stato di cache sostituibile.