Dove si trova la directory della cache di Hugging Face?

Per Hugging Face Hub, la directory della cache predefinita documentata è ~/.cache/huggingface/hub. Tuttavia, la posizione attiva può essere sostituita, quindi controlla la configurazione e la cache stessa prima di considerare sacrificabile una cartella.

Percorso predefinito e override documentati

La cache Hub archivia repository scaricati di modelli, dataset e Space sotto la propria radice. La radice predefinita è ~/.cache/huggingface/hub. Al suo interno, i repository hanno comunemente nomi come models--organization--repository, con directory per blob, snapshot e riferimenti.

• HF_HUB_CACHE imposta direttamente la directory della cache Hub e ha priorità.
• HF_HOME imposta la home directory di Hugging Face; quando è impostata, la cache Hub si trova sotto HF_HOME/hub.
• Anche le singole chiamate alle librerie possono fornire una directory della cache, quindi un progetto può utilizzare un percorso diverso dal valore predefinito globale.

Controlla prima di liberare qualsiasi cosa

Usa la CLI di Hugging Face per vedere cosa conosce il suo gestore della cache riguardo alla cache attiva. Il comando documentato hf cache ls elenca repository nella cache, dimensioni e informazioni di accesso. Se hai spostato la cache, associa i comandi di gestione alla relativa opzione della directory della cache invece di presumere il valore predefinito.

# Mostra quale posizione userà questa shell
printf '%s\n' "${HF_HUB_CACHE:-${HF_HOME:-$HOME/.cache/huggingface}/hub}"

# Cataloga i repository nella cache prima della potatura
hf cache ls

Prima di rimuovere uno snapshot, identifica il progetto, il runtime e la revisione che lo utilizzano. Una cache può contenere più del file di modello che hai in mente e un albero sorgente o un flusso di inferenza locale può dipendere da una revisione nella cache non evidente da un browser di file.

Pulizia della cache e conservazione a lungo termine

La cache Hugging Face è ottimizzata per evitare download non necessari. Non è automaticamente un catalogo a lungo termine delle versioni dei modelli da conservare. Se un gruppo di artefatti completati è importante per il tuo lavoro, decidi prima cosa dovrai recuperare in seguito e mantieni un backup indipendente ove opportuno.

Tensor Archive interviene dopo tale decisione: può conservare una famiglia locale correlata, verificarla e ripristinare una copia esatta separata prima che tu elimini manualmente una copia di lavoro ridondante per liberare spazio. Non sostituisce la gestione della cache di Hugging Face né indica a una libreria attiva dove scaricare i modelli.

Una sequenza sicura

1. Controlla se HF_HUB_CACHE o HF_HOME modifica la posizione attiva.
2. Elenca la cache con gli strumenti Hugging Face e identifica i repository che non ti servono subito.
3. Conserva o sottoponi a backup indipendente ogni versione del modello importante.
4. Per una famiglia correlata completata, analizzala, archiviala, verificala e ripristina una copia separata prima di liberare manualmente spazio.

Se la cache si trova sul disco sbagliato, modifica la directory della cache di Hugging Face con la variabile d'ambiente corretta. Se il problema sono revisioni obsolete, cancella in sicurezza la cache di Hugging Face tramite il gestore della cache. I file appartenenti a un altro runtime richiedono la guida allo spazio di quel runtime.