Mac’te Hugging Face önbelleğini kontrol etme ve temizleme

Konumu ve korunacak çalışmaları belirleyin

Yaygın konum ~/.cache/huggingface/hub yoludur. HF_HUB_CACHE depo önbelleğini seçer; HF_HOME daha geniştir. HF_HOME ayarlanmadıysa XDG_CACHE_HOME varsayılanı etkileyebilir; cache_dir başka yol seçebilir. Grafik uygulamalarını, terminali ve notebook ortamını ayrı kontrol edin. HF_HOME kimlik doğrulama verileri içerebilir; tamamını silmeyin veya içeriğini yayımlamayın.

İnce ayarlı checkpoint, adapter, tokenizer değişiklikleri, dönüştürmeler, özel veriler ve proje ayarları yeniden indirilemeyebilir. Yedeği doğrulayın; bazı araçlar CACHEDIR.TAG işaretli önbellekleri atlar. Nasıl geri yükleneceğini bilmediğiniz içeriği koruyun; yalnızca eski erişim tarihine göre karar vermeyin.

Tam kimlikleri ve uyarıları gösterin

Önbelleği kullanan uygulama, indirme ve işleri durdurun. hf cache ls --no-truncate, ardından hf cache ls --revisions --no-truncate --show-warnings çalıştırın. Test edilen sürüm ayrıntılı uyarıları varsayılan olarak gizler. Özel önbellek için hep aynı --cache-dir kullanın. Okuma veya yapı sorunlarını araştırın, kullanılan ve boş alanı kaydedin; özel depo listelerini paylaşmayın.

Silme kapsamını doğrulayın

hf cache rm tam CLI kimliğini bekler. Model deposunda model/ önekini koruyun; models-- ile başlayan klasör adı yerine geçmez. Tek revizyonda tam hash kullanıp depoyu doğrulayın. Önce --dry-run ekleyin. Çıktı hedeflerin ve tahmini alanın özetidir, dosya dosya liste değildir. Bir depo hedefi önbellekteki tüm revizyonlarını kapsar.

Kontrolden sonra aynı hedef, yol ve onay istemiyle yalnızca --dry-run seçeneğini kaldırın. Seçim değişirse veya önizleme başarısız olursa silmeyi durdurup nedeni araştırın. Dosyalar Çöp Sepeti’ne gitmeden silinir; geri yükleme yedek veya yeniden indirme erişimi gerektirir. Snapshot’lar ve bazı düzenlerde depolar blob paylaşır. Başvuruları önbellek yöneticisine bırakın, boyutları doğrudan toplamayın.

Prune ve diğer önbellekleri ayırın

Test edilen 2.0.0 sürümünde hf cache prune --dry-run, detached revizyonları ve tamamlanmamış indirmeleri gösterir. Adlandırılmış başvuru olmasa da proje belirli revizyona sabitlenmiş olabilir. Her hedefi kontrol edin ve etkin indirmeleri durdurun. İlk temizlikte tek ve açık bir hedefle başlayın.

HF_DATASETS_CACHE altında üretilen veriler Hub indirmelerinden ayrıdır. Xet aktarım verilerini ve local_dir çıktılarını ayrı inceleyip yerel değişiklikleri koruyun. Tüm HF_HOME klasörünü silmek bu incelemenin yerine geçmez.

Korunan modelleri gerçekten yükleyin

Ölçümleri tekrarlayıp gereken model ve revizyonları yükleyin, sonucu bilinen küçük bir iş çalıştırın. Python kitaplığını içe aktarmak yeterli değildir. Çevrimdışı kullanım gerekiyorsa ağı gerçekten keserek test edin. Hata olursa temizliği durdurun; ortam, yol, dosyalar, erişim ve alanı kontrol edip geri yükleyin. Gerekli modeli sürekli yeniden indirmek hedef veya kapasite planını değiştirmeyi gerektirir.

Harici diske taşırken alanı, izinleri ve sembolik bağlantı desteğini kontrol edin. Bağlantıları hedefleriyle birlikte kopyalayın, her uygulamayı ayarlayıp modelleri test ettikten sonra orijinal kopyayı kaldırın. Kullanım sırasında disk bağlı kalmalıdır.

Doğrulamanın sınırları

2026-09-29 tarihinde huggingface_hub 2.0.0 ile geçici sentetik önbellekler çevrimdışı test edildi: listeleme, tam kimlikler, uyarılar ve dry-run. Önizlemeler dosya değiştirmedi; eski revizyon kaldırılırken güncel revizyon ve ortak veriler korundu. Gerçek çıkarım, kullanıcı önbelleği, depolar arası blob temizliği veya disk taşıma test edilmedi. Sabit alan kazancı garanti edilmez. Sürümünüzü hf cache --help ile kontrol edin.

Silmeden önce kontrol edin

Gerçek konumu, kullanım amacını ve geri yükleme yolunu doğrulayın. Bu tablo otomatik silme listesi değildir ve belirli miktarda boş alan vaat etmez.

SSS