AskClean

Jak zkontrolovat a vyčistit mezipaměť Hugging Face na Macu

Tým AskClean · Aktualizováno 2026-11-02

Chcete-li na Macu uvolnit místo zabrané mezipamětí Hugging Face, zjistěte, kterou mezipaměť vaše aplikace používá, prohlédněte ji příkazem hf cache ls a konkrétní repozitář nebo revizi si nejdřív zobrazte v náhledu hf cache rm --dry-run. Zachovejte modely potřebné offline i vlastní práci. Sdílené bloby ani celou složku HF_HOME nemažte naslepo.

Koncepční ilustrace revizí modelu propojených se sdílenými bloky dat a odděleně uložených projektových souborů
Více revizí může sdílet stejné soubory. Vlastní checkpointy a projektovou práci uchovávejte odděleně. Koncepční ilustrace.

Najděte používanou mezipaměť a chraňte vlastní práci

Obvyklá mezipaměť Hubu je ~/.cache/huggingface/hub. HF_HUB_CACHE určuje přímo mezipaměť repozitářů Hubu, HF_HOME mění širší domovskou složku Hugging Face a bez nastaveného HF_HOME může výchozí umístění ovlivnit XDG_CACHE_HOME; jiné umístění může zvolit i argument cache_dir v aplikaci. Grafické aplikace, kernely notebooků a projekty v příkazové řádce kontrolujte zvlášť – mohou mít jiné nastavení prostředí. Složka HF_HOME může obsahovat i přihlašovací údaje, proto ji nemažte celou a její obsah nesdílejte.

Stažené modely oddělte od toho, co jste vytvořili sami: doladěných checkpointů, adaptérů, úprav tokenizéru, výstupů konverzí, soukromých datových sad, notebooků a konfigurace projektu. Základní model lze často stáhnout znovu, místní adaptér nebo postup konverze ale může existovat jen na tomto Macu. Ověřte, že je vaše záloha opravdu obsahuje – některé zálohovací nástroje přeskakují mezipaměti označené souborem CACHEDIR.TAG. Co neumíte obnovit, zatím ponechte; samotné staré datum přístupu neznamená, že model nepotřebujete.

Než něco vyberete, projděte repozitáře a revize

Výpis hf cache ls --no-truncate ukáže úplné identifikátory repozitářů, hf cache ls --revisions --no-truncate --show-warnings úplné hashe revizí i problémy mezipaměti; testovaná verze podrobná varování ve výchozím stavu skrývá. U vlastního umístění předávejte každému příkazu stejnou hodnotu --cache-dir. Varování o nečitelných nebo nekonzistentních položkách prošetřete před mazáním a výpis, který prozrazuje důvěrné projekty, nikomu neposílejte.

  1. Zavřete aplikace a úlohy, které mezipaměť používají, a zastavte probíhající stahování.
  2. Na ověřené cestě spusťte hf cache ls --no-truncate a potom hf cache ls --revisions --no-truncate --show-warnings.
  3. Ověřte, zda vybraný repozitář a revizi ještě nepotřebuje nějaká aplikace nebo projekt.
  4. Než cokoli změníte, zapište si velikost složky a volné místo na disku.

Příkazy jsme ověřili s huggingface_hub 2.0.0 dne 29. září 2026. Nejdřív ve svém prostředí spusťte hf cache --help; pokud vaše verze nabízí jiné příkazy nebo volby, řiďte se její dokumentací.

Odstranění si nejdřív zobrazte v náhledu

hf cache rm vyžaduje úplné ID repozitáře nebo hash revize z výpisu. U modelového repozitáře ponechte předponu model/, kterou zobrazuje CLI – název složky na disku začínající models-- není totéž ID. U jedné revize použijte její úplný hash a ověřte, ke kterému repozitáři patří. Nejdřív přidejte --dry-run: náhled shrne cíle a odhad uvolněného místa, nejde ale o seznam jednotlivých souborů. Cíl typu repozitář zahrnuje všechny jeho uložené revize.

Po kontrole rozsahu spusťte stejný příkaz bez --dry-run se stejným cílem i cestou a potvrzovací otázku nechte zapnutou. Pokud se výběr nečekaně změní nebo náhled selže, zastavte se a zjistěte příčinu. Soubory se mažou přímo, do Koše se nepřesouvají; obnova vyžaduje zálohu nebo nové stažení. Zálohu si nechte, dokud kontroly neprojdou – zejména u soukromých, omezeně přístupných (gated), už nepublikovaných, místně upravených nebo offline potřebných modelů. Revize, a v některých uspořádáních i repozitáře, mohou sdílet stejné bloby, proto sdílené soubory a odkazy snapshotů nechte na správci mezipaměti a zobrazené velikosti revizí prostě nesčítejte.

Prune a další mezipaměti posuzujte zvlášť

V ověřené verzi 2.0.0 zobrazí hf cache prune --dry-run odpojené (detached) revize a nedokončená stahování. Odpojená revize nemá v mezipaměti pojmenovanou referenci, váš projekt ji ale přesto může vyžadovat. Při prvním úklidu je jedno jasně určené odstranění snáze vyhodnotitelné než plošné čištění; před prune zkontrolujte každého kandidáta a zastavte aktivní stahování – nedokončený soubor může patřit přenosu, který ještě běží.

Datové sady zpracované knihovnou Datasets mají vlastní mezipaměť (HF_DATASETS_CACHE), která se liší od stažení z Hubu. Zvlášť posuďte také přenosová data Xet a složky stažené s parametrem local_dir; místní úpravy stažených souborů zachovejte, nové stažení je nevrátí. Smazání celého HF_HOME tuto kontrolu nenahradí.

Ověřte, že ponechané modely fungují

Zopakujte výpis a měření, načtěte model a revizi, které jste chtěli ponechat, a spusťte malou úlohu se známým výsledkem; samotný import knihovny v Pythonu soubory modelu neověří. Pokud potřebujete offline přístup, vyzkoušejte to se skutečně odpojenou sítí. Když se při dalším spuštění stejný model stahuje znovu, úklid odstranil data, která úloha potřebuje – přehodnoťte výběr, kapacitu nebo umístění mezipaměti. Pokud kontrola selže, úklid přerušte a chybu vyřešte dřív, než smažete další položku.

Pokud se potřebné modely na Mac nevejdou, může pomoci externí disk. Ověřte volné místo, oprávnění a podporu symbolických odkazů, které propojují snapshoty se sdílenými bloby; při kopírování zachovejte odkazy i soubory, na které ukazují. Každou aplikaci nastavte na nové umístění, vyzkoušejte v něm její modely a teprve potom smažte originál. Disk musí být připojený, kdykoli ho aplikace potřebují.

Jak jsme příkazy ověřili

29. září 2026 jsme s huggingface_hub 2.0.0 offline vytvořili dočasnou syntetickou mezipaměť ve stylu Hubu a ověřili výpis revizí, úplná ID, varování a náhledy --dry-run. Náhledy soubory neměnily a odstranění staré revize zachovalo aktuální revizi i sdílená data. Netestovali jsme skutečná stažení modelů, inferenci, uživatelskou mezipaměť, migraci na jiný disk ani bloby sdílené mezi repozitáři, takže výsledek nepředpovídá, kolik místa uvolníte.

AskClean vám pomůže zjistit, co na Macu zabírá místo. Skenování a náhled jsou zdarma, analýza AI a čištění vyžadují verzi Pro. Potvrzené položky úklidu disku se mažou trvale. Revize v mezipaměti a jejich sdílené soubory spravujte přes CLI Hugging Face a původní projektovou práci do výběru k úklidu nezahrnujte.

Co lze obnovit a co musíte zachovat

Každou kategorii posuďte zvlášť. Tabulka vysvětluje, co je potřeba zachovat nebo obnovit; neoznačuje soubory k automatickému smazání.

PoložkaKde zkontrolovatCo ověřit před odstraněním
Repozitář nebo revize Hubuhf cache ls --revisionsOvěřte přesný výběr. Obnova může vyžadovat nové stažení a přístup ke stejnému repozitáři.
Sdílené bloby a snapshotyOvěřená mezipaměť HubuPoužívejte správce mezipaměti; revize a v některých uspořádáních i repozitáře mohou sdílet stejné uložené soubory.
Odpojené (detached) revizehf cache prune --dry-runProjekt může přesnou revizi potřebovat, i když na ni v mezipaměti nevede pojmenovaná reference.
Mezipaměť generovaných datových sadHF_DATASETS_CACHE / nastavení mezipaměti DatasetsJe oddělená od stažení z Hubu; obnova může vyžadovat čas na zpracování a zdrojová data.
Vlastní checkpointy, adaptéry a zdrojeVáš projekt a umístění zálohPůvodní práci zachovejte. Ověřte, že ji zálohy obsahují, zvlášť pokud leží ve složce mezipaměti.
Domovská složka Hugging Face a přihlašovací údajeHF_HOMEKvůli odstranění položek mezipaměti nemažte celou domovskou složku.

Místní test použil malou syntetickou mezipaměť. Její velikost není měřítkem ani odhadem skutečné úspory místa.

Časté dotazy

Mohu na Macu smazat ~/.cache/huggingface?

Celou složku nepovažujte za postradatelnou. Najděte aktivní mezipaměť Hubu, zachovejte přihlašovací údaje a vlastní práci a konkrétní repozitáře nebo revize si zobrazte v náhledu nainstalovaného rozhraní hf cache.

Proč odstranění revize uvolní méně místa, než ukazuje její velikost?

Revize mohou sdílet soubory, v některých uspořádáních i napříč repozitáři. Řiďte se odhadem v náhledu a porovnejte využití disku a volné místo před úklidem a po něm; sečtené velikosti revizí mohou stejné soubory započítat vícekrát.

Znamená odpojená (detached) revize, že ji nic nepoužívá?

Ne nutně. Projekt může vyžadovat přesnou revizi, i když na ni v mezipaměti nevede pojmenovaná reference. Před prune zkontrolujte požadavky projektu.

Může hf cache rm smazat můj doladěný model?

Ano, pokud vaše vlastní soubory leží ve vybrané položce mezipaměti. Checkpointy, adaptéry a upravené soubory držte mimo položky, které chcete odstranit, a ověřte jejich zálohy. I složka s názvem cache může obsahovat jedinou kopii důležité práce.

Zdroje

Další návody k úložišti modelů a vývojářských nástrojů