De Hugging Face-cache op je Mac controleren en opruimen

De locatie en je eigen werk controleren

Gebruikelijk is ~/.cache/huggingface/hub. HF_HUB_CACHE kiest de repositorycache; HF_HOME omvat meer. Zonder HF_HOME kan XDG_CACHE_HOME de standaard beïnvloeden; cache_dir kan een andere locatie kiezen. Controleer grafische apps, terminal en notebook afzonderlijk. HF_HOME kan aanmeldgegevens bevatten: wis niet alles en publiceer de inhoud niet.

Zelf getrainde checkpoints, adapters, tokenizerwijzigingen, conversies, private gegevens en projectinstellingen zijn niet altijd opnieuw te downloaden. Controleer je back-up: sommige tools slaan caches met CACHEDIR.TAG over. Bewaar wat je niet aantoonbaar kunt herstellen; een oude toegangsdatum bewijst niet dat een model overbodig is.

Volledige ID’s en waarschuwingen tonen

Stop apps, downloads en taken die de cache gebruiken. Voer hf cache ls --no-truncate uit, gevolgd door hf cache ls --revisions --no-truncate --show-warnings. De geteste versie verbergt gedetailleerde waarschuwingen standaard. Gebruik steeds dezelfde --cache-dir voor een eigen locatie. Onderzoek lees- en structuurproblemen, noteer gebruik en vrije ruimte en houd private repositorylijsten vertrouwelijk.

De reikwijdte vooraf controleren

hf cache rm verwacht de volledige CLI-ID. Behoud model/ voor een modelrepository; een mapnaam met models-- is geen vervanging. Gebruik voor één revisie de volledige hash en controleer de repository. Begin met --dry-run. De uitvoer vat doelen en geschatte ruimtewinst samen en is geen lijst van elk bestand. Een repositorydoel omvat al zijn gecachte revisies.

Verwijder na controle alleen --dry-run; houd doel, pad en bevestigingsvraag gelijk. Stop bij een gewijzigde selectie of mislukte voorvertoning en zoek de oorzaak. Bestanden worden direct gewist, zonder prullenmand; herstel vraagt een back-up of nieuwe downloadtoegang. Snapshots en soms repositories delen blobs. Laat verwijzingen aan de cachebeheerder over en tel weergegeven groottes niet zomaar op.

Prune en andere caches onderscheiden

hf cache prune --dry-run toont in de geteste versie 2.0.0 detached revisies en onvoltooide downloads. Zonder benoemde verwijzing kan een project nog steeds een exacte revisie vastleggen. Controleer elk doel en stop actieve downloads. Begin met één duidelijk gekozen item.

Gegenereerde gegevens in HF_DATASETS_CACHE zijn iets anders dan Hub-downloads. Controleer Xet-overdrachtsgegevens en local_dir-uitvoer apart en bewaar lokale wijzigingen. Heel HF_HOME wissen vervangt die controle niet.

De bewaarde modellen werkelijk laden

Herhaal de metingen, laad benodigde modellen en revisies en voer een kleine taak met bekende uitkomst uit. Een Python-bibliotheek importeren is niet genoeg. Test offlinegebruik daadwerkelijk zonder netwerk. Stop bij fouten en controleer omgeving, paden, bestanden, toegang en ruimte vóór herstel. Steeds hetzelfde noodzakelijke model opnieuw downloaden vraagt om een andere selectie of opslagcapaciteit.

Controleer bij een externe schijf ruimte, rechten en symbolische links. Kopieer links én doelen, stel elke app in en test de benodigde modellen voordat je het origineel verwijdert. Houd de schijf tijdens gebruik aangesloten.

Wat is getest

Op 2026-09-29 zijn tijdelijke synthetische caches offline getest met huggingface_hub 2.0.0: lijsten, volledige ID’s, waarschuwingen en dry-run. Voorvertoningen wijzigden geen bestanden; na verwijdering van een oude revisie bleven de huidige en gedeelde gegevens intact. Echte inferentie, gebruikerscaches, gedeelde blobs tussen repositories en schijfmigratie zijn niet getest. Er is geen vaste ruimtewinst beloofd. Controleer jouw versie met hf cache --help.

Controleer dit vóór het verwijderen

Controleer de echte locatie, het gebruik en de herstelmogelijkheden. Dit is geen automatische verwijderlijst en geen belofte van een vaste ruimtewinst.

FAQ