AskClean

Mac पर Hugging Face कैश कैसे साफ़ करें

AskClean टीम · अपडेट: 2026-11-02

Mac पर Hugging Face कैश की जगह वापस पाने के लिए पहले पता करें कि आपका ऐप्लिकेशन कौन-सा कैश इस्तेमाल करता है, उसे hf cache ls से देखें, और किसी ख़ास रिपॉज़िटरी या रिविज़न को हटाने का प्रीव्यू hf cache rm --dry-run से लें। ऑफ़लाइन काम के लिए ज़रूरी मॉडल और अपना बनाया काम सुरक्षित रखें। साझा ब्लॉब या पूरा HF_HOME फ़ोल्डर आँख मूँदकर डिलीट न करें।

साझा डेटा ब्लॉक से जुड़े मॉडल रिविज़न और अलग रखी प्रोजेक्ट फ़ाइलों का सांकेतिक चित्र
कई रिविज़न एक जैसी फ़ाइलें साझा कर सकते हैं। अपने चेकपॉइंट और प्रोजेक्ट का काम अलग रखें। सांकेतिक चित्र।

डाउनलोड किए मॉडल को अपने काम से अलग रखें

कोई मॉडल हटाने से पहले देखें कि कौन-सा ऐप्लिकेशन या Python एनवायरनमेंट उसे इस्तेमाल करता है, आपके प्रोजेक्ट को कौन-सा रिविज़न चाहिए, और क्या आप ऑफ़लाइन उस पर निर्भर हैं। शुरुआत ऐसी कैश एंट्री से करें जिसकी अब ज़रूरत नहीं और जिसे वापस लाने का तरीका आप जानते हैं। कोई बड़ा या अनजाना फ़ोल्डर भी ऐसी फ़ाइलें रख सकता है जिन पर आपका ऐप्लिकेशन निर्भर है।

डाउनलोड की गई चीज़ों को अपनी बनाई चीज़ों से अलग करें: फ़ाइन-ट्यून किए चेकपॉइंट, अडैप्टर, टोकनाइज़र में किए बदलाव, कन्वर्शन के आउटपुट, निजी डेटासेट, नोटबुक, प्रॉम्प्ट और प्रोजेक्ट कॉन्फ़िगरेशन। डाउनलोड किया गया बेस मॉडल फिर से मिल सकता है, लेकिन लोकल अडैप्टर या कन्वर्शन का तरीका शायद सिर्फ़ इसी Mac पर हो। मॉडल से जुड़ी कोई भी जगह ख़ाली करने से पहले इस काम का बैकअप लें और उसे जाँचें। कुछ बैकअप टूल CACHEDIR.TAG वाले कैश छोड़ देते हैं, इसलिए पक्का करें कि आपके बैकअप में ज़रूरी फ़ाइलें सचमुच शामिल हैं।

अगर आप नहीं जानते कि किसी आइटम को वापस लाकर ऐप्लिकेशन फिर से कैसे चलाएँगे, तो उसे अभी रहने दें और ऐसी छोटी कैश एंट्री से शुरू करें जिसका काम आप समझते हैं। तय करें कि मिलने वाली जगह उस समय, बैंडविड्थ और ऐक्सेस के लायक़ है या नहीं, जो उसे दोबारा डाउनलोड करने या बनाने में लगेंगे।

वह कैश ढूँढें जिसे ऐप्लिकेशन सचमुच इस्तेमाल करता है

Hub कैश आम तौर पर ~/.cache/huggingface/hub में होता है। HF_HUB_CACHE सीधे Hub रिपॉज़िटरी कैश का स्थान चुनता है; HF_HOME पूरी Hugging Face होम डायरेक्टरी बदल देता है, और HF_HOME सेट न हो, तो XDG_CACHE_HOME डिफ़ॉल्ट स्थान पर असर डाल सकता है। ऐप्लिकेशन में दिया गया cache_dir आर्ग्युमेंट भी कोई दूसरी जगह चुन सकता है। यह मानकर न चलें कि हर ऐप आपके टर्मिनल की सेटिंग इस्तेमाल करता है — उस एनवायरनमेंट को जाँचें जिससे ऐप्लिकेशन शुरू होता है।

HF_HOME में ऑथेंटिकेशन डेटा भी हो सकता है, इसलिए मॉडल डाउनलोड साफ़ करने के लिए पूरी डायरेक्टरी डिलीट न करें। कैश का स्थान अपने Mac पर ही जाँचें; मदद माँगनी हो, तो संवेदनशील वैल्यू हटाकर सिर्फ़ ज़रूरी सेटिंग साझा करें, और ऑथेंटिकेशन फ़ाइलें या निजी रिपॉज़िटरी की सूची सपोर्ट टिकट में न डालें।

GUI ऐप्लिकेशन, नोटबुक कर्नेल और कमांड-लाइन प्रोजेक्ट को अलग-अलग जाँचें, क्योंकि उनकी एनवायरनमेंट सेटिंग अलग हो सकती हैं। डिफ़ॉल्ट Hub डायरेक्टरी ख़ाली होने का मतलब यह नहीं कि Mac पर कोई मॉडल नहीं है: कोई दूसरा ऐप्लिकेशन कस्टम कैश या अपनी अलग मॉडल स्टोरेज इस्तेमाल कर सकता है। फ़ाइलें मापने या हटाने से पहले पाथ पक्का करें।

हमने ये कमांड 2026-09-29 को huggingface_hub 2.0.0 के साथ जाँचे थे। पहले अपने एनवायरनमेंट में hf cache --help चलाएँ; अगर आपके वर्शन में कमांड या विकल्प अलग हैं, तो उसी के दस्तावेज़ का पालन करें।

चुनने से पहले रिपॉज़िटरी और रिविज़न जाँचें

शुरुआत hf cache ls --no-truncate से करें, ताकि रिपॉज़िटरी के पूरे ID दिखें। फिर hf cache ls --revisions --no-truncate --show-warnings चलाकर पूरे रिविज़न हैश और कैश की कोई भी गड़बड़ी देखें — जाँचे गए वर्शन में विस्तृत चेतावनियाँ डिफ़ॉल्ट रूप से छिपी रहती हैं। कस्टम Hub कैश के लिए हर कमांड में वही --cache-dir वैल्यू दें। अगर आउटपुट से गोपनीय प्रोजेक्ट का पता चलता हो, तो उसे निजी रखें।

किसी रिविज़न का दिखाया गया आकार उसे डिलीट करने से मिलने वाली जगह से बड़ा हो सकता है: स्नैपशॉट डेटा साझा कर सकते हैं, और कुछ कैश संरचनाओं में अलग-अलग रिपॉज़िटरी भी ब्लॉब साझा करती हैं, इसलिए आकार जोड़ने पर वही फ़ाइलें एक से ज़्यादा बार गिनी जा सकती हैं। न पढ़ी जा सकने वाली या बेमेल एंट्री की चेतावनियाँ हटाने से पहले जाँचें; स्कैन पूरा हो जाने से यह साबित नहीं होता कि हर फ़ाइल पहचानी गई।

कोई ख़ास लक्ष्य चुनें, जैसे छोड़ा गया प्रयोग या ऐसा रिविज़न जिसे आपका प्रोजेक्ट अब इस्तेमाल नहीं करता। फ़ैसले से पहले कोड और कॉन्फ़िगरेशन में पिन किए गए रिविज़न देखें। आख़िरी ऐक्सेस का समय मदद कर सकता है, पर पुराना मॉडल भी कभी-कभार के मूल्यांकन या ऑफ़लाइन रिकवरी के लिए ज़रूरी हो सकता है — सिर्फ़ उम्र डिलीट करने की वजह नहीं है।

  1. जो ऐप्लिकेशन और जॉब इस कैश को इस्तेमाल करते हैं, उन्हें बंद करें।
  2. पक्के किए गए कैश पाथ पर hf cache ls --no-truncate और फिर hf cache ls --revisions --no-truncate --show-warnings चलाएँ।
  3. जाँचें कि कोई ऐप्लिकेशन या प्रोजेक्ट अब भी चुनी गई रिपॉज़िटरी और रिविज़न पर निर्भर तो नहीं है।
  4. कुछ भी बदलने से पहले डायरेक्टरी का मौजूदा आकार और डिस्क पर उपलब्ध जगह लिख लें।

पुष्टि से पहले हटाने का प्रीव्यू देखें

अपनी सूची से एक पूरा रिपॉज़िटरी ID या रिविज़न हैश लेकर hf cache rm चलाएँ — पहले --dry-run के साथ। मॉडल रिपॉज़िटरी के लिए CLI में दिखने वाला model/ उपसर्ग बनाए रखें; डिस्क पर models-- से शुरू होने वाला फ़ोल्डर नाम वही पहचानकर्ता नहीं है। एक रिविज़न के लिए उसका पूरा हैश इस्तेमाल करें और जाँचें कि वह किस रिपॉज़िटरी का है।

प्रीव्यू में लक्ष्यों का सारांश और अनुमानित बचत पढ़ें; यह फ़ाइल-दर-फ़ाइल सूची नहीं है। रिपॉज़िटरी चुनने पर उसके कैश में मौजूद सभी रिविज़न शामिल हो जाते हैं, इसलिए सिर्फ़ एक हटाना हो, तो रिविज़न को लक्ष्य बनाएँ। दायरा जाँचने के बाद वही कमांड --dry-run के बिना दोहराएँ, और आख़िरी जाँच के लिए पुष्टि वाला सवाल चालू रहने दें।

प्रीव्यू और असली हटाने, दोनों में वही लक्ष्य और वही कैश डायरेक्टरी रखें। सूची अचानक बदल जाए, तो देखें कि कहीं कोई दूसरा ऐप्लिकेशन फिर से शुरू होकर डेटा तो नहीं डाउनलोड कर रहा; प्रीव्यू विफल हो, तो रुककर वजह जाँचें। साझा ब्लॉब और स्नैपशॉट के रेफ़रेंस Hugging Face के कैश मैनेजर को ही सँभालने दें; Finder में अलग-अलग फ़ाइलें डिलीट करने से वे दूसरे रिविज़न बिगड़ सकते हैं जिन्हें उनकी ज़रूरत है।

कैश से हटाई गई फ़ाइलें सीधे डिलीट होती हैं, रद्दी में नहीं जातीं। हटाया गया रिविज़न वापस लाने के लिए काम करने वाला बैकअप या दोबारा डाउनलोड चाहिए। जब तक आपकी जाँच पूरी न हो, बैकअप रखें — ख़ासकर उन मॉडल का जो निजी हैं, ऐक्सेस-प्रतिबंधित (gated) हैं, अब प्रकाशित नहीं होते, लोकल रूप से बदले गए हैं या ऑफ़लाइन चाहिए।

लक्ष्य अपनी कैश सूची से ही चुनें, और हटाने का कमांड चलाने से पहले रिपॉज़िटरी व रिविज़न, दोनों ध्यान से जाँचें।

hf cache prune से पहले हर उम्मीदवार जाँचें

जाँचे गए 2.0.0 CLI में hf cache prune --dry-run डिटैच्ड (detached) रिविज़न और अधूरे डाउनलोड का प्रीव्यू दिखाता है। डिटैच्ड रिविज़न का कैश में कोई नाम वाला रेफ़रेंस नहीं होता, फिर भी आपका प्रोजेक्ट ठीक उसी रिविज़न को माँग सकता है, इसलिए हटाने की मंज़ूरी से पहले अपने प्रोजेक्ट जाँचें। आप आगे कौन-से मॉडल इस्तेमाल करेंगे, यह CLI नहीं बता सकता।

डेवलपमेंट Mac पर पहली सफ़ाई में एक साफ़-साफ़ चुना गया लक्ष्य हटाना, बड़े पैमाने की सफ़ाई से परखने में आसान होता है; उसके बाद प्रभावित ऐप्लिकेशन चलाएँ और फिर से मापें। बाद में prune चलाना हो, तो सभी उम्मीदवारों पर वही जाँच-सूची लागू करें और पहले चल रहे डाउनलोड रोकें। अधूरी फ़ाइल रुके हुए ट्रांसफ़र का संकेत हो सकती है, पर जब कोई दूसरा जॉब कैश इस्तेमाल कर रहा हो, तब उसे छोड़ा हुआ ट्रांसफ़र न समझें।

Hub, डेटासेट, Xet और लोकल एक्सपोर्ट अलग रखें

Hugging Face Datasets प्रोसेस किया हुआ डेटा अपने अलग कैश में रख सकता है। Hub डाउनलोड हटाने से डेटासेट पाइपलाइन के बनाए Arrow डेटा या ट्रांसफ़ॉर्मेशन के नतीजे ज़रूरी नहीं कि हटें। HF_DATASETS_CACHE और HF_HUB_CACHE के दायरे अलग हैं; बनी हुई डेटासेट फ़ाइलों के लिए Datasets के कैश नियंत्रण देखें और पक्का करें कि कोई चलती प्रक्रिया उन पर निर्भर नहीं है।

local_dir देकर किए गए डाउनलोड आपकी या ऐप्लिकेशन की चुनी जगह पर जाते हैं, और उनका मेटाडेटा भी वहीं रहता है। उस डायरेक्टरी को साझा Hub कैश से अलग मानें। अगर आपने स्क्रिप्ट जोड़ी हैं या डाउनलोड की गई फ़ाइलें बदली हैं, तो कुछ भी हटाने से पहले उन बदलावों को बचाएँ — नया डाउनलोड आपके लोकल बदलाव वापस नहीं लाएगा।

Xet ट्रांसफ़र स्टोरेज भी अलग है; क्या हटाना है, यह तय करने से पहले उसका स्थान और उसे बनाने वाले क्लाइंट का वर्शन देखें। Hub रिविज़न साफ़ करने से ट्रांसफ़र कैश, प्रोसेस किए डेटासेट, एक्सपोर्ट की गई कॉपियाँ या किसी दूसरे ऐप्लिकेशन की मॉडल स्टोरेज ज़रूरी नहीं कि साफ़ हों। डिस्क की खपत अब भी ज़्यादा हो, तो बाक़ी हर श्रेणी अलग से जाँचें।

जाँचें कि बचे हुए मॉडल अब भी चलते हैं

सूची और डिस्क के माप दोहराएँ, फिर वह मॉडल और रिविज़न लोड करें जिसे आपने रखने का फ़ैसला किया था। जाने-पहचाने नतीजे वाला कोई छोटा काम चलाएँ — सिर्फ़ Python लाइब्रेरी इंपोर्ट हो जाने से मॉडल फ़ाइलों की जाँच नहीं होती। ऑफ़लाइन ऐक्सेस चाहिए, तो बिना नेटवर्क के Mac पर भरोसा करने से पहले नेटवर्क बंद करके टेस्ट करें।

अगर अगली बार वही मॉडल फिर से डाउनलोड होने लगे, तो हो सकता है सफ़ाई ने ऐसा डेटा हटा दिया हो जिसकी काम को अब भी ज़रूरत है। यह चयन, स्टोरेज क्षमता या कैश की जगह पर दोबारा सोचने का संकेत है। किसी ज़रूरी मॉडल को बार-बार डिलीट और डाउनलोड करना समय और बैंडविड्थ बर्बाद करता है, और जगह की असली समस्या हल नहीं होती।

अगर नियमित रूप से ज़रूरी मॉडल आपके Mac की क्षमता से ज़्यादा हैं, तो बाहरी ड्राइव मदद कर सकती है। उसकी ख़ाली जगह, अनुमतियाँ और सिम्बॉलिक लिंक का सपोर्ट जाँचें — यही लिंक स्नैपशॉट को साझा ब्लॉब से जोड़ सकते हैं। कॉपी करते समय ये लिंक और जिन फ़ाइलों की ओर वे इशारा करते हैं, दोनों बचाएँ। हर ऐप्लिकेशन को नई जगह इस्तेमाल करने के लिए सेट करें और मूल कॉपी हटाने से पहले वहाँ उसके ज़रूरी मॉडल टेस्ट करें। जब भी उन ऐप्लिकेशन को ड्राइव की ज़रूरत हो, उसे जुड़ा रखें।

कोई जाँच विफल हो, तो सफ़ाई रोक दें। जाँच के लिए ज़रूरी मॉडल, रिविज़न, कैश पाथ और एरर अपने Mac पर नोट करें। देखें कि ऐप्लिकेशन वही एनवायरनमेंट इस्तेमाल करता है जो आपने जाँचा था, और क्या उसे कोई हटाई गई फ़ाइल चाहिए। ऐक्सेस और ख़ाली जगह पक्की करके बैकअप रीस्टोर करें या ज़रूरी रिविज़न डाउनलोड करें। अगली एंट्री हटाने से पहले यह गड़बड़ी सुलझाएँ, ताकि पता रहे कि समस्या किस बदलाव से आई।

हमने इन कमांड को कैसे जाँचा

2026-09-29 को हमने ऑफ़लाइन एक अस्थायी Hub जैसा कैश बनाया, जिसमें दो सिंथेटिक रिविज़न, एक साझा ब्लॉब और हर रिविज़न का एक अपना ब्लॉब था। huggingface_hub 2.0.0 के साथ रिविज़न की सूची ठीक बनी, rm और prune के ड्राई रन से टेस्ट कैश में कोई बदलाव नहीं हुआ, और पुराना रिविज़न हटाने पर मौजूदा रिविज़न व उसका साझा डेटा बचा रहा, जबकि पुराने रिविज़न का अपना ब्लॉब डिलीट हो गया।

दूसरी ऑफ़लाइन जाँच में पुष्टि हुई कि --show-warnings जानबूझकर बिगाड़ी गई कैश एंट्री दिखा देता है, --no-truncate पूरा रिविज़न ID बनाए रखता है, और ड्राई रन टाइप-उपसर्ग वाला रिपॉज़िटरी ID और पूरा रिविज़न हैश, दोनों स्वीकार करते हैं — टेस्ट कैश बदले बिना।

इन जाँचों में अस्थायी फ़ोल्डरों की सिंथेटिक फ़ाइलें इस्तेमाल हुईं। असली मॉडल डाउनलोड, इनफ़रेंस, किसी यूज़र का कैश, ड्राइव पर ले जाना या रिपॉज़िटरी के बीच साझा ब्लॉब की सफ़ाई इनमें नहीं जाँची गई। ये न बताती हैं कि आपके Mac पर कितने गीगाबाइट ख़ाली होंगे, न हर कैश फ़ॉर्मैट को सही साबित करती हैं। ख़राब या कस्टम कैश हो, तो एंट्री हटाने से पहले उसकी जाँच करें।

AskClean आपको दिखा सकता है कि Mac पर जगह कहाँ इस्तेमाल हो रही है। स्कैन और प्रीव्यू मुफ़्त हैं; AI विश्लेषण और सफ़ाई के लिए Pro चाहिए। डिस्क क्लीनअप आपके पुष्टि किए गए आइटम स्थायी रूप से डिलीट कर देता है। कैश किए गए रिविज़न और उनकी साझा फ़ाइलें Hugging Face CLI से मैनेज करें, और अपने प्रोजेक्ट का मूल काम सफ़ाई के चयन से बाहर रखें।

क्या दोबारा बन सकता है और क्या रखना ज़रूरी है

हर श्रेणी अलग से जाँचें। यह तालिका बताती है कि आपको क्या बचाना या वापस लाना होगा; यह किसी फ़ाइल को अपने-आप डिलीट करने के लिए चिह्नित नहीं करती।

आइटमकहाँ जाँचेंहटाने से पहले क्या जाँचें
Hub रिपॉज़िटरी या रिविज़नhf cache ls --revisionsसटीक चयन जाँचें। वापस लाने के लिए दोबारा डाउनलोड और उसी रिपॉज़िटरी का ऐक्सेस चाहिए हो सकता है।
साझा ब्लॉब और स्नैपशॉटपक्का किया गया Hub कैशकैश मैनेजर इस्तेमाल करें; रिविज़न — और कुछ संरचनाओं में रिपॉज़िटरी भी — एक ही सहेजी गई फ़ाइलें साझा कर सकते हैं।
डिटैच्ड रिविज़नhf cache prune --dry-runकैश में नाम वाला रेफ़रेंस न होने पर भी किसी प्रोजेक्ट को ठीक वही रिविज़न चाहिए हो सकता है।
बना हुआ डेटासेट कैशHF_DATASETS_CACHE / Datasets के कैश नियंत्रणHub डाउनलोड से अलग; दोबारा बनाने में प्रोसेसिंग का समय और मूल डेटा लग सकता है।
कस्टम चेकपॉइंट, अडैप्टर और सोर्सआपके प्रोजेक्ट और बैकअप की जगहेंअपना मूल काम रखें। जाँचें कि बैकअप में वह शामिल है, ख़ासकर तब जब वह किसी कैश डायरेक्टरी के अंदर रखा हो।
Hugging Face होम डायरेक्टरी और ऑथेंटिकेशन डेटाHF_HOMEमॉडल कैश की एंट्री हटाने के लिए पूरी होम डायरेक्टरी डिलीट न करें।

लोकल जाँच में एक बहुत छोटा सिंथेटिक कैश इस्तेमाल हुआ था। उसका आकार न कोई बेंचमार्क है, न असल में होने वाली बचत का अनुमान।

FAQ

क्या Mac पर ~/.cache/huggingface डिलीट किया जा सकता है?

पूरी डायरेक्टरी को फेंकने लायक़ न मानें। सक्रिय Hub कैश ढूँढें, ऑथेंटिकेशन डेटा और अपना मूल काम बचाएँ, फिर इंस्टॉल किए गए hf cache कमांड से ख़ास रिपॉज़िटरी या रिविज़न हटाने का प्रीव्यू देखें।

एक रिविज़न हटाने पर उसके दिखाए आकार से कम जगह क्यों ख़ाली होती है?

रिविज़न फ़ाइलें साझा कर सकते हैं, और कुछ कैश संरचनाओं में अलग-अलग रिपॉज़िटरी भी। प्रीव्यू का अनुमान देखें और पहले व बाद में डिस्क की खपत और उपलब्ध जगह की तुलना करें। दिखाए गए आकार जोड़ने पर वही फ़ाइलें एक से ज़्यादा बार गिनी जा सकती हैं।

क्या डिटैच्ड रिविज़न का मतलब है कि उसे कोई ऐप्लिकेशन इस्तेमाल नहीं करता?

नहीं। कैश में नाम वाला रेफ़रेंस न होने पर भी कोई प्रोजेक्ट ठीक उसी रिविज़न को पिन कर सकता है। prune से पहले प्रोजेक्ट की ज़रूरतें जाँचें।

क्या सफ़ाई के बाद मेरे मॉडल ऑफ़लाइन उपलब्ध रहेंगे?

सिर्फ़ बचाई गई और पूरी कैश फ़ाइलें ही उन कामों को चला सकती हैं जिन्हें उनकी ज़रूरत है। बैकअप हटाने या बिना नेटवर्क के मशीन पर भरोसा करने से पहले ऑफ़लाइन में कोई प्रतिनिधि मॉडल लोड करके जाँचें।

क्या hf cache rm मेरा फ़ाइन-ट्यून किया मॉडल भी हटा देगा?

हटा सकता है, अगर आपकी कस्टम फ़ाइलें चुनी गई कैश एंट्री के अंदर हैं। चेकपॉइंट, अडैप्टर और बदली गई फ़ाइलें उन एंट्री से बाहर रखें जिन्हें आप हटाने वाले हैं, और उनके बैकअप जाँचें। “cache” नाम वाले फ़ोल्डर में भी आपके अहम काम की इकलौती कॉपी हो सकती है।

स्रोत

मॉडल और डेवलपर स्टोरेज पर और गाइड