AskClean

Slik tømmer du Hugging Face-cachen på Mac

AskClean-teamet · Oppdatert 2026-11-02

Vil du frigjøre plass fra Hugging Face-cachen på Mac, finner du først cachen appen faktisk bruker, undersøker den med hf cache ls og forhåndsviser et bestemt repository eller en bestemt revisjon med hf cache rm --dry-run. Ta vare på modeller du trenger uten nett, og på ditt eget arbeid. Ikke slett delte blob-filer eller hele HF_HOME-mappen i blinde.

Konseptillustrasjon av modellrevisjoner koblet til delte datablokker, med prosjektfiler holdt for seg
Flere revisjoner kan dele de samme filene. Hold egne checkpoints og prosjektarbeid atskilt. Konseptillustrasjon.

Finn riktig cache og beskytt eget arbeid

Den vanlige Hub-cachen er ~/.cache/huggingface/hub. HF_HUB_CACHE velger repository-cachen direkte, HF_HOME endrer plasseringen av hele Hugging Face-hjemmemappen, og når HF_HOME ikke er satt, kan XDG_CACHE_HOME påvirke standarden. Et cache_dir-argument i en app kan også velge en annen plassering. Kontroller grafiske apper, notebook-kjerner og kommandolinjeprosjekter hver for seg – de kan ha ulike miljøinnstillinger, og en tom standardmappe betyr ikke at Macen ikke har modeller. HF_HOME kan også inneholde autentiseringsdata, så ikke slett hele mappen for å bli kvitt modellnedlastinger, og ikke del innholdet i supportsaker.

Skill nedlastinger fra det du har laget selv: finjusterte checkpoints, adaptere, tokenizer-endringer, konverteringer, private datasett, notebooks og prosjektinnstillinger. En nedlastet basismodell kan ofte hentes igjen, men en lokal adapter eller konverteringsoppskrift finnes kanskje bare på denne Macen. Sikkerhetskopier og kontroller dette arbeidet først; noen sikkerhetskopiverktøy hopper over cacher som er merket med CACHEDIR.TAG. Vet du ikke hvordan du gjenoppretter et element og får appen til å virke igjen, beholder du det inntil videre – og alder alene er ingen grunn til å slette en modell.

Undersøk repositoryer og revisjoner før du velger

Stopp apper, nedlastinger og jobber som bruker cachen. Kjør hf cache ls --no-truncate og deretter hf cache ls --revisions --no-truncate --show-warnings for å se fullstendige repository-ID-er, revisjons-hasher og eventuelle problemer i cachen; i den testede versjonen er detaljerte advarsler skjult som standard. Bruker du en egendefinert Hub-cache, sender du samme --cache-dir til alle kommandoene. En revisjon kan se større ut enn plassen du får tilbake, fordi snapshots kan dele data. Undersøk advarsler om uleselige eller inkonsistente oppføringer før du fjerner noe, noter brukt og ledig plass, og hold utdataene for deg selv hvis de avslører konfidensielle prosjekter.

Forhåndsvis fjerningen før du bekrefter

hf cache rm trenger én fullstendig repository-ID eller revisjons-hash fra oversikten din. For et modellrepository beholder du prefikset model/ som CLI-en viser; et mappenavn som begynner med models--, er ikke samme ID. For én revisjon bruker du hele hashen og sjekker hvilket repository den hører til. Begynn med --dry-run: Forhåndsvisningen oppsummerer målet og anslått frigjort plass, men lister ikke opp hver fil. Et repository som mål omfatter alle revisjonene av det i cachen, så bruk en revisjon som mål hvis du bare vil fjerne én.

Når omfanget er kontrollert, kjører du samme kommando uten --dry-run, med samme mål og cachemappe, og lar bekreftelsesspørsmålet stå på. Endrer listen seg uventet, eller feiler forhåndsvisningen, stopper du og finner årsaken. Revisjoner og noen repository-oppsett deler blob-filer, så la cachebehandleren håndtere referansene, og ikke slett enkeltfiler i Finder. Fjerningen sletter filene direkte – de havner ikke i Papirkurven – så du trenger en fungerende sikkerhetskopi eller en ny nedlasting for å få en revisjon tilbake. Behold sikkerhetskopien til kontrollene er bestått, særlig for modeller som er private, krever godkjenning (gated), ikke lenger er publisert, er endret lokalt eller trengs uten nett.

Gå gjennom prune og andre cacher hver for seg

I den testede versjonen 2.0.0 viser hf cache prune --dry-run frakoblede (detached) revisjoner og ufullstendige nedlastinger. En frakoblet revisjon har ingen navngitt referanse i cachen, men et prosjekt kan fortsatt be om akkurat den revisjonen. Kontroller hvert mål, og stopp aktive nedlastinger først – en ufullstendig fil kan høre til en overføring som fortsatt pågår. Ved første opprydding er én tydelig avgrenset fjerning lettere å vurdere enn en bred opprydding.

Genererte data i HF_DATASETS_CACHE er noe annet enn Hub-nedlastinger, og Xet-overføringslagring og nedlastinger med local_dir ligger også for seg. Undersøk hver kategori separat, og ta vare på lokale endringer – en ny nedlasting gjenoppretter ikke filer du har redigert. Å slette hele HF_HOME erstatter ikke denne gjennomgangen.

Kontroller at modellene du beholder, fortsatt virker

Gjenta oversikten og målingene, last inn en modell og revisjon du ville beholde, og kjør en liten oppgave med kjent resultat; en vellykket Python-import kontrollerer ikke modellfilene. Trenger du modellen uten nett, tester du med nettverket faktisk frakoblet. Lastes den samme modellen ned igjen ved neste kjøring, kan oppryddingen ha fjernet data arbeidet trenger – da bør du se på utvalget, lagringskapasiteten eller plasseringen av cachen. Feiler en kontroll, stopper du oppryddingen, noterer modell, revisjon, cachesti og feilmelding lokalt, og løser problemet før du fjerner noe mer.

Flytter du cachen til en ekstern disk, sjekker du ledig plass, rettigheter og støtte for symbolske lenker, som knytter snapshots til delte blob-filer. Bevar lenkene og filene de peker til når du kopierer, konfigurer hver app til å bruke den nye plasseringen, og test modellene der før du fjerner originalen. Disken må være tilkoblet når appene trenger den.

Slik kontrollerte vi kommandoene

Den 29. september 2026 testet vi huggingface_hub 2.0.0 uten nett på en midlertidig, syntetisk Hub-cache med to revisjoner: Revisjonslisten, fullstendige ID-er, advarsler og dry-run fungerte som beskrevet. Forhåndsvisningene endret ingen filer, og fjerning av den gamle revisjonen beholdt den gjeldende revisjonen og de delte dataene. Vi har ikke testet ekte modellnedlastinger, inferens, brukernes cacher, blob-filer som deles mellom repositoryer, eller flytting til en annen disk, og vi lover ingen bestemt mengde frigjort plass. Kjør hf cache --help først; har din versjon andre kommandoer eller valg, følger du dokumentasjonen for den.

AskClean kan vise hvor plassen på Macen brukes. Skanning og forhåndsvisning er gratis, mens AI-analyse og opprydding krever Pro, og elementer du bekrefter i diskoppryddingen, slettes permanent. Bruk Hugging Face-CLI-en til revisjonene i cachen og de delte filene, og hold originalt prosjektarbeid utenfor oppryddingen.

Hva som kan gjenskapes, og hva du må beholde

Kontroller hver kategori for seg. Tabellen viser hva du må bevare eller kunne gjenopprette; den markerer ingen filer for automatisk sletting og lover ingen bestemt mengde ledig plass.

ElementHvor du sjekkerHva du må kontrollere før fjerning
Hub-repository eller revisjonhf cache ls --revisionsKontroller nøyaktig hva som er valgt. Å få det tilbake kan kreve en ny nedlasting og tilgang til samme repository.
Delte blob-filer og snapshotsKontrollert Hub-cacheBruk cachebehandleren; revisjoner – og i noen oppsett repositoryer – kan dele de samme lagrede filene.
Frakoblede (detached) revisjonerhf cache prune --dry-runEt prosjekt kan fortsatt trenge en bestemt revisjon selv om cachen ikke har noen navngitt referanse til den.
Generert datasettcacheHF_DATASETS_CACHE / cacheinnstillinger i DatasetsAtskilt fra Hub-nedlastinger; å lage den på nytt kan kreve behandlingstid og kildedata.
Egne checkpoints, adaptere og kildefilerProsjektet ditt og sikkerhetskopieneBehold originalarbeidet ditt. Kontroller at sikkerhetskopiene inneholder det, særlig når det ligger i en cachemappe.
Hugging Face-hjemmemappen og autentiseringsdataHF_HOMEIkke slett hele hjemmemappen for å fjerne modeller fra cachen.

Den lokale testen brukte en liten syntetisk cache. Størrelsen på den er ingen referansemåling og intet anslag over hva du faktisk sparer.

Vanlige spørsmål

Kan jeg slette ~/.cache/huggingface på Macen?

Ikke behandle hele mappen som noe som kan kastes. Finn den aktive Hub-cachen, ta vare på autentiseringsdata og originalt arbeid, og forhåndsvis deretter bestemte repositoryer eller revisjoner med hf cache-kommandoene du har installert.

Betyr en frakoblet (detached) revisjon at ingen app bruker den?

Nei. Et prosjekt kan låse en bestemt revisjon selv om cachen ikke har noen navngitt referanse til den. Kontroller hva prosjektet krever, før du kjører prune.

Kan hf cache rm slette modellen jeg har finjustert?

Ja, hvis filene dine ligger i oppføringen du har valgt. Hold checkpoints, adaptere og endrede filer utenfor oppføringer du skal fjerne, og kontroller sikkerhetskopiene. En mappe som heter cache, kan likevel inneholde den eneste kopien av viktig arbeid.

Kilder

Flere guider om lagring av modeller og utviklerdata