Kde je adresář mezipaměti Hugging Face?

Dokumentovaný výchozí adresář mezipaměti Hugging Face Hub je ~/.cache/huggingface/hub. Aktivní umístění však lze přepsat, proto před označením složky za postradatelnou zkontrolujte konfiguraci i samotnou mezipaměť.

Výchozí cesta a zdokumentované přepisy

Mezipaměť Hub ukládá pod svým kořenem stažené repozitáře modelů, datasetů a aplikací Space. Výchozí kořen je ~/.cache/huggingface/hub. Repozitáře v něm mívají názvy jako models--organization--repository a obsahují adresáře pro bloby, snapshoty a reference.

• HF_HUB_CACHE nastavuje adresář mezipaměti Hub přímo a má přednost.
• HF_HOME nastavuje domovský adresář Hugging Face; pokud je nastaven, mezipaměť Hub se nachází pod HF_HOME/hub.
• Jednotlivá volání knihoven mohou také zadat adresář mezipaměti, takže projekt může používat cestu odlišnou od globálního výchozího nastavení.

Než cokoli uvolníte, proveďte kontrolu

Pomocí CLI Hugging Face zjistěte, co jeho správce ví o aktivní mezipaměti. Zdokumentovaný příkaz hf cache ls vypíše repozitáře v mezipaměti, velikost a informace o přístupu. Pokud jste mezipaměť přesunuli, použijte u příkazů správy odpovídající volbu adresáře mezipaměti a nepředpokládejte výchozí umístění.

# Ukažte, které umístění použije tento shell
printf '%s\n' "${HF_HUB_CACHE:-${HF_HOME:-$HOME/.cache/huggingface}/hub}"

# Před prořezáváním inventarizujte repozitáře v mezipaměti
hf cache ls

Před odstraněním snapshotu určete projekt, běhové prostředí a revizi, které jej používají. Mezipaměť může obsahovat více než jen soubor modelu, který máte na mysli, a zdrojový strom nebo místní inferenční pracovní postup může záviset na revizi v mezipaměti, která není v prohlížeči souborů zřejmá.

Čištění mezipaměti oproti dlouhodobému uchování

Mezipaměť Hugging Face je optimalizována tak, aby bránila zbytečnému stahování. Není automaticky dlouhodobým katalogem verzí modelů, které chcete uchovat. Pokud je skupina dokončených artefaktů modelu pro vaši práci důležitá, nejprve rozhodněte, co potřebujete později obnovit, a případně udržujte nezávislou zálohu.

Tensor Archive přichází na řadu po tomto rozhodnutí: dokáže zachovat související místní rodinu, ověřit ji a obnovit jako oddělenou přesnou kopii před ručním uvolněním nadbytečné pracovní kopie. Nenahrazuje vlastní správu mezipaměti Hugging Face ani neříká aktivní knihovně, kam stahovat modely.

Bezpečný postup

1. Ověřte, zda HF_HUB_CACHE nebo HF_HOME nemění aktivní umístění.
2. Vypište mezipaměť nástroji Hugging Face a určete repozitáře, které již bezprostředně nepotřebujete.
3. Zachovejte nebo nezávisle zazálohujte každou důležitou verzi modelu.
4. U dokončené související rodiny ji před ručním uvolněním analyzujte, archivujte, ověřte a obnovte jako oddělenou kopii.

Pokud je mezipaměť na nesprávném disku, změňte adresář mezipaměti Hugging Face pomocí správné proměnné prostředí. Pokud problém představují zastaralé revize, bezpečně vyčistěte mezipaměť Hugging Face prostřednictvím správce mezipaměti. Soubory patřící jinému běhovému prostředí vyžadují jeho vlastní průvodce úložištěm.