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.

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.
- Zavřete aplikace a úlohy, které mezipaměť používají, a zastavte probíhající stahování.
- Na ověřené cestě spusťte hf cache ls --no-truncate a potom hf cache ls --revisions --no-truncate --show-warnings.
- Ověřte, zda vybraný repozitář a revizi ještě nepotřebuje nějaká aplikace nebo projekt.
- 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žka | Kde zkontrolovat | Co ověřit před odstraněním |
|---|---|---|
| Repozitář nebo revize Hubu | hf cache ls --revisions | Ověř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 snapshoty | Ověřená mezipaměť Hubu | Použí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) revize | hf cache prune --dry-run | Projekt může přesnou revizi potřebovat, i když na ni v mezipaměti nevede pojmenovaná reference. |
| Mezipaměť generovaných datových sad | HF_DATASETS_CACHE / nastavení mezipaměti Datasets | Je oddělená od stažení z Hubu; obnova může vyžadovat čas na zpracování a zdrojová data. |
| Vlastní checkpointy, adaptéry a zdroje | Váš projekt a umístění záloh | Pů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í údaje | HF_HOME | Kvů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