Var finns Hugging Face-cache-katalogen?

För Hugging Face Hub är den dokumenterade standardcachekatalogen ~/.cache/huggingface/hub. Men den aktiva platsen kan åsidosättas, så granska konfigurationen och cachen själv innan du behandlar en mapp som kassabel.

Standardväg och dokumenterade återställningar

Hub-cachen lagrar nedladdade arkiv för modeller, datauppsättningar och Space-appar under sin cacherot. Standardroten är ~/.cache/huggingface/hub. Där har arkiven ofta namn som models--organization--repository och kataloger för blobbar, ögonblicksbilder och referenser.

• HF_HUB_CACHE anger katalogen för Hub-minnet direkt och har företräde.
• HF_HOME anger Hugging Face-hemkatalogen; när den är inställd finns Hub-minnet under HF_HOME/hub.
• Individuella biblioteksanrop kan också ange en cache-katalog, så att ett projekt kan använda en sökväg som inte är den globala standarden.

Granska innan du frigör något

Använd Hugging Face CLI för att se vad dess cachehanterare vet om den aktiva cachen. Den dokumenterade kommandot hf cache ls listar cachade bibliotek, storlek och åtkomstinformation. Om du har flyttat cachen bör du koppla cachehanteringskommandon med motsvarande cachemappalternativ istället för att anta att standardvärdet gäller.

# Visa vilken plats som detta ska använda
printf '%s\n' "${HF_HUB_CACHE:-${HF_HOME:-$HOME/.cache/huggingface}/hub}"

# Katalogiserade databaser i inventeringen innan rening
hf cache ls

Innan du raderar en snittbild måste du identifiera vilket projekt, körning och version som använder den. En cache kan innehålla mer än bara den modellfil du har i åtanke, och ett källträd eller ett lokalt inferensarbetsflöde kan bero på en cachad version som inte är uppenbar från en filutforskare.

Cachetömning mot långsiktig lagring

Den Hugging Face-cache är optimerad för att undvika onödiga nedladdningar. Den är inte automatiskt en långsiktig katalog över de modellversioner du vill bevara. Om en grupp färdiga modellartefakter har betydelse för ditt arbete, besluta först vad du behöver återställa senare och håll en oberoende säkerhetskopia på lämpligt ställe.

Tensor Archive kommer in efter det beslutet: programmet kan bevara en relaterad lokal familj, verifiera den och återställa en separat exakt kopia innan du manuellt frigör utrymmet som tas upp av en överflödig arbetskopia. Det ersätter inte Hugging Face egen cachehantering och anger inte för ett aktivt bibliotek var modeller ska hämtas.

En säker sekvens

1. Kontrollera om HF_HUB_CACHE eller HF_HOME ändrar den aktiva platsen.
2. Lista cache genom Hugging Face-verktyget och identifiera de lagringsplatser du inte behöver omedelbart.
3. Håll kvar eller säkerhetskopiera någon modellversion som är viktig.
4. För en färdig relaterad familj, analysera den, arkivera den, verifiera den och återställ en separat kopia innan manuell återhämtning.

Om cacheminnet är på fel disk, ändra Hugging Face-cache-katalogen med rätt miljövariabel. Om problemet är gamla versioner, rens Hugging Face-cache på ett säkert sätt genom cachehanteraren. Filer som tillhör en annan körning kräver den körningens egna lagringsguide.