איך לנקות את המטמון של Hugging Face ב-Mac
צוות AskClean · עודכן 2026-11-02
כדי לפנות מקום ממטמון Hugging Face ב-Mac, אתרו את המטמון שהאפליקציה שלכם משתמשת בו, בדקו אותו עם hf cache ls והציגו מראש הסרה של מאגר או גרסה מסוימים עם hf cache rm --dry-run. שמרו מודלים שנחוצים לעבודה בלי רשת ואת העבודה שיצרתם בעצמכם. אל תמחקו בלי בדיקה קובצי blob משותפים או את כל התיקייה HF_HOME.

אתרו את המטמון הנכון והגנו על העבודה שלכם
מטמון ה-Hub נמצא בדרך כלל בנתיב ~/.cache/huggingface/hub. המשתנה HF_HUB_CACHE קובע ישירות את מטמון המאגרים של ה-Hub, ו-HF_HOME משנה את תיקיית הבית הרחבה יותר של Hugging Face; כש-HF_HOME לא מוגדר, גם XDG_CACHE_HOME עשוי להשפיע על ברירת המחדל, וארגומנט cache_dir באפליקציה יכול לבחור מיקום אחר לגמרי. בדקו את הסביבה שמפעילה את האפליקציה במקום להניח שכל אפליקציה משתמשת בהגדרות של המסוף שלכם: אפליקציות גרפיות, kernels של notebook ופרויקטים בשורת הפקודה עשויים לפעול עם הגדרות שונות. גם תיקיית Hub ריקה במיקום ברירת המחדל לא אומרת שאין מודלים ב-Mac — אפליקציה אחרת עשויה להשתמש במטמון מותאם או באחסון מודלים משלה.
התיקייה HF_HOME עשויה להכיל גם נתוני אימות, לכן אל תמחקו את כולה כדי לפנות הורדות של מודלים. בדקו את מיקום המטמון אצלכם, ואם אתם מבקשים עזרה, שתפו רק את ההגדרות הרלוונטיות בלי ערכים רגישים — בלי קובצי אימות ובלי רשימות של מאגרים פרטיים.
הפרידו בין הורדות לבין מה שיצרתם בעצמכם: checkpoints שעברו כוונון (fine-tuning), adapters, שינויים ב-tokenizer, תוצרי המרה, מערכי נתונים פרטיים, notebooks, פרומפטים והגדרות פרויקט. מודל בסיס שהורד אפשר בדרך כלל להוריד שוב, אבל adapter מקומי או מתכון המרה עשויים להתקיים רק ב-Mac הזה. גבו את העבודה הזו ובדקו את הגיבוי לפני שאתם מפנים אחסון שקשור למודלים — חלק מכלי הגיבוי מדלגים על מטמונים שמסומנים ב-CACHEDIR.TAG. אם אינכם יודעים איך לשחזר פריט ולהחזיר את האפליקציה לעבודה, השאירו אותו בינתיים והתחילו מפריט מטמון קטן יותר שאתם מבינים את תפקידו.
בדקנו את הפקודות האלה עם huggingface_hub 2.0.0 בתאריך 2026-09-29. הריצו קודם hf cache --help בסביבה שלכם; אם הגרסה שלכם מציעה פקודות או אפשרויות אחרות, פעלו לפי התיעוד שלה.
בדקו מאגרים וגרסאות לפני שאתם בוחרים
התחילו ב-hf cache ls --no-truncate כדי לראות מזהי מאגרים מלאים, ואז הריצו hf cache ls --revisions --no-truncate --show-warnings כדי לבדוק את ה-hash המלא של כל גרסה (revision) ובעיות במטמון. בגרסה שנבדקה, אזהרות מפורטות מוסתרות כברירת מחדל. במטמון Hub מותאם העבירו לכל הפקודות את אותו ערך --cache-dir, ושמרו את הפלט לעצמכם אם הוא חושף פרויקטים חסויים.
הגודל שמוצג לגרסה עשוי להיות גדול מהמקום שמחיקתה תפנה: snapshots יכולים לחלוק נתונים, ובמבנים מסוימים גם מאגרים שונים חולקים blobs — כך שחיבור הגדלים עלול לספור את אותם קבצים יותר מפעם אחת. חקרו אזהרות על רשומות לא קריאות או לא עקביות לפני ההסרה; סריקה שהסתיימה לא מוכיחה שכל קובץ זוהה. בחרו יעד מוגדר, כמו ניסוי נטוש או גרסה שהפרויקט כבר לא משתמש בה, ובדקו בקוד ובהגדרות אם יש גרסאות מקובעות (pinned). זמני גישה יכולים לעזור, אבל מודל ישן עשוי עדיין להידרש להערכה מזדמנת או לשחזור בלי רשת — גיל לבדו אינו סיבה למחוק.
- סגרו את האפליקציות והמשימות שמשתמשות במטמון המועמד.
- הריצו hf cache ls --no-truncate ואז hf cache ls --revisions --no-truncate --show-warnings על נתיב המטמון שאימתתם.
- בדקו אם אפליקציה או פרויקט כלשהו עדיין צריכים את המאגר והגרסה שבחרתם.
- רשמו את גודל התיקייה ואת המקום הפנוי בדיסק לפני כל שינוי.
הציגו מראש את ההסרה לפני האישור
השתמשו ב-hf cache rm עם מזהה מאגר מלא אחד או עם hash מלא של גרסה מתוך הרשימה שלכם, והוסיפו קודם --dry-run. במאגר של מודל השאירו את הקידומת model/ שה-CLI מציג; שם תיקייה בדיסק שמתחיל ב-models-- אינו אותו מזהה. לגרסה בודדת השתמשו ב-hash המלא ובדקו לאיזה מאגר היא שייכת. התצוגה המקדימה מסכמת את היעדים ואת החיסכון המשוער במקום — היא לא רשימה של כל קובץ. בחירה במאגר כוללת את כל הגרסאות שלו שבמטמון, לכן אם אתם רוצים להסיר רק גרסה אחת, בחרו גרסה כיעד. אחרי שבדקתם את ההיקף, חזרו על אותה פקודה בלי --dry-run, והשאירו את בקשת האישור פעילה לבדיקה אחרונה.
השתמשו באותו יעד ובאותה תיקיית מטמון בתצוגה המקדימה ובהסרה. אם הרשימה משתנה באופן לא צפוי, בדקו אם אפליקציה אחרת הופעלה מחדש או הורידה נתונים; אם התצוגה המקדימה נכשלת, עצרו ובדקו למה. תנו למנהל המטמון של Hugging Face לטפל בקובצי blob משותפים ובהפניות של snapshots — מחיקת קבצים בודדים ב-Finder עלולה לפגוע בגרסאות אחרות שזקוקות להם. ההסרה מוחקת קבצים ישירות ולא מעבירה אותם לפח האשפה: כדי לשחזר גרסה שהוסרה תצטרכו גיבוי תקין או הורדה נוספת. שמרו גיבוי עד שהבדיקות עוברות, במיוחד למודלים פרטיים, מוגבלי גישה (gated), כאלה שכבר לא מפורסמים, מודלים ששיניתם מקומית או מודלים שנחוצים בלי רשת.
בחרו את היעד מתוך רשימת המטמון שלכם, ובדקו בקפידה גם את המאגר וגם את הגרסה לפני שאתם מריצים את פקודת ההסרה.
בדקו כל מועמד לפני prune, והפרידו מטמונים אחרים
בגרסה 2.0.0 שנבדקה, hf cache prune --dry-run מציג גרסאות detached והורדות שלא הושלמו. לגרסה detached אין הפניה בעלת שם במטמון, אבל ייתכן שהפרויקט שלכם עדיין מבקש בדיוק את הגרסה הזו — ה-CLI לא יודע באילו מודלים תשתמשו בהמשך. בניקוי הראשון במחשב פיתוח, הסרה מפורשת אחת קלה יותר להערכה מניקוי רחב. אם תבחרו בהמשך ב-prune, החילו את אותה רשימת בדיקה על כל המועמדים ועצרו קודם הורדות פעילות: קובץ לא שלם עשוי להיות של העברה שעדיין רצה.
Hugging Face Datasets שומר נתונים מעובדים במטמון משלו: הסרת הורדות מה-Hub לא בהכרח מסירה נתוני Arrow או תוצאות עיבוד של pipeline, ול-HF_DATASETS_CACHE ול-HF_HUB_CACHE יש תחומים שונים. הורדות עם local_dir מפורש נשמרות ביעד שבחרתם, יחד עם המטא-נתונים שלהן; טפלו בתיקייה הזו בנפרד מהמטמון המשותף, ושמרו שינויים שעשיתם בקבצים שהורדו, כי הורדה חדשה לא תשחזר אותם. גם אחסון ההעברות של Xet נפרד: בדקו את המיקום שלו ואת גרסת הלקוח שיצרה אותו לפני שאתם מחליטים מה להסיר, ואם השימוש בדיסק עדיין גבוה, בדקו כל קטגוריה בנפרד.
ודאו שהמודלים שנשארו עדיין עובדים
חזרו על הרשימה ועל מדידות הדיסק, ואז טענו מודל וגרסה שהחלטתם לשמור והריצו משימה קטנה עם תוצאה ידועה — ייבוא מוצלח של ספריית Python לא בודק את קובצי המודל. אם אתם צריכים גישה בלי רשת, בדקו כשהרשת באמת מנותקת, לפני שאתם סומכים על ה-Mac מחוץ לחיבור. אם ההרצה הבאה מורידה שוב את אותו מודל, ייתכן שהניקוי הסיר נתונים שעדיין נחוצים; מחיקה והורדה חוזרות ונשנות של מודל נחוץ מבזבזות זמן ורוחב פס ולא פותרות את בעיית הקיבולת.
אם המודלים שאתם צריכים באופן קבוע חורגים מהקיבולת של ה-Mac, כונן חיצוני עשוי לעזור. בדקו שטח פנוי, הרשאות ותמיכה בקישורים סמליים (symlinks), שמחברים snapshots ל-blobs משותפים, ושמרו בזמן ההעתקה על הקישורים ועל הקבצים שהם מצביעים עליהם. הגדירו כל אפליקציה להשתמש במיקום החדש ובדקו שם את המודלים הנחוצים לפני הסרת המקור, והשאירו את הכונן מחובר בכל פעם שהאפליקציות צריכות אותו. אם בדיקה נכשלת, עצרו את הניקוי: רשמו את המודל, הגרסה, נתיב המטמון והשגיאה, שחזרו מגיבוי או הורידו את הגרסה הדרושה, ופתרו את התקלה לפני שאתם מסירים פריט נוסף — כך תדעו איזה שינוי גרם לבעיה.
איך בדקנו את הפקודות
בתאריך 2026-09-29 יצרנו מטמון זמני בסגנון Hub, בלי רשת, עם שתי גרסאות סינתטיות, blob משותף אחד ו-blob ייחודי לכל גרסה. עם huggingface_hub 2.0.0 הצגת הגרסאות הצליחה, הרצות הניסיון של rm ושל prune לא שינו את קובצי הבדיקה, והסרת הגרסה הישנה שמרה את הגרסה הנוכחית ואת הנתונים המשותפים ומחקה את ה-blob הייחודי הישן. בדיקה נוספת בלי רשת אישרה שהדגל --show-warnings חושף רשומה פגומה שנוצרה בכוונה, שהדגל --no-truncate שומר את מזהה הגרסה המלא, ושהרצות ניסיון מקבלות גם מזהה מאגר עם קידומת סוג וגם hash מלא של גרסה — בלי לשנות את קובצי הבדיקה.
הבדיקות השתמשו בקבצים סינתטיים בתיקיות זמניות. הן לא בדקו הורדות אמיתיות של מודלים, הרצת מודלים (inference), מטמון של משתמש אמיתי, העברה לכונן אחר או ניקוי blobs שמשותפים בין מאגרים, והן לא מנבאות כמה ג'יגה-בייטים יתפנו אצלכם. בדקו מטמון פגום או מותאם לפני שאתם מסירים ממנו פריטים.
AskClean יכול להראות לכם היכן נצרך האחסון ב-Mac. הסריקה והתצוגה המקדימה בחינם; ניתוח AI וניקוי דורשים Pro. ניקוי הדיסק מוחק לצמיתות את הפריטים שאישרתם. לניהול הגרסאות שבמטמון ושל הקבצים המשותפים שלהן השתמשו ב-CLI של Hugging Face, והשאירו את העבודה המקורית שלכם מחוץ לבחירה.
מה אפשר ליצור מחדש, ומה חייבים לשמור
בדקו כל קטגוריה בנפרד. הטבלה מסבירה מה צריך לשמור או לשחזר; היא לא מסמנת קבצים למחיקה אוטומטית.
| פריט | היכן לבדוק | מה לבדוק לפני ההסרה |
|---|---|---|
| מאגר או גרסה ב-Hub | hf cache ls --revisions | בדקו את הבחירה המדויקת. כדי לשחזר אותה ייתכן שתצטרכו הורדה נוספת וגישה לאותו מאגר. |
| blobs ו-snapshots משותפים | מטמון ה-Hub שאימתתם | השתמשו במנהל המטמון: גרסאות, ובמבנים מסוימים גם מאגרים, עשויות לחלוק את אותם קבצים. |
| גרסאות detached | hf cache prune --dry-run | פרויקט עשוי עדיין להזדקק לגרסה מדויקת גם כשאין לה הפניה בעלת שם במטמון. |
| מטמון של מערכי נתונים שנוצרו | HF_DATASETS_CACHE / הגדרות המטמון של Datasets | נפרד מהורדות ה-Hub; יצירה מחדש עשויה לדרוש זמן עיבוד ואת נתוני המקור. |
| checkpoints, adapters וקוד המקור שלכם | הפרויקט ומיקומי הגיבוי שלכם | שמרו את העבודה המקורית ובדקו שהגיבויים כוללים אותה, במיוחד אם היא שמורה בתוך תיקיית מטמון. |
| תיקיית הבית של Hugging Face ונתוני האימות | HF_HOME | אל תמחקו את כל תיקיית הבית כדי להסיר פריטי מטמון של מודלים. |
בדיקת הרגרסיה המקומית השתמשה במטמון סינתטי זעיר; הגודל שלו אינו מדד ביצועים ואינו הערכה של חיסכון אמיתי.
שאלות נפוצות
אפשר למחוק את ~/.cache/huggingface ב-Mac?
אל תתייחסו לכל התיקייה כאל משהו שאפשר לזרוק. אתרו את מטמון ה-Hub הפעיל, שמרו את נתוני האימות ואת העבודה המקורית, ואז הציגו מראש הסרה של מאגרים או גרסאות מפורשים בעזרת hf cache שמותקן אצלכם.
למה הסרת גרסה אחת מפנה פחות מהגודל שמוצג לה?
גרסאות יכולות לחלוק קבצים, ובמבנים מסוימים גם מאגרים חולקים אותם. בדקו את ההערכה בתצוגה המקדימה והשוו את השימוש בדיסק ואת המקום הפנוי לפני ואחרי. חיבור הגדלים המוצגים של גרסאות עלול לספור את אותם קבצים יותר מפעם אחת.
האם גרסה detached אומרת שאף אפליקציה לא משתמשת בה?
לא. פרויקט יכול לקבע גרסה מדויקת גם כשאין לה הפניה בעלת שם במטמון. בדקו את הדרישות של הפרויקט לפני prune.
האם המודלים יהיו זמינים בלי רשת אחרי הניקוי?
רק קבצים שנשארו במטמון בשלמותם יכולים לשרת עבודה שזקוקה להם. בדקו טעינה מייצגת בלי רשת לפני שאתם מוחקים את הגיבוי או סומכים על המחשב כשהוא מנותק.
האם hf cache rm ימחק מודל שכיווננתי?
כן, אם הקבצים המותאמים שלכם נמצאים בתוך פריט המטמון שבחרתם. שמרו checkpoints, adapters וקבצים ששיניתם מחוץ לפריטים שאתם מתכננים להסיר, ובדקו את הגיבויים שלהם. תיקייה בשם cache עדיין יכולה להכיל את העותק היחיד של עבודה חשובה.
מקורות