Mac’te Hugging Face Önbelleği Nasıl Temizlenir?
AskClean Ekibi · Güncellendi 2026-11-02
Mac’te Hugging Face önbelleğinden yer açmak için önce uygulamanızın kullandığı önbelleği bulun, hf cache ls ile inceleyin ve belirli bir depoyu ya da revizyonu hf cache rm --dry-run ile önizleyin. Çevrimdışı gereken modelleri ve kendi çalışmalarınızı koruyun. Paylaşılan blob dosyalarını veya HF_HOME klasörünün tamamını körü körüne silmeyin.

Önbellek konumunu ve korunacak çalışmaları belirleyin
Hub önbelleğinin olağan konumu ~/.cache/huggingface/hub klasörüdür. HF_HUB_CACHE, Hub depo önbelleğini doğrudan seçer; HF_HOME ise daha geniş Hugging Face ana klasörünü değiştirir. HF_HOME ayarlı değilse XDG_CACHE_HOME varsayılan konumu etkileyebilir; uygulamadaki bir cache_dir parametresi de başka bir yer seçebilir. Grafik arayüzlü uygulamaları, terminali ve notebook çekirdeklerini ayrı ayrı kontrol edin; her birinin ortam ayarları farklı olabilir. HF_HOME kimlik doğrulama verileri de içerebilir: model indirmelerini temizlemek için klasörün tamamını silmeyin ve içeriğini destek taleplerinde paylaşmayın.
İndirdiğiniz modelleri kendi ürettiklerinizden ayırın: ince ayarlı checkpoint’ler, adaptörler, tokenizer değişiklikleri, dönüştürme çıktıları, özel veri kümeleri, notebook’lar ve proje ayarları yeniden indirilemeyebilir. Bunları yedekleyin ve yedeğin onları gerçekten içerdiğini doğrulayın; bazı yedekleme araçları CACHEDIR.TAG ile işaretlenmiş önbellekleri atlar. Nasıl geri yükleyeceğinizi bilmediğiniz bir öğeyi şimdilik saklayın; yalnızca eski erişim tarihine bakarak silmeyin.
Seçmeden önce depoları ve revizyonları inceleyin
Önce önbelleği kullanan uygulamaları, indirmeleri ve işleri kapatın. Ardından tam depo kimliklerini görmek için hf cache ls --no-truncate, tam revizyon hash’lerini ve önbellek sorunlarını görmek için hf cache ls --revisions --no-truncate --show-warnings çalıştırın; test ettiğimiz sürüm ayrıntılı uyarıları varsayılan olarak gizler. Özel bir Hub önbelleği kullanıyorsanız her komuta aynı --cache-dir değerini verin. Okunamayan veya tutarsız kayıtlara ilişkin uyarıları silmeden önce araştırın, mevcut klasör boyutunu ve boş alanı not edin. Çıktı gizli projeleri ele veriyorsa kimseyle paylaşmayın.
Silmeden önce önizleyin
hf cache rm komutuna envanterinizden aldığınız tam bir depo kimliğini veya revizyon hash’ini verin ve önce --dry-run ekleyin. Model depolarında CLI’ın gösterdiği model/ önekini koruyun; diskte models-- ile başlayan klasör adı aynı kimlik değildir. Tek bir revizyon için tam hash’i kullanın ve hangi depoya ait olduğunu kontrol edin. Önizleme, hedeflerin bir özetini ve kazanılacak alanın tahminini verir; dosya dosya bir liste değildir. Bir depoyu seçmek önbellekteki tüm revizyonlarını kapsar; yalnızca birini silmek istiyorsanız revizyon hedefi kullanın.
Kapsamı kontrol ettikten sonra aynı hedef ve önbellek klasörüyle komutu bu kez --dry-run olmadan çalıştırın; son bir kontrol için onay istemini açık bırakın. Liste beklenmedik biçimde değişirse veya önizleme başarısız olursa durun ve nedenini araştırın. hf cache rm dosyaları doğrudan siler, Çöp Sepeti’ne taşımaz; silinen bir revizyonu geri getirmek için çalışan bir yedek veya yeniden indirme erişimi gerekir. Snapshot’lar ve bazı önbellek düzenlerinde depolar aynı blob’ları paylaşabilir: bu başvuruları önbellek yöneticisine bırakın, Finder’da tek tek dosya silmeyin ve revizyon boyutlarını toplayarak kazanılacak alanı hesaplamayın.
Prune’u ve diğer önbellekleri ayrı tutun
Doğruladığımız 2.0.0 sürümünde hf cache prune --dry-run, detached (adlandırılmış başvurusu olmayan) revizyonları ve tamamlanmamış indirmeleri önizler. Önbellekte adlandırılmış bir başvuru olmasa da projeniz tam olarak o revizyonu istiyor olabilir; her adayı projelerinizle karşılaştırın ve önce etkin indirmeleri durdurun. Bir geliştirici Mac’indeki ilk temizlikte tek ve açık bir hedef, geniş bir süpürmeden daha kolay değerlendirilir.
Hugging Face Datasets’in ürettiği işlenmiş veriler (HF_DATASETS_CACHE) Hub indirmelerinden ayrıdır; Hub revizyonlarını silmek onları kaldırmaz. local_dir ile indirilen dosyalar ve Xet aktarım verileri de ayrı yerlerde durur: bunları ayrı inceleyin ve yerel düzenlemelerinizi koruyun, çünkü yeni bir indirme düzenlemelerinizi geri getirmez. HF_HOME klasörünün tamamını silmek bu incelemenin yerini tutmaz.
Kalan modellerinizin hâlâ çalıştığını doğrulayın
Envanteri ve disk ölçümlerini tekrarlayın, ardından saklamak istediğiniz bir model ve revizyonu yükleyip sonucu bilinen küçük bir iş çalıştırın; Python kitaplığını içe aktarmak model dosyalarını sınamaz. Çevrimdışı erişime ihtiyacınız varsa ağ bağlantısını gerçekten keserek test edin. Bir kontrol başarısız olursa temizliği durdurun: uygulamanın incelediğiniz ortamı kullanıp kullanmadığını ve silinen bir dosyaya ihtiyaç duyup duymadığını kontrol edin, sonra yedeği geri yükleyin veya gereken revizyonu yeniden indirin. Sonraki çalıştırma aynı modeli yeniden indiriyorsa seçimi, kapasiteyi veya önbellek konumunu yeniden düşünün.
Düzenli kullandığınız modeller Mac’inize sığmıyorsa harici bir disk işe yarayabilir. Boş alanı, izinleri ve snapshot’ları paylaşılan blob’lara bağlayan sembolik bağlantı desteğini kontrol edin; kopyalarken bağlantıları ve gösterdikleri dosyaları koruyun. Her uygulamayı yeni konumu kullanacak şekilde ayarlayın ve gereken modelleri orada test etmeden özgün kopyayı silmeyin. Bu uygulamalar çalışırken disk bağlı kalmalıdır.
Bu komutları nasıl doğruladık
29 Eylül 2026’da huggingface_hub 2.0.0 ile geçici, sentetik Hub önbelleklerini çevrimdışı olarak test ettik: revizyon listeleme, tam kimlikler, --show-warnings uyarıları ve dry-run önizlemeleri. Önizlemeler hiçbir dosyayı değiştirmedi; eski revizyonu silmek güncel revizyonu ve paylaşılan verileri korurken yalnızca eski revizyona ait blob’u kaldırdı. Gerçek model indirmeleri, çıkarım, bir kullanıcının önbelleği, depolar arasında paylaşılan blob’ların temizliği ve disk taşıma test edilmedi; bu sonuçlar Mac’inizde ne kadar yer açılacağını öngörmez. Kendi ortamınızda önce hf cache --help çalıştırın; komutlar veya seçenekler farklıysa o sürümün belgelerini izleyin.
AskClean, Mac’inizde depolamanın nerede kullanıldığını görmenize yardım eder ve onayladığınız öğeleri kalıcı olarak siler. Önbellekteki revizyonları ve paylaşılan dosyaları ise Hugging Face CLI ile yönetin, kendi proje çalışmalarınızı temizlik seçiminin dışında tutun.
Neler yeniden oluşturulabilir, neler saklanmalı
Her kategoriyi ayrı kontrol edin. Tablo neyi korumanız veya nasıl geri yüklemeniz gerektiğini açıklar; dosyaları otomatik silme için işaretlemez.
| Öğe | Nereden incelenir | Silmeden önce neyi kontrol etmeli |
|---|---|---|
| Hub deposu veya revizyonu | hf cache ls --revisions | Tam seçimi kontrol edin. Geri getirmek yeniden indirme ve aynı depoya erişim gerektirebilir. |
| Paylaşılan blob’lar ve snapshot’lar | Doğrulanmış Hub önbelleği | Önbellek yöneticisini kullanın; revizyonlar ve bazı düzenlerde depolar aynı dosyaları paylaşabilir. |
| Detached revizyonlar | hf cache prune --dry-run | Önbellekte adlandırılmış bir başvuru olmasa da bir proje tam olarak o revizyona ihtiyaç duyabilir. |
| Üretilmiş veri kümesi önbelleği | HF_DATASETS_CACHE / Datasets önbellek ayarları | Hub indirmelerinden ayrıdır; yeniden üretmek işlem süresi ve kaynak veri gerektirebilir. |
| Özel checkpoint’ler, adaptörler ve kaynaklar | Projeniz ve yedek konumlarınız | Kendi çalışmanızı koruyun; özellikle bir önbellek klasörü altında duruyorsa yedeklerin onu içerdiğini doğrulayın. |
| Hugging Face ana klasörü ve kimlik doğrulama verileri | HF_HOME | Model önbelleği kayıtlarını silmek için ana klasörün tamamını silmeyin. |
Yerel test küçük, sentetik bir önbellekle yapıldı; boyutu bir ölçüt ya da gerçek kazanç tahmini değildir.
SSS
~/.cache/huggingface klasörünü silebilir miyim?
Klasörün tamamını gereksiz saymayın. Etkin Hub önbelleğini bulun, kimlik doğrulama verilerini ve kendi çalışmalarınızı koruyun; ardından kurulu hf cache arayüzüyle belirli depoları veya revizyonları önizleyin.
Detached revizyon kullanılmadığı anlamına mı gelir?
Hayır. Önbellekte adlandırılmış bir başvuru olmasa da bir proje tam revizyonu sabitlemiş olabilir. Prune öncesinde projenin gereksinimlerini kontrol edin.
hf cache rm ince ayar yaptığım modeli siler mi?
Özel dosyalarınız seçilen önbellek kaydının içindeyse evet. Checkpoint’leri, adaptörleri ve değiştirdiğiniz dosyaları silmeyi planladığınız kayıtların dışında tutun ve yedeklerini doğrulayın. Adı cache olan bir klasör de önemli bir çalışmanızın tek kopyasını içerebilir.
Kaynaklar