Missä Hugging Face -välimuistin hakemisto sijaitsee?

Hugging Face Hub -välimuistin dokumentoitu oletushakemisto on ~/.cache/huggingface/hub. Aktiivinen sijainti voidaan kuitenkin ohittaa, joten tarkasta määritys ja itse välimuisti ennen kuin pidät kansiota tarpeettomana.

Oletuspolku ja dokumentoidut ohitukset

Hub-välimuisti tallentaa ladatut malli-, dataset- ja Space-repositoryt välimuistin juuren alle. Oletusjuuri on ~/.cache/huggingface/hub. Sen sisällä repositoryt nimetään tavallisesti esimerkiksi models--organization--repository, ja niissä on hakemistot blob-tiedostoille, snapshot-versioille ja viitteille.

• HF_HUB_CACHE määrittää Hub-välimuistin hakemiston suoraan ja on etusijalla.
• HF_HOME määrittää Hugging Face -kotihakemiston; kun se on asetettu, Hub-välimuisti sijaitsee polun HF_HOME/hub alla.
• Myös yksittäisille kirjastokutsuille voi antaa välimuistihakemiston, joten projekti voi käyttää muuta kuin yleistä oletuspolkua.

Tarkasta ennen tilan vapauttamista

Tarkista Hugging Face CLI -työkalulla, mitä sen välimuistinhallinta tietää aktiivisesta välimuistista. Dokumentoitu komento hf cache ls näyttää välimuistissa olevat repositoryt sekä koko- ja käyttötiedot. Jos olet siirtänyt välimuistin, käytä välimuistinhallintakomentojen kanssa vastaavaa hakemistoasetusta äläkä oleta oletussijaintia.

# Näytä, mitä sijaintia tämä komentotulkki käyttää
printf '%s\n' "${HF_HUB_CACHE:-${HF_HOME:-$HOME/.cache/huggingface}/hub}"

# Inventoi välimuistissa olevat repositoryt ennen karsimista
hf cache ls

Ennen snapshotin poistamista selvitä sitä käyttävä projekti, ajoympäristö ja revisio. Välimuisti voi sisältää muutakin kuin mielessäsi olevan mallitiedoston, ja lähdepuu tai paikallinen päättelytyönkulku voi riippua välimuistissa olevasta revisiosta, jota tiedostoselain ei paljasta.

Välimuistin siivous verrattuna pitkäaikaiseen säilytykseen

Hugging Face -välimuisti on optimoitu välttämään tarpeettomia latauksia. Se ei automaattisesti ole pitkäaikainen luettelo säilytettävistä malliversioista. Jos valmiiden malliartefaktien ryhmä on työllesi tärkeä, päätä ensin, mitä sinun täytyy voida palauttaa myöhemmin, ja pidä tarvittaessa riippumaton varmuuskopio.

Tensor Archive tulee mukaan tämän päätöksen jälkeen: se voi säilyttää toisiinsa liittyvän paikallisen perheen, varmentaa sen ja palauttaa erillisen täsmällisen kopion ennen tarpeettoman työkopion manuaalista poistamista. Se ei korvaa Hugging Face -välimuistin omaa hallintaa eikä kerro aktiiviselle kirjastolle, minne mallit ladataan.

Turvallinen etenemisjärjestys

1. Tarkista, muuttaako HF_HUB_CACHE tai HF_HOME aktiivista sijaintia.
2. Listaa välimuisti Hugging Face -työkaluilla ja tunnista repositoryt, joita et tarvitse heti.
3. Säilytä tai varmuuskopioi itsenäisesti kaikki tärkeät malliversiot.
4. Analysoi valmis toisiinsa liittyvä perhe, arkistoi ja varmista se sekä palauta erillinen kopio ennen manuaalista tilan vapauttamista.

Jos välimuisti on väärällä levyllä, vaihda Hugging Face -välimuistin hakemisto oikealla ympäristömuuttujalla. Jos ongelmana ovat vanhentuneet revisiot, tyhjennä Hugging Face -välimuisti turvallisesti välimuistinhallinnan kautta. Toiseen ajoympäristöön kuuluvat tiedostot tarvitsevat kyseisen ajoympäristön oman tallennusohjeen.