AskClean

Come svuotare la cache di Hugging Face sul Mac

Team AskClean · Aggiornato 2026-11-02

Per recuperare lo spazio occupato dalla cache di Hugging Face sul Mac, individua la cache usata dalla tua applicazione, esaminala con hf cache ls e visualizza in anteprima un repository o una revisione precisi con hf cache rm --dry-run. Conserva i modelli che ti servono offline e il tuo lavoro. Non eliminare alla cieca i blob condivisi né l’intera cartella HF_HOME.

Illustrazione concettuale di revisioni di modelli collegate a blocchi di dati condivisi, con i file dei progetti tenuti a parte
Più revisioni possono condividere gli stessi file. Conserva a parte i tuoi checkpoint e il lavoro dei progetti. Illustrazione concettuale.

Individua la cache giusta e il lavoro da conservare

Il percorso abituale della cache dell’Hub è ~/.cache/huggingface/hub. HF_HUB_CACHE sceglie direttamente la cache dei repository; HF_HOME sposta l’intera cartella di Hugging Face e, se HF_HOME non è impostata, XDG_CACHE_HOME può cambiare il valore predefinito. Anche un argomento cache_dir nell’applicazione può indicare un’altra posizione. Controlla separatamente app grafiche, kernel dei notebook e progetti da riga di comando, perché possono usare ambienti diversi. HF_HOME può contenere anche dati di autenticazione: non eliminarla tutta per liberare i download dei modelli e non condividerne il contenuto quando chiedi aiuto.

Tieni separati i download dal lavoro che hai creato tu: checkpoint di fine-tuning, adapter, modifiche al tokenizer, conversioni, dataset privati, notebook, prompt e configurazioni dei progetti. Un modello di base si può riscaricare, un adapter locale forse no. Verifica i backup prima di liberare spazio: alcuni strumenti escludono le cache contrassegnate con CACHEDIR.TAG. Se non sai come ripristinare un elemento, per ora conservalo: una vecchia data di accesso non dimostra che un modello sia inutile.

Elenca repository e revisioni con gli ID completi

Chiudi le app, i download e i processi che usano la cache. Esegui hf cache ls --no-truncate per vedere gli identificativi completi dei repository, poi hf cache ls --revisions --no-truncate --show-warnings per gli hash completi delle revisioni e gli eventuali problemi della cache: nella versione provata gli avvisi dettagliati sono nascosti per impostazione predefinita. Con una cache personalizzata passa lo stesso --cache-dir a ogni comando. La dimensione mostrata per una revisione può superare lo spazio che la sua eliminazione libererebbe, perché le revisioni condividono file: non sommare le dimensioni. Annota spazio occupato e spazio libero e non pubblicare elenchi di repository privati.

Controlla l’ambito prima di confermare

hf cache rm accetta l’ID completo mostrato dalla CLI: per i repository di modelli mantieni il prefisso model/, perché il nome di una cartella che inizia con models-- non è lo stesso identificativo. Per una sola revisione usa l’hash completo e verifica a quale repository appartiene. Esegui prima il comando con --dry-run: ottieni un riepilogo degli obiettivi e dello spazio stimato, non un elenco dei singoli file. Selezionare un repository include tutte le sue revisioni in cache.

Dopo il controllo ripeti lo stesso comando senza --dry-run, con lo stesso obiettivo e lo stesso percorso, lasciando attiva la richiesta di conferma. Se l’elenco cambia o l’anteprima non riesce, fermati e indaga. I file vengono eliminati direttamente, senza passare dal Cestino: per ripristinarli servono un backup o un nuovo download. Lascia al gestore della cache i blob condivisi e i riferimenti degli snapshot: eliminare singoli file nel Finder può danneggiare altre revisioni.

Usa prune con cautela e tieni separate le altre cache

Nella versione 2.0.0 provata, hf cache prune --dry-run mostra le revisioni detached e i download incompleti. Una revisione detached non ha un riferimento con nome nella cache, ma un progetto può ancora richiederla esattamente: controlla ogni candidato, ferma i download attivi e, per la prima pulizia, preferisci una sola rimozione esplicita.

I dati elaborati in HF_DATASETS_CACHE sono diversi dai download dell’Hub, e i download con local_dir finiscono in una cartella scelta da te o dall’applicazione: gestiscili a parte e conserva le modifiche locali, che un nuovo download non ripristina. Anche lo spazio usato per i trasferimenti Xet è separato. Rimuovere revisioni dell’Hub non svuota necessariamente queste altre cache.

Verifica che i modelli conservati funzionino

Ripeti inventario e misure, poi carica i modelli e le revisioni che volevi conservare ed esegui un piccolo compito con un risultato noto: importare una libreria Python non basta. Se ti serve l’uso offline, provalo scollegando davvero la rete. Se l’esecuzione successiva riscarica lo stesso modello, la pulizia ha rimosso dati ancora necessari: rivedi la selezione o lo spazio disponibile invece di eliminare e riscaricare di continuo. Se una verifica non riesce, interrompi la pulizia e controlla ambiente, percorsi, file, accesso e spazio prima di ripristinare.

Se i modelli che usi spesso superano lo spazio del Mac, un disco esterno può aiutare: verifica spazio libero, permessi e supporto dei link simbolici, che collegano gli snapshot ai blob condivisi. Copia sia i link sia i file a cui puntano, configura ogni applicazione e prova i suoi modelli prima di rimuovere l’originale. Il disco deve restare collegato ogni volta che le applicazioni ne hanno bisogno.

Come abbiamo verificato questi comandi

Il 29 settembre 2026 abbiamo provato offline, con huggingface_hub 2.0.0, una cache temporanea in stile Hub con revisioni sintetiche: elenchi, ID completi, avvisi e dry-run. Le anteprime non hanno modificato alcun file e la rimozione della vecchia revisione ha conservato quella corrente e i dati condivisi. Non abbiamo verificato download di modelli reali, inferenza, la cache di un utente, migrazioni su disco o la pulizia di blob condivisi tra repository: nessuna quantità di spazio liberato è garantita. Prima di iniziare, controlla la tua versione con hf cache --help.

AskClean ti aiuta a vedere dove finisce lo spazio del Mac. Scansione e anteprima sono gratuite; analisi IA e pulizia richiedono Pro, e la pulizia del disco elimina definitivamente gli elementi che confermi. Per le revisioni in cache e i loro file condivisi usa la CLI di Hugging Face, e tieni il lavoro originale dei progetti fuori dalla selezione.

Cosa si può ricreare e cosa va conservato

Controlla ogni categoria separatamente. La tabella indica cosa conservare o come ripristinarlo; non segna file per l’eliminazione automatica.

ElementoDove controllareCosa verificare prima di rimuovere
Repository o revisione dell’Hubhf cache ls --revisionsVerifica la selezione esatta: ripristinarla può richiedere un nuovo download e l’accesso allo stesso repository.
Blob e snapshot condivisiCache dell’Hub verificataUsa il gestore della cache: le revisioni e, in alcuni formati, anche i repository possono condividere gli stessi file.
Revisioni detachedhf cache prune --dry-runUn progetto può richiedere una revisione precisa anche se la cache non ha un riferimento con nome.
Cache dei dataset generatiHF_DATASETS_CACHE / impostazioni della cache di DatasetsÈ separata dai download dell’Hub; ricrearla può richiedere tempo di elaborazione e i dati di origine.
Checkpoint, adapter e sorgenti personaliIl tuo progetto e i backupConserva il lavoro originale e verifica che i backup lo includano, soprattutto se si trova in una cartella di cache.
Cartella principale di Hugging Face e autenticazioneHF_HOMENon eliminare l’intera cartella per rimuovere voci della cache dei modelli.

La prova locale ha usato una piccola cache sintetica: le sue dimensioni non sono un benchmark né una stima del risparmio reale.

FAQ

Posso eliminare ~/.cache/huggingface sul Mac?

Non considerare usa e getta l’intera cartella. Individua la cache dell’Hub attiva, conserva i dati di autenticazione e il lavoro originale, poi visualizza in anteprima repository o revisioni precisi con l’interfaccia hf cache installata.

Perché rimuovere una revisione libera meno spazio di quello mostrato?

Le revisioni possono condividere file, e in alcuni formati lo fanno anche i repository. Controlla la stima dell’anteprima e confronta spazio occupato e disponibile prima e dopo: sommando le dimensioni delle revisioni conteresti più volte gli stessi file.

Una revisione detached non è usata da nessuna applicazione?

Non necessariamente: un progetto può fissare una revisione precisa anche senza un riferimento con nome nella cache. Controlla i requisiti del progetto prima di usare prune.

I miei modelli funzioneranno offline dopo la pulizia?

Solo i file in cache conservati e completi possono servire ai carichi di lavoro che ne hanno bisogno. Prova un caricamento offline rappresentativo prima di eliminare il backup o di affidarti al Mac senza connessione.

hf cache rm può eliminare il mio modello con fine-tuning?

Sì, se i tuoi file si trovano nella voce di cache selezionata. Tieni checkpoint, adapter e file modificati fuori dalle voci che intendi rimuovere e verifica i backup: anche una cartella che si chiama cache può contenere l’unica copia di un lavoro importante.

Fonti

Altre guide sullo spazio di modelli e strumenti di sviluppo