hf cache (ls, rm, prune, verify) în Hugging Face Hub & Transformers

hf cache ls [--revisions] [--filter EXPR] [--sort CHEIE] [--limit N]
hf cache rm ȚINTE... [--dry-run] [-y]
hf cache prune [--dry-run] [-y]
hf cache verify REPO_ID [--revision REV] [--local-dir DIR]

Ce face hf cache (ls, rm, prune, verify)

Cache-ul local păstrează modelele, dataset-urile, Spaces și kernels descărcate de pe Hub. hf cache ls (alias list) arată ce este stocat, agregat pe repository; cu --revisions coboară la nivel de revizie. Filtrele (--filter, de exemplu size>30g sau accessed>1y) se pot repeta, iar --sort și --limit restrâng rezultatul. Ieșirea poate fi tabel, JSON, CSV sau doar ID-uri (-q).

hf cache rm șterge repository-uri întregi (model/gpt2), revizii (hash) sau un singur fișier dat ca URI hf:// (de exemplu o singură cuantizare GGUF). hf cache prune eliberează spațiul ocupat de revizii detașate, de descărcări .incomplete rămase după întreruperi și de blob-uri partajate nefolosite. Ambele acceptă --dry-run și --yes.

hf cache verify compară fișierele locale cu sumele de control de pe Hub, fie dintr-un snapshot din cache, fie dintr-un director local (--local-dir). Aceste comenzi înlocuiesc vechile scan-cache și delete-cache din huggingface-cli.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
--cache-dir TEXT	Alt director de cache (ls, rm, prune, verify).
ls --revisions / --no-revisions	Afișează revizii în loc de repository-uri agregate.
ls -f, --filter TEXT	Filtru, de exemplu size>1GB, type=model, accessed>7d. Se poate repeta.
ls --sort [accessed|modified|name|size][:asc|:desc]	Ordonare. accessed, modified, size sunt implicit descrescătoare; name crescător.
ls --limit INTEGER	Primele N rezultate după ordonare.
ls --show-warnings	Arată avertismentele despre inconsecvențe în cache.
rm ȚINTE...	ID-uri de repository (model/bert-base-uncased), URI-uri hf:// (repository sau fișier) ori hash-uri de revizie.
rm / prune --dry-run	Previzualizare, fără ștergere.
rm / prune -y, --yes	Fără confirmare.
verify REPO_ID	Repository-ul de verificat.
verify --repo-type [model|dataset|space|kernel]	Tipul repository-ului.
verify --revision TEXT	Revizia verificată. Implicit main.
verify --local-dir TEXT	Verifică un director local în loc de cache.
verify --fail-on-missing-files	Eroare dacă lipsesc local fișiere existente pe Hub.
verify --fail-on-extra-files	Eroare dacă există local fișiere care nu sunt în revizie.

Exemple practice

Exemplul 1: Ce ocupă cache-ul

hf cache ls

Rezultat

ID                          SIZE     LAST_ACCESSED LAST_MODIFIED REFS
--------------------------- -------- ------------- ------------- -----------
dataset/nyu-mll/glue          157.4M 2 days ago    2 days ago    main script
model/LiquidAI/LFM2-VL-1.6B     3.2G 4 days ago    4 days ago    main
model/microsoft/UserLM-8b      32.1G 4 days ago    4 days ago    main

Found 3 repo(s) for a total of 5 revision(s) and 35.5G on disk.

Exemplul 2: Ștergerea repository-urilor neaccesate de un an

hf cache rm $(hf cache ls --filter "accessed>1y" -q) -y

Exemplul 3: Un singur fișier GGUF, cu previzualizare

hf cache rm hf://models/unsloth/gemma-3-27b-it-GGUF/gemma-3-27b-it-Q4_K_M.gguf --dry-run

Exemplul 4: Curățenie automată

hf cache prune

Exemplul 5: Verificare strictă a unui model

hf cache verify deepseek-ai/DeepSeek-OCR --fail-on-missing-files --fail-on-extra-files

Greșeli frecvente și bune practici

• Cauți hf cache scan sau hf cache delete. Au fost eliminate în v1.0; folosești ls, rm și prune.
• Ștergi manual din ~/.cache/huggingface/hub. Poți strica legăturile dintre snapshot-uri și blob-uri; hf cache rm ține cont de ele.
• La ștergerea unui fișier dai un director sau un model glob. Pentru fișiere, calea trebuie să fie exactă și nu se amestecă cu repository-uri sau revizii în același apel.

Comenzi înrudite

• hf-download
• hf-env-version-update
• huggingface-cli