Как проверить и очистить кеш 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.

Что проверить перед удалением

Уточните фактический путь, назначение и способ восстановления. Таблица не является списком для автоматического удаления и не обещает определённый объём свободного места.

Частые вопросы