Kontrollera och rensa Hugging Face-cache på Mac

Hitta platsen och skydda eget arbete

Den vanliga platsen är ~/.cache/huggingface/hub. HF_HUB_CACHE anger repositorycachen; HF_HOME omfattar mer. Utan HF_HOME kan XDG_CACHE_HOME påverka standarden, och cache_dir kan välja en annan plats. Kontrollera grafiska appar, terminal och notebook var för sig. HF_HOME kan innehålla autentiseringsuppgifter: radera inte allt och publicera inte innehållet.

Egna checkpoints, adaptrar, tokenizerändringar, konverteringar, privata data och projektinställningar kan vara omöjliga att ladda ner igen. Kontrollera säkerhetskopian eftersom vissa verktyg hoppar över cache med CACHEDIR.TAG. Behåll sådant du inte vet hur du återställer; gammal åtkomsttid bevisar inte att en modell är överflödig.

Visa fullständiga ID:n och varningar

Stoppa appar, nedladdningar och jobb som använder cachen. Kör hf cache ls --no-truncate följt av hf cache ls --revisions --no-truncate --show-warnings. Den testade versionen döljer detaljerade varningar som standard. Använd samma --cache-dir för en egen plats i alla kommandon. Undersök läs- och strukturfel, notera använt och ledigt utrymme och håll privata repositorylistor för dig själv.

Kontrollera omfattningen före bekräftelse

hf cache rm behöver hela ID:t från CLI. Behåll model/ för modellrepositoryn; ett mappnamn med models-- ersätter det inte. För en revision använder du fullständig hash och kontrollerar repositoryn. Börja med --dry-run. Utdata är en sammanfattning av mål och uppskattat utrymme, inte en lista över varje fil. Ett repositorymål omfattar alla dess cachade revisioner.

Efter kontroll tar du bort --dry-run men behåller mål, sökväg och bekräftelsefråga. Om urvalet ändras eller förhandsvisningen misslyckas ska du stoppa raderingen och undersöka orsaken. Filer tas bort direkt utan papperskorg; återställning kräver säkerhetskopia eller ny nedladdningsåtkomst. Snapshots och ibland repositoryn delar blobbar. Låt cachehanteraren sköta referenserna och summera inte visade storlekar rakt av.

Skilj prune från andra cachetyper

I den testade versionen 2.0.0 visar hf cache prune --dry-run detached-revisioner och ofullständiga nedladdningar. Ett projekt kan låsa en exakt revision även utan namngiven referens. Granska varje mål och stoppa aktiva nedladdningar. Börja med ett enda tydligt valt objekt.

Genererade data i HF_DATASETS_CACHE skiljer sig från Hub-nedladdningar. Granska Xet-överföringar och local_dir-utdata separat och bevara lokala ändringar. Att radera hela HF_HOME ersätter inte denna kontroll.

Ladda modellerna som ska vara kvar

Upprepa mätningen, ladda nödvändiga modeller och revisioner och kör en liten uppgift med känt resultat. En lyckad Python-import räcker inte. Testa offlineanvändning med nätverket frånkopplat. Stoppa rensningen vid fel och kontrollera miljö, sökväg, filer, åtkomst och utrymme före återställning. Ständig ominladdning av en behövd modell kräver ett annat urval eller mer kapacitet.

Kontrollera utrymme, rättigheter och symboliska länkar vid flytt till extern disk. Kopiera länkar med deras mål, konfigurera varje app och testa modellerna innan originalet tas bort. Disken måste vara ansluten under användningen.

Vad som har verifierats

Den 2026-09-29 testades temporära syntetiska cacher offline med huggingface_hub 2.0.0: listor, fullständiga ID:n, varningar och dry-run. Förhandsvisningarna ändrade inga filer; borttagning av en äldre revision bevarade den aktuella och delade data. Verklig inferens, användarcacher, delade blobbar mellan repositoryn och diskflytt har inte testats. Ingen fast utrymmesvinst garanteras. Kontrollera din version med hf cache --help.

Kontrollera före borttagning

Kontrollera verklig plats, användning och återställning. Tabellen är ingen lista för automatisk radering och lovar inte en viss mängd ledigt utrymme.

Vanliga frågor