Waar staat de Hugging Face-cachemap?

Voor Hugging Face Hub is de gedocumenteerde standaardcachemap ~/.cache/huggingface/hub. De actieve locatie kan echter worden overschreven, dus inspecteer de configuratie en de cache zelf voordat je een map als vervangbaar behandelt.

Standaardpad en gedocumenteerde overschrijvingen

De Hub-cache bewaart gedownloade model-, dataset- en Space-repositories onder de cachehoofdmap. De standaardhoofdmap is ~/.cache/huggingface/hub. Daarbinnen hebben repositories doorgaans namen als models--organization--repository, met mappen voor blobs, snapshots en verwijzingen.

• HF_HUB_CACHE stelt de Hub-cachemap rechtstreeks in en heeft voorrang.
• HF_HOME stelt de Hugging Face-hoofdmap in; wanneer deze is ingesteld, staat de Hub-cache onder HF_HOME/hub.
• Afzonderlijke bibliotheekaanroepen kunnen ook een cachemap opgeven, zodat een project een pad kan gebruiken dat niet de globale standaard is.

Inspecteer voordat je iets vrijmaakt

Gebruik de Hugging Face CLI om te zien wat de cachebeheerder over de actieve cache weet. De gedocumenteerde opdracht hf cache ls toont gecachte repositories, grootte en toegangsinformatie. Als je de cache hebt verplaatst, combineer cachebeheeropdrachten dan met de overeenkomstige optie voor de cachemap in plaats van de standaard aan te nemen.

# Toon welke locatie deze shell gebruikt
printf '%s\n' "${HF_HUB_CACHE:-${HF_HOME:-$HOME/.cache/huggingface}/hub}"

# Inventariseer gecachte repositories voordat je snoeit
hf cache ls

Bepaal voordat je een snapshot verwijdert welk project, welke runtime en revisie hem gebruiken. Een cache kan meer bevatten dan het modelbestand dat je in gedachten hebt en een bronboom of lokale inferentieworkflow kan afhankelijk zijn van een gecachte revisie die in een bestandsbrowser niet duidelijk is.

Cacheopschoning tegenover langdurige retentie

De Hugging Face-cache is geoptimaliseerd om onnodige downloads te voorkomen. Het is niet automatisch een langetermijncatalogus van de modelversies die je wilt behouden. Als een groep voltooide modelartefacten belangrijk is voor je werk, bepaal dan eerst wat je later moet kunnen herstellen en bewaar waar passend een onafhankelijke back-up.

Tensor Archive past na die beslissing: het kan een verwante lokale familie behouden, verifiëren en een afzonderlijke exacte kopie herstellen voordat je handmatig een redundante werkkopie opruimt. Het vervangt het eigen cachebeheer van Hugging Face niet en vertelt een actieve bibliotheek niet waar modellen moeten worden gedownload.

Een veilige volgorde

1. Controleer of HF_HUB_CACHE of HF_HOME de actieve locatie wijzigt.
2. Toon de cache via het Hugging Face-gereedschap en identificeer de repositories die je niet onmiddellijk nodig hebt.
3. Behoud of maak een onafhankelijke back-up van elke belangrijke modelversie.
4. Analyseer, archiveer en verifieer een voltooide verwante familie en herstel een afzonderlijke kopie voordat je handmatig ruimte terugwint.

Als de cache op de verkeerde schijf staat, wijzig dan de Hugging Face-cachemap met de juiste omgevingsvariabele. Als verouderde revisies het probleem zijn, wis de Hugging Face-cache dan veilig via de cachebeheerder. Bestanden van een andere runtime hebben de eigen opslaggids van die runtime nodig.