Где находится каталог кеша Hugging Face?

Для Hugging Face Hub документированный стандартный каталог кеша — ~/.cache/huggingface/hub. Активное расположение можно переопределить, поэтому проверьте конфигурацию и сам кеш до объявления папки расходной.

Стандартный путь и документированные переопределения

Кеш Hub хранит загруженные репозитории моделей, наборов данных и пространств под корнем кеша. Стандартный корень — ~/.cache/huggingface/hub. Внутри репозитории обычно имеют имена вида models--organization--repository и содержат каталоги блобов, снимков и ссылок.

• HF_HUB_CACHE напрямую задаёт каталог кеша Hub и имеет приоритет.
• HF_HOME задаёт домашний каталог Hugging Face; при его установке кеш Hub находится в HF_HOME/hub.
• Отдельные вызовы библиотек также могут передавать каталог кеша, поэтому проект способен использовать путь, отличный от глобального значения.

Проверьте до освобождения места

Используйте CLI Hugging Face, чтобы увидеть данные менеджера об активном кеше. Документированная команда hf cache ls выводит кешированные репозитории, размер и сведения о доступе. Если кеш перемещён, указывайте соответствующий каталог в командах управления, а не предполагайте стандартный.

# Показать расположение, которое использует эта оболочка
printf '%s\n' "${HF_HUB_CACHE:-${HF_HOME:-$HOME/.cache/huggingface}/hub}"

# Учтите кешированные репозитории до обрезки
hf cache ls

До удаления снимка определите проект, среду и ревизию, которые его используют. Кеш может содержать не только предполагаемый файл модели, а дерево исходников или локальный процесс вывода может зависеть от кешированной ревизии, неочевидной в файловом браузере.

Очистка кеша и долгосрочное хранение

Кеш Hugging Face оптимизирован для исключения ненужных загрузок. Он не является автоматически долгосрочным каталогом версий моделей для хранения. Если группа завершённых артефактов важна, сначала решите, что потребуется восстановить, и при необходимости храните независимую резервную копию.

Tensor Archive применяется после этого решения: он может сохранить связанное локальное семейство, проверить и восстановить отдельную точную копию до ручного освобождения лишней рабочей копии. Он не заменяет собственное управление кешем Hugging Face и не указывает активной библиотеке, куда загружать модели.

Безопасная последовательность

1. Проверьте, меняет ли активное расположение HF_HUB_CACHE или HF_HOME.
2. Выведите кеш средствами Hugging Face и определите репозитории, которые не нужны сейчас.
3. Сохраняйте или независимо резервируйте каждую важную версию модели.
4. Для завершённого связанного семейства проанализируйте, заархивируйте и проверьте его, а затем восстановите отдельную копию до ручного освобождения места.

Если кеш находится не на том диске, измените каталог кеша Hugging Face с правильной переменной среды. Если проблема в устаревших ревизиях, безопасно очистите кеш Hugging Face через менеджер кеша. Для файлов другой среды используйте руководство по её хранилищу.