AskClean

Як перевірити й очистити кеш Hugging Face на Mac

Команда AskClean · Оновлено 2026-11-02

Щоб звільнити місце, зайняте кешем Hugging Face на Mac, визначте кеш, який використовує ваша програма, перегляньте його командою hf cache ls і перевірте видалення конкретного репозиторію чи ревізії через hf cache rm --dry-run. Збережіть моделі, потрібні без мережі, і власні напрацювання. Не видаляйте наосліп спільні блоби чи всю папку HF_HOME.

Концептуальна ілюстрація: ревізії моделі повʼязані зі спільними блоками даних, а файли проєкту зберігаються окремо
Кілька ревізій можуть ділити ті самі файли. Власні чекпойнти й проєкти зберігайте окремо. Концептуальна ілюстрація.

Знайдіть активний кеш і захистіть власну роботу

Типовий кеш Hub — ~/.cache/huggingface/hub. Змінна HF_HUB_CACHE задає кеш репозиторіїв Hub напряму, HF_HOME змінює ширшу домашню папку Hugging Face, а XDG_CACHE_HOME впливає на типове розташування, якщо HF_HOME не задано; програма може вибрати й інше місце через аргумент cache_dir. Перевіряйте середовище, з якого запускається програма: графічні програми, ядра Jupyter-нотатників і проєкти командного рядка можуть мати різні налаштування, а порожня типова папка не означає, що моделей на Mac немає. HF_HOME може містити дані автентифікації, тож не видаляйте всю папку, щоб прибрати завантажені моделі, і не діліться її вмістом, зокрема списками приватних репозиторіїв.

Відокремте завантаження від створених вами артефактів: донавчених чекпойнтів, адаптерів, змін токенізатора, результатів конвертації, приватних наборів даних, нотатників і налаштувань проєкту. Базову модель, імовірно, можна завантажити знову, а локальний адаптер чи рецепт конвертації може існувати лише на цьому Mac. Створіть і перевірте резервну копію такої роботи: деякі засоби резервного копіювання пропускають кеші, позначені CACHEDIR.TAG. Якщо не знаєте, як відновити елемент і знову запустити програму, поки що залиште його; давній час доступу не доводить, що модель непотрібна.

Ці команди ми перевіряли з huggingface_hub 2.0.0 29 вересня 2026 року. Спершу виконайте hf cache --help у своєму середовищі: якщо ваша версія пропонує інші команди чи параметри, дотримуйтеся її документації.

Перегляньте репозиторії й ревізії з повними ID

Почніть із hf cache ls --no-truncate, щоб побачити повні ідентифікатори репозиторіїв, а потім виконайте hf cache ls --revisions --no-truncate --show-warnings, щоб перевірити повні хеші ревізій і проблеми кешу — у перевіреній версії докладні попередження типово приховано. Для власного кешу Hub передавайте те саме значення --cache-dir у кожну команду, а вивід, що згадує конфіденційні проєкти, нікому не показуйте.

Показаний розмір ревізії може перевищувати місце, яке звільнить її видалення: знімки (snapshots), а в деяких структурах кешу й репозиторії, ділять спільні блоби, тож сума розмірів рахує ті самі файли кілька разів. Дослідіть попередження про нечитабельні чи неузгоджені записи, перш ніж щось видаляти. Вибирайте конкретну ціль — покинутий експеримент чи ревізію, якої проєкт більше не використовує, — і перевірте код та конфігурацію на зафіксовані ревізії: сам вік моделі не причина її видаляти.

  1. Закрийте програми й завдання, які використовують кеш-кандидат.
  2. Для перевіреного шляху кешу виконайте hf cache ls --no-truncate, а потім hf cache ls --revisions --no-truncate --show-warnings.
  3. Перевірте, чи потрібні вибраний репозиторій і ревізія якійсь програмі чи проєкту.
  4. Перш ніж щось змінювати, запишіть поточний розмір папки й вільне місце на диску.

Перевірте видалення в пробному режимі

Передайте hf cache rm один повний ідентифікатор репозиторію чи хеш ревізії зі своєї інвентаризації й спершу додайте --dry-run. Для репозиторію моделі залиште префікс model/, який показує CLI: назва папки на диску, що починається з models--, — це інший ідентифікатор. Для однієї ревізії використовуйте її повний хеш і перевірте, до якого репозиторію вона належить. Пробний запуск показує підсумок цілей і приблизний виграш місця, а не перелік кожного файлу; ціль-репозиторій охоплює всі його кешовані ревізії.

Переконавшись в охопленні, повторіть ту саму команду без --dry-run — з тим самим каталогом кешу й увімкненим запитом підтвердження. Якщо список несподівано змінився, перевірте, чи не перезапустилася інша програма і чи не завантажила вона дані; якщо пробний запуск не вдався, зупиніться й зʼясуйте причину. Спільні блоби й посилання знімків залиште менеджерові кешу Hugging Face: видалення окремих файлів у Finder може зачепити інші ревізії. Видалення з кешу стирає файли одразу, без Смітника, тож тримайте резервну копію, доки перевірки не пройдуть, — особливо для приватних, закритих (gated), знятих із публікації, локально змінених моделей і тих, що потрібні без мережі.

Вибирайте ціль зі своєї інвентаризації кешу й уважно перевіряйте і репозиторій, і ревізію, перш ніж запускати команду видалення.

Prune та інші кеші — окремо

У перевіреній версії CLI 2.0.0 команда hf cache prune --dry-run показує відʼєднані (detached) ревізії й незавершені завантаження. Відʼєднана ревізія не має іменованого посилання в кеші, але проєкт однаково може запитувати саме її, тож перевірте проєкти, перш ніж погоджуватися на видалення. Для першого очищення на робочому Mac одне явне видалення простіше оцінити, ніж широке прибирання; якщо згодом запускатимете prune, застосуйте той самий контрольний список до всіх кандидатів і спершу зупиніть активні завантаження — незавершений файл може належати завданню, яке ще працює.

Datasets від Hugging Face можуть зберігати оброблені дані у власному кеші (HF_DATASETS_CACHE), тож видалення завантажень Hub не прибирає даних Arrow чи результатів перетворень. Завантаження з явним local_dir потрапляють у папку, яку вибрали ви чи програма, разом із метаданими — розглядайте її окремо й збережіть свої правки, бо нове завантаження їх не поверне. Сховище передавання Xet теж окреме: перевірте його розташування й версію клієнта, перш ніж щось видаляти. Видалення всього HF_HOME не замінює такого огляду.

Перевірте, що решта моделей працює

Повторіть інвентаризацію й вимірювання, запустіть модель і ревізію, які мали залишитися, і виконайте невелике завдання з відомим результатом — самого імпорту бібліотеки Python недостатньо. Якщо потрібна робота без мережі, перевірте її з реально відʼєднаною мережею. Якщо наступний запуск знову завантажує ту саму модель, очищення, ймовірно, прибрало потрібні дані: перегляньте вибір, місткість диска чи розташування кешу, а не видаляйте й завантажуйте модель знову й знову. Якщо перевірка не вдалася, призупиніть очищення, запишіть модель, ревізію, шлях і помилку, а відновлення з копії чи повторне завантаження виконуйте, переконавшись у доступі й вільному місці.

Якщо потрібні моделі не вміщуються на Mac, може допомогти зовнішній диск. Перевірте вільне місце, права доступу й підтримку символічних посилань, якими знімки повʼязані зі спільними блобами, і копіюйте посилання разом із файлами, на які вони вказують. Налаштуйте кожну програму на нове розташування й перевірте потрібні моделі там, перш ніж видаляти оригінал; диск має бути підключений щоразу, коли ці програми його використовують.

Як ми перевіряли ці команди

29 вересня 2026 року ми офлайн створили тимчасовий кеш у форматі Hub із двома синтетичними ревізіями, одним спільним блобом і окремим блобом для кожної ревізії. З huggingface_hub 2.0.0 список ревізій виводився, пробні запуски rm і prune не змінювали файлів, а видалення старої ревізії зберегло поточну ревізію та спільні дані й прибрало лише окремий блоб старої. Друга офлайн-перевірка підтвердила, що --show-warnings показує навмисно пошкоджений запис, --no-truncate зберігає повний ID ревізії, а пробні запуски приймають і ID репозиторію з префіксом типу, і повний хеш ревізії, нічого не змінюючи.

Ці перевірки використовували синтетичні файли в тимчасових папках. Реальні завантаження моделей, їх запуск, кеш користувача, перенесення на інший диск і очищення блобів, спільних для кількох репозиторіїв, не перевірялися, тож скільки гігабайтів звільниться на вашому Mac, вони не прогнозують; пошкоджений чи нестандартний кеш дослідіть окремо. AskClean допоможе побачити, що займає місце на Mac: сканування й перегляд безкоштовні, аналіз ШІ та очищення потребують Pro, а підтверджені елементи видаляються назавжди. Ревізіями та спільними файлами керуйте через CLI Hugging Face, а власну роботу не включайте до вибору для очищення.

Що можна відтворити, а що треба зберегти

Перевіряйте кожну категорію окремо. Таблиця пояснює, що треба зберегти чи як відновити, і не позначає файли для автоматичного видалення.

ЕлементДе перевіритиЩо перевірити перед видаленням
Репозиторій або ревізія Hubhf cache ls --revisionsПеревірте точний вибір. Відновлення може потребувати нового завантаження й доступу до того самого репозиторію.
Спільні блоби й знімкиПеревірений кеш HubКористуйтеся менеджером кешу: ревізії, а в деяких структурах і репозиторії, можуть ділити ті самі файли.
Відʼєднані ревізіїhf cache prune --dry-runПроєкту може бути потрібна саме ця ревізія, навіть якщо в кеші немає іменованого посилання на неї.
Згенерований кеш наборів данихHF_DATASETS_CACHE / налаштування кешу DatasetsОкремо від завантажень Hub; для відтворення можуть знадобитися час обробки й вихідні дані.
Власні чекпойнти, адаптери й вихідні файлиВаш проєкт і місця резервного копіюванняЗберігайте власну роботу. Переконайтеся, що резервні копії її містять, особливо якщо вона лежить у папці кешу.
Домашня папка Hugging Face і дані автентифікаціїHF_HOMEНе видаляйте всю домашню папку, щоб прибрати записи кешу моделей.

Локальна регресійна перевірка використовувала крихітний синтетичний кеш. Його розмір — не еталон і не оцінка реальної економії місця.

Часті запитання

Чи можна видалити ~/.cache/huggingface на Mac?

Не вважайте всю папку одноразовою. Визначте активний кеш Hub, збережіть дані автентифікації й власну роботу, а потім перевірте видалення конкретних репозиторіїв чи ревізій через встановлений інтерфейс hf cache.

Чому видалення однієї ревізії звільняє менше, ніж показаний розмір?

Ревізії можуть ділити файли, а в деяких структурах кешу — ще й репозиторії. Звіряйтеся з оцінкою пробного запуску й порівнюйте зайняте та вільне місце до і після: сума показаних розмірів може рахувати ті самі файли кілька разів.

Чи означає відʼєднана ревізія, що її ніхто не використовує?

Ні. Проєкт може фіксувати точну ревізію без іменованого посилання в кеші. Перш ніж запускати prune, перевірте вимоги проєкту.

Чи будуть мої моделі доступні без мережі після очищення?

Лише збережені й повні файли кешу можуть забезпечити роботу, якій вони потрібні. Перш ніж видаляти резервну копію чи працювати без підключення, перевірте, що типова модель запускається без мережі.

Чи може hf cache rm видалити мою донавчену модель?

Так, якщо ваші файли лежать усередині вибраного запису кешу. Тримайте чекпойнти, адаптери й змінені файли поза записами, які плануєте видалити, і перевіряйте їхні резервні копії. Папка з назвою cache однаково може містити єдину копію важливої роботи.

Джерела

Інші посібники про моделі й сховище розробника