AskClean

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.

Conceptillustratie van modelrevisies die gedeelde gegevensblokken gebruiken, met projectbestanden apart
Meerdere revisies kunnen dezelfde bestanden delen. Bewaar je eigen checkpoints en projectwerk afzonderlijk. Conceptillustratie.

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.

OnderdeelWaar controlerenWat je vóór verwijderen controleert
Hub-repository of -revisiehf cache ls --revisionsControleer de exacte selectie. Herstellen kan een nieuwe download en toegang tot dezelfde repository vereisen.
Gedeelde blobs en snapshotsGecontroleerde Hub-cacheGebruik de cachebeheerder: revisies, en in sommige indelingen ook repositories, kunnen dezelfde opgeslagen bestanden delen.
Detached revisieshf cache prune --dry-runEen project kan een exacte revisie nog nodig hebben, ook als de cache er geen benoemde verwijzing naar heeft.
Gegenereerde datasetcacheHF_DATASETS_CACHE / cache-instellingen van DatasetsStaat los van Hub-downloads; opnieuw maken kan verwerkingstijd en brongegevens vragen.
Eigen checkpoints, adapters en bronbestandenJe project- en back-uplocatiesBewaar je originele werk en controleer of back-ups het bevatten, vooral als het onder een cachemap staat.
Hugging Face-hoofdmap en aanmeldgegevensHF_HOMEWis 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

Meer gidsen over model- en ontwikkelaarsopslag