De Hugging Face-cache op je Mac veilig wissen
AskClean-team · Bijgewerkt 2026-11-02
Wil je ruimte terugwinnen uit de Hugging Face-cache op je Mac, zoek dan eerst de cache die je app echt gebruikt, inventariseer die met hf cache ls en controleer een specifieke repository of revisie vooraf met hf cache rm --dry-run. Bewaar modellen die je offline nodig hebt en je eigen werk. Verwijder geen gedeelde blobs met de hand en wis niet zomaar de hele HF_HOME-map.

De locatie en je eigen werk controleren
De Hub-cache staat meestal in ~/.cache/huggingface/hub. HF_HUB_CACHE wijst de repositorycache rechtstreeks aan; HF_HOME verplaatst de bredere Hugging Face-hoofdmap, en zonder HF_HOME kan XDG_CACHE_HOME de standaardlocatie beïnvloeden. Ook een cache_dir-argument in een app kan een andere locatie kiezen. Controleer grafische apps, notebookkernels en terminalprojecten afzonderlijk: ze kunnen andere omgevingsinstellingen gebruiken, en een lege standaardmap betekent niet dat er geen modellen op je Mac staan. HF_HOME kan ook aanmeldgegevens bevatten: wis die map niet in zijn geheel om modeldownloads op te ruimen en deel de inhoud niet in supportvragen.
Zelf bijgetrainde (fine-tuned) checkpoints, adapters, tokenizerwijzigingen, conversieresultaten, private datasets, notebooks, prompts en projectinstellingen kun je niet opnieuw downloaden: een basismodel misschien wel, maar een lokale adapter bestaat vaak alleen op deze Mac. Controleer je back-up: sommige back-uptools slaan caches met CACHEDIR.TAG over. Weet je niet hoe je iets herstelt, bewaar het dan voorlopig; 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. In de geteste versie zijn gedetailleerde waarschuwingen standaard verborgen. Geef bij een eigen Hub-cache bij elke opdracht dezelfde --cache-dir mee. Onderzoek waarschuwingen over onleesbare of inconsistente items voordat je iets verwijdert, noteer het mapgebruik en de vrije ruimte, en houd de uitvoer privé als die vertrouwelijke projecten prijsgeeft. Kies dan een specifiek doel, zoals een verlaten experiment of een revisie die je project niet meer gebruikt, en controleer code en configuratie op vastgepinde revisies.
Een verwijdering vooraf bekijken
hf cache rm verwacht de volledige ID uit de CLI. Behoud het voorvoegsel model/ bij een modelrepository; een mapnaam die met models-- begint, is niet dezelfde ID. Gebruik voor één revisie de volledige hash en controleer bij welke repository die hoort. Begin met --dry-run. De uitvoer vat de doelen en de geschatte ruimtewinst samen; het is geen lijst van elk bestand. Een repository als doel omvat al zijn gecachete revisies.
Herhaal na controle dezelfde opdracht zonder --dry-run, met hetzelfde doel en dezelfde cachemap, en laat de bevestigingsvraag aan staan. Verandert de lijst onverwacht of mislukt de voorvertoning, stop dan en zoek de oorzaak. Bestanden worden direct gewist, niet naar de Prullenmand verplaatst: herstellen vraagt een werkende back-up of een nieuwe download. Bewaar een back-up tot je controles slagen, zeker voor private, afgeschermde (gated), niet meer gepubliceerde, lokaal aangepaste of offline benodigde modellen. Snapshots, en soms ook repositories, delen blobs: laat die verwijzingen aan de cachebeheerder over en tel getoonde groottes niet zomaar op.
Prune en andere caches onderscheiden
hf cache prune --dry-run toont in de geteste versie 2.0.0 detached revisies (zonder benoemde verwijzing) en onvoltooide downloads. Ook zonder benoemde verwijzing kan een project een exacte revisie nog opvragen. Controleer elk doel, stop actieve downloads en begin bij een eerste opruiming met één duidelijk gekozen item.
Gegenereerde gegevens in HF_DATASETS_CACHE zijn iets anders dan Hub-downloads. Controleer Xet-overdrachtsgegevens en uitvoer in een local_dir apart en bewaar lokale wijzigingen; een nieuwe download herstelt je eigen aanpassingen niet. Heel HF_HOME wissen vervangt die controle niet.
Controleer of je bewaarde modellen nog werken
Herhaal de metingen, laad de modellen en revisies die je wilde bewaren en voer een kleine taak met een bekende uitkomst uit; alleen een Python-bibliotheek importeren test de modelbestanden niet. Heb je offline toegang nodig, test dan echt zonder netwerk. Mislukt een controle, stop dan en controleer omgeving, paden, bestanden, toegang en vrije ruimte voordat je herstelt of iets anders verwijdert. Downloadt de volgende run hetzelfde model opnieuw, dan heb je iets verwijderd wat nog nodig was: pas dan je selectie, opslagcapaciteit of cachelocatie aan.
Gebruik je een externe schijf, controleer dan vrije ruimte, rechten en ondersteuning voor symbolische links. Kopieer links én de bestanden waarnaar ze verwijzen, stel elke app in op de nieuwe locatie en test de benodigde modellen daar voordat je het origineel verwijdert. Houd de schijf aangesloten wanneer die apps hem nodig hebben.
Hoe we deze opdrachten hebben getest
Op 2026-09-29 zijn tijdelijke synthetische caches offline getest met huggingface_hub 2.0.0: lijsten, volledige ID’s, waarschuwingen en dry-runs. Voorvertoningen wijzigden geen bestanden; na verwijdering van een oude revisie bleven de huidige revisie en de gedeelde gegevens intact. Echte modeldownloads, inferentie, gebruikerscaches, blobs die tussen repositories worden gedeeld en schijfmigratie zijn niet getest. Er wordt geen vaste ruimtewinst beloofd. Voer eerst hf cache --help uit; biedt jouw versie andere opdrachten of opties, volg dan de documentatie daarvan.
Wat opnieuw te maken is en wat je moet bewaren
Controleer elke categorie afzonderlijk. De tabel laat zien wat je moet bewaren of herstellen; hij markeert geen bestanden om automatisch te verwijderen.
| Onderdeel | Waar controleren | Wat je vóór verwijderen controleert |
|---|---|---|
| Hub-repository of -revisie | hf cache ls --revisions | Controleer de exacte selectie. Herstellen kan een nieuwe download en toegang tot dezelfde repository vereisen. |
| Gedeelde blobs en snapshots | Gecontroleerde Hub-cache | Gebruik de cachebeheerder: revisies, en in sommige indelingen ook repositories, kunnen dezelfde opgeslagen bestanden delen. |
| Detached revisies | hf cache prune --dry-run | Een project kan een exacte revisie nog nodig hebben, ook als de cache er geen benoemde verwijzing naar heeft. |
| Gegenereerde datasetcache | HF_DATASETS_CACHE / cache-instellingen van Datasets | Staat los van Hub-downloads; opnieuw maken kan verwerkingstijd en brongegevens vragen. |
| Eigen checkpoints, adapters en bronbestanden | Je project- en back-uplocaties | Bewaar je originele werk en controleer of back-ups het bevatten, vooral als het onder een cachemap staat. |
| Hugging Face-hoofdmap en aanmeldgegevens | HF_HOME | Wis niet de hele hoofdmap om modelcache-items te verwijderen. |
De lokale regressietest gebruikte een kleine synthetische cache. De grootte daarvan is geen benchmark en geen schatting van wat je in de praktijk terugwint.
Veelgestelde vragen
Kan ik ~/.cache/huggingface op mijn Mac verwijderen?
Behandel de hele map niet als wegwerpcache. Zoek de actieve Hub-cache, bewaar aanmeldgegevens en origineel werk, en bekijk daarna specifieke repositories of revisies vooraf met de geïnstalleerde hf cache-opdrachten.
Waarom komt er minder ruimte vrij dan de getoonde grootte van een revisie?
Revisies kunnen bestanden delen, en in sommige cache-indelingen geldt dat ook tussen repositories. Kijk naar de schatting in de voorvertoning en vergelijk het schijfgebruik en de vrije ruimte vóór en na. Getoonde groottes optellen kan dezelfde bestanden dubbel tellen.
Wordt een detached revisie door geen enkele app meer gebruikt?
Niet per se. Een project kan een exacte revisie vastleggen zonder benoemde cacheverwijzing. Controleer de eisen van je project voordat je hf cache prune uitvoert.
Kan hf cache rm mijn eigen bijgetrainde model wissen?
Ja, als je eigen bestanden in het geselecteerde cache-item staan. Houd checkpoints, adapters en aangepaste bestanden buiten items die je wilt verwijderen en controleer hun back-ups. Ook een map die “cache” heet, kan de enige kopie van belangrijk werk bevatten.
Bronnen