Sådan rydder du Hugging Face-cachen på en Mac
AskClean-teamet · Opdateret 2026-11-02
Vil du frigøre plads fra Hugging Face-cachen på en Mac, så find den cache, som din app faktisk bruger, undersøg den med hf cache ls, og se en prøvekørsel for et bestemt repository eller en bestemt revision med hf cache rm --dry-run. Behold de offlinemodeller, du har brug for, og dit eget arbejde. Slet ikke delte blobs eller hele HF_HOME-mappen i blinde.

Find den rigtige cache, og beskyt dit eget arbejde
Den almindelige Hub-cache er ~/.cache/huggingface/hub. HF_HUB_CACHE vælger Hub-repositorycachen direkte, HF_HOME bestemmer placeringen af hele Hugging Face-hjemmemappen, og XDG_CACHE_HOME kan påvirke standarden, når HF_HOME ikke er sat; et eksplicit cache_dir-argument i en app kan også pege et andet sted hen. Tjek grafiske apps, notebook-kerner og kommandolinjeprojekter hver for sig — de kan have forskellige miljøindstillinger, og en tom standardmappe betyder ikke, at der ingen modeller er på din Mac. HF_HOME kan også indeholde loginoplysninger, så slet ikke hele mappen for at rydde modeldownloads, og del kun de relevante indstillinger uden følsomme værdier, hvis du beder om hjælp.
Hold downloads adskilt fra det, du selv har lavet: finjusterede checkpoints, adaptere, tokenizer-ændringer, konverteringer, private datasæt, notebooks, prompts og projektkonfiguration. En hentet basismodel kan hentes igen, men en lokal adapter eller en konverteringsopskrift findes måske kun på denne Mac. Tag en sikkerhedskopi, og kontroller den; nogle backupværktøjer springer caches med CACHEDIR.TAG over. Ved du ikke, hvordan du gendanner en post og får appen til at virke igen, så behold den indtil videre. En gammel adgangsdato betyder ikke, at en model er overflødig.
Vis fulde id'er og advarsler
Kør hf cache ls --no-truncate for at se de fulde repository-id'er og derefter hf cache ls --revisions --no-truncate --show-warnings for de fulde revisionshashes og eventuelle cacheproblemer; den testede version skjuler detaljerede advarsler som standard. Til en brugerdefineret Hub-cache giver du samme --cache-dir til hver kommando. Hold outputtet for dig selv, hvis det afslører fortrolige projekter.
En revisions viste størrelse kan være større end den plads, en sletning frigør: Snapshots — og i nogle layouts også repositories — kan dele blobs, så lægger du størrelserne sammen, kan de samme filer tælle flere gange. Undersøg advarsler om ulæselige eller inkonsistente poster, før du fjerner noget; en gennemført scanning beviser ikke, at alle filer blev genkendt.
- Luk de apps og job, der bruger den cache, du overvejer at rydde.
- Kør hf cache ls --no-truncate og derefter hf cache ls --revisions --no-truncate --show-warnings mod den bekræftede cachesti.
- Kontroller, om en app eller et projekt stadig har brug for det valgte repository og den valgte revision.
- Noter mappens nuværende størrelse og den ledige diskplads, før du ændrer noget.
Kommandoerne er afprøvet med huggingface_hub 2.0.0 den 29. september 2026. Kør hf cache --help i dit eget miljø først, og følg dokumentationen for din version, hvis kommandoer eller indstillinger er anderledes.
Se en prøvekørsel, før du bekræfter
Brug hf cache rm med ét fuldt repository-id eller én fuld revisionshash fra din oversigt, og tilføj --dry-run først. For et modelrepository beholder du præfikset model/, som CLI'en viser; et mappenavn, der begynder med models--, er ikke det samme id. For én revision bruger du den fulde hash og tjekker, hvilket repository den hører til.
Læs forhåndsvisningens oversigt over mål og anslået pladsbesparelse — den er ikke en liste over hver enkelt fil. Vælger du et repository, gælder det alle dets cachede revisioner, så vælg et revisionsmål, hvis du kun vil fjerne én. Når omfanget er kontrolleret, gentager du samme kommando med samme mål og cachemappe uden --dry-run og lader bekræftelsesspørgsmålet være slået til. Ændrer listen sig uventet, eller fejler forhåndsvisningen, så stop og find årsagen. Lad Hugging Face-cacheværktøjet håndtere delte blobs og snapshotreferencer; sletter du enkeltfiler i Finder, kan det ramme andre revisioner, der har brug for dem.
Oprydning i cachen sletter filer direkte — de flyttes ikke til papirkurven. For at gendanne en fjernet revision skal du have en brugbar sikkerhedskopi eller kunne hente den igen. Behold sikkerhedskopien, til dine tjek er bestået, især for modeller, der er private, kræver adgangsgodkendelse (gated), ikke længere er offentliggjort, er ændret lokalt eller skal bruges offline.
Vælg målet ud fra din egen cacheoversigt, og kontroller både repository og revision omhyggeligt, før du kører sletningen.
Brug prune med omtanke, og hold andre caches adskilt
I den testede version 2.0.0 viser hf cache prune --dry-run detached revisioner og ufuldstændige downloads. En detached revision har ingen navngiven reference i cachen, men dit projekt kan stadig bede om netop den revision, og CLI'en ved ikke, hvilke modeller du har tænkt dig at bruge. Ved den første oprydning er én eksplicit fjernelse lettere at vurdere end en bred oprydning: Kør bagefter den berørte app, og mål igen. Vælger du senere prune, så gennemgå alle kandidater, og stop aktive downloads først — en ufuldstændig fil kan stamme fra en afbrudt overførsel, men også fra et job, der stadig bruger cachen.
Hugging Face Datasets kan gemme behandlede data i sin egen cache (HF_DATASETS_CACHE), så sletning af Hub-downloads fjerner ikke nødvendigvis Arrow-data eller resultater fra en datasæt-pipeline. Downloads med et eksplicit local_dir havner i en mappe, du eller appen har valgt; behandl den separat, og bevar dine egne ændringer, for en ny download gendanner dem ikke. Xet-overførselslageret er også separat. Er forbruget stadig højt, så undersøg hver tilbageværende kategori for sig — sletning af hele HF_HOME erstatter ikke den gennemgang.
Tjek, at de resterende modeller virker
Gentag oversigten og målingerne, og indlæs en model og revision, du ville beholde. Kør en lille opgave med et kendt resultat — en vellykket Python-import tjekker ikke modelfilerne. Har du brug for offlineadgang, så test med netværket afbrudt, før du stoler på din Mac uden forbindelse. Henter næste kørsel den samme model igen, har oprydningen måske fjernet data, som arbejdet stadig skal bruge; så må du revurdere valget, lagerkapaciteten eller cachens placering i stedet for at slette og hente igen og igen.
Overstiger de modeller, du jævnligt bruger, din Macs kapacitet, kan en ekstern disk hjælpe. Tjek ledig plads, rettigheder og understøttelse af symbolske links, som kan forbinde snapshots med delte blobs, og bevar links og de filer, de peger på, når du kopierer. Konfigurer hver app til den nye placering, test de nødvendige modeller dér, før du fjerner originalen, og hold disken tilsluttet, når de pågældende apps skal bruge den. Fejler et tjek, så sæt oprydningen på pause, noter model, revision, cachesti og fejl lokalt, og løs problemet, før du fjerner endnu en post.
Sådan har vi afprøvet kommandoerne
Den 29. september 2026 testede vi offline en midlertidig cache i Hub-format med to syntetiske revisioner, én delt blob og én eksklusiv blob pr. revision. Med huggingface_hub 2.0.0 lykkedes listningen af revisioner, --show-warnings afslørede en bevidst beskadiget post, --no-truncate bevarede de fulde id'er, og prøvekørslerne med rm og prune ændrede ingenting. Fjernelse af den gamle revision bevarede den aktuelle revision og de delte data og slettede kun den gamle eksklusive blob. Rigtige modeldownloads, inferens, brugercaches, flytning til en anden disk og blobs delt mellem repositories blev ikke testet, og testen siger intet om, hvor mange gigabyte din Mac frigør; undersøg en beskadiget eller brugerdefineret cache, før du fjerner poster.
AskClean kan vise dig, hvor pladsen bruges på din Mac. Scanning og forhåndsvisning er gratis; AI-analyse og oprydning kræver Pro. Diskoprydning sletter de elementer, du bekræfter, permanent. Brug Hugging Face-CLI'en til cachede revisioner og deres delte filer, og hold dit eget projektarbejde uden for oprydningen.
Hvad der kan genskabes, og hvad der skal bevares
Kontroller hver kategori for sig. Tabellen forklarer, hvad du skal bevare eller kunne gendanne; den markerer ikke filer til automatisk sletning.
| Element | Her tjekker du | Det skal du kontrollere før fjernelse |
|---|---|---|
| Hub-repository eller -revision | hf cache ls --revisions | Kontroller det præcise valg. For at gendanne det skal du måske hente det igen og have adgang til samme repository. |
| Delte blobs og snapshots | Den bekræftede Hub-cache | Brug cacheværktøjet; revisioner og i nogle layouts også repositories kan dele de samme lagrede filer. |
| Detached revisioner | hf cache prune --dry-run | Et projekt kan stadig kræve en præcis revision, selv om cachen ikke har nogen navngiven reference til den. |
| Genereret datasætcache | HF_DATASETS_CACHE / cacheindstillinger i Datasets | Adskilt fra Hub-downloads; genskabelse kan kræve behandlingstid og kildedata. |
| Egne checkpoints, adaptere og kilder | Dine projekt- og backupplaceringer | Behold dit originale arbejde, og kontroller, at sikkerhedskopierne indeholder det — især hvis det ligger under en cachemappe. |
| Hugging Face-hjemmemappe og logintilstand | HF_HOME | Slet ikke hele hjemmemappen for at fjerne poster i modelcachen. |
Den lokale regressionstest brugte en lille syntetisk cache. Dens størrelse er hverken et benchmark eller et skøn over reelle besparelser.
FAQ
Kan jeg slette ~/.cache/huggingface på min Mac?
Betragt ikke hele mappen som noget, der kan smides væk. Find den aktive Hub-cache, bevar logintilstand og eget arbejde, og se derefter en prøvekørsel for bestemte repositories eller revisioner med den installerede hf cache-kommando.
Betyder en detached revision, at ingen app bruger den?
Nej. Et projekt kan fastlåse en præcis revision, selv om der ikke findes nogen navngiven reference i cachen. Kontroller projektets krav, før du kører prune.
Kan hf cache rm slette min finjusterede model?
Ja, hvis dine egne filer ligger i den valgte cachepost. Hold checkpoints, adaptere og ændrede filer uden for de poster, du vil fjerne, og kontroller sikkerhedskopierne. En mappe, der hedder cache, kan stadig rumme den eneste kopi af vigtigt arbejde.
Kilder