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

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

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

Власні checkpoint, adapter, зміни tokenizer, результати конвертації, приватні дані й налаштування можуть бути недоступними для повторного завантаження. Перевірте копії: деякі засоби пропускають кеші з CACHEDIR.TAG. Збережіть усе без відомого способу відновлення. Давній час доступу не доводить, що модель непотрібна.

Покажіть повні ID й попередження

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

Перевірте обсяг перед підтвердженням

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

Після перевірки приберіть лише --dry-run, зберігши ціль, шлях і запит підтвердження. Якщо вибір змінився або попередній перегляд не вдався, зупиніть видалення й з’ясуйте причину. Файли видаляються одразу, без Смітника; відновлення потребує копії або нового доступу до завантаження. Snapshot, а в деяких структурах і репозиторії, ділять blob. Довірте посилання менеджеру кешу й не додавайте показані розміри напряму.

Відрізняйте prune від інших кешів

У перевіреній версії 2.0.0 hf cache prune --dry-run показує detached-ревізії й незавершені завантаження. Проєкт може вимагати точну ревізію навіть без іменованого посилання. Перевірте кожну ціль і зупиніть активні завантаження. Почніть з одного чітко визначеного елемента.

Дані, створені в HF_DATASETS_CACHE, відрізняються від завантажень Hub. Окремо перевірте передавання Xet і результати local_dir, зберігши локальні зміни. Видалення всього HF_HOME не замінює цього огляду.

Перевірте роботу збережених моделей

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

Для зовнішнього диска перевірте місце, права й підтримку символічних посилань. Скопіюйте посилання разом із цілями, налаштуйте кожну програму й перевірте моделі до видалення оригіналу. Під час використання диск має бути під’єднаний.

Межі перевірки

2026-09-29 з huggingface_hub 2.0.0 офлайн перевірено тимчасові синтетичні кеші: списки, повні ID, попередження й dry-run. Попередні перегляди не змінювали файли; видалення старої ревізії зберігало поточну та спільні дані. Реальне виконання моделей, кеші користувачів, очищення спільних blob між репозиторіями й перенесення диска не перевірялися. Фіксований виграш місця не гарантується. Свою версію перевірте через hf cache --help.

Що перевірити перед видаленням

Уточніть фактичний шлях, призначення й спосіб відновлення. Таблиця не є списком для автоматичного видалення та не обіцяє певної кількості вільного місця.

FAQ