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

Najděte data a chraňte vlastní práci

Obvyklá cesta je ~/.cache/huggingface/hub. HF_HUB_CACHE určuje mezipaměť repozitářů; HF_HOME zahrnuje více dat. Bez HF_HOME může výchozí umístění ovlivnit XDG_CACHE_HOME, zatímco cache_dir může vybrat jiné. Grafické aplikace, terminál a notebook ověřte samostatně. HF_HOME může obsahovat přihlašovací údaje: nemažte jej celý ani nezveřejňujte obsah.

Vlastní checkpoint, adapter, úpravy tokenizeru, konverze, soukromá data a nastavení nemusí jít znovu stáhnout. Ověřte zálohy: některé nástroje přeskočí mezipaměti s CACHEDIR.TAG. Ponechte vše bez známého způsobu obnovy; staré datum přístupu samo neznamená nepotřebný model.

Zobrazte úplná ID a varování

Zastavte aplikace, stahování a úlohy používající mezipaměť. Spusťte hf cache ls --no-truncate a poté hf cache ls --revisions --no-truncate --show-warnings. Testovaná verze podrobná varování ve výchozím stavu skrývá. Pro vlastní umístění vždy používejte stejný --cache-dir. Prošetřete chyby čtení a struktury, zaznamenejte obsazené a volné místo a nezveřejňujte seznamy soukromých repozitářů.

Ověřte rozsah před potvrzením

hf cache rm vyžaduje úplné ID z CLI. Pro modelový repozitář ponechte model/; název složky začínající models-- není náhradou. Pro jednu revizi použijte úplný hash a ověřte její repozitář. Začněte s --dry-run. Výstup shrnuje cíle a odhad místa, nejde o seznam jednotlivých souborů. Repozitářový cíl zahrnuje všechny jeho uložené revize.

Po kontrole odeberte pouze --dry-run a zachovejte cíl, cestu i potvrzovací otázku. Při změně výběru nebo chybě náhledu zastavte mazání a zjistěte příčinu. Soubory se mažou přímo, bez Koše; obnova potřebuje zálohu nebo nový přístup ke stažení. Snapshoty a někdy i repozitáře sdílejí blob. Reference nechte zpracovat správcem mezipaměti a nesčítejte prostě zobrazené velikosti.

Rozlišujte prune a další mezipaměti

V testované verzi 2.0.0 ukazuje hf cache prune --dry-run revize detached a nedokončená stahování. Projekt může stále vyžadovat přesnou revizi i bez pojmenované reference. Prověřte každý cíl a zastavte aktivní stahování. Začněte jednou jasně určenou položkou.

Data vytvořená v HF_DATASETS_CACHE se liší od stažení z Hubu. Zvlášť zkontrolujte přenosová data Xet a výstupy local_dir a zachovejte místní úpravy. Smazání celého HF_HOME tuto kontrolu nenahradí.

Opravdu načtěte ponechané modely

Zopakujte měření, načtěte potřebné modely a revize a spusťte malou úlohu se známým výsledkem. Samotný import knihovny Python nestačí. Offline použití otestujte se skutečně odpojenou sítí. Při chybě zastavte úklid a před obnovou zkontrolujte prostředí, cesty, soubory, přístup i místo. Opakované stahování potřebného modelu vyžaduje přehodnocení výběru či kapacity.

Při přesunu na externí disk ověřte místo, oprávnění a symbolické odkazy. Zkopírujte odkazy i jejich cíle, nastavte každou aplikaci a vyzkoušejte její modely před odstraněním originálu. Disk musí při používání zůstat připojený.

Co bylo ověřeno

Dne 2026-09-29 byly s huggingface_hub 2.0.0 offline otestovány dočasné syntetické mezipaměti: seznamy, úplná ID, varování a dry-run. Náhledy soubory neměnily; odstranění staré revize zachovalo současnou a sdílená data. Reálná inference, uživatelská mezipaměť, sdílené blob mezi repozitáři ani migrace disku nebyly testovány. Pevná úspora místa není zaručena. Vlastní verzi ověřte pomocí hf cache --help.

Co ověřit před odstraněním

Ověřte skutečné umístění, účel a možnost obnovy. Tabulka není seznamem pro automatické mazání ani příslibem určitého množství volného místa.

Časté dotazy