¿Dónde está el directorio de la caché de Hugging Face?

Para Hugging Face Hub, el directorio de caché predeterminado documentado es ~/.cache/huggingface/hub. Sin embargo, la ubicación activa puede sustituirse, así que inspecciona la configuración y la propia caché antes de considerar desechable una carpeta.

Ruta predeterminada y sustituciones documentadas

La caché del Hub almacena bajo su raíz los repositorios descargados de modelos, conjuntos de datos y aplicaciones Space. La raíz predeterminada es ~/.cache/huggingface/hub. En ella, los repositorios suelen tener nombres como models--organization--repository, con directorios para blobs, instantáneas y referencias.

• HF_HUB_CACHE establece directamente el directorio de caché del Hub y tiene prioridad.
• HF_HOME establece el directorio principal de Hugging Face; cuando está definido, la caché del Hub se encuentra en HF_HOME/hub.
• Las llamadas individuales a bibliotecas también pueden indicar un directorio de caché, por lo que un proyecto puede utilizar una ruta distinta del valor predeterminado global.

Inspecciona antes de liberar nada

Utiliza la CLI de Hugging Face para ver qué conoce su gestor sobre la caché activa. El comando documentado hf cache ls enumera los repositorios almacenados en caché, su tamaño y la información de acceso. Si has movido la caché, combina los comandos de gestión con la opción correspondiente del directorio de caché en lugar de dar por hecho el valor predeterminado.

# Muestra qué ubicación utilizará este shell
printf '%s\n' "${HF_HUB_CACHE:-${HF_HOME:-$HOME/.cache/huggingface}/hub}"

# Haz un inventario de los repositorios almacenados en caché antes de eliminar datos obsoletos
hf cache ls

Antes de eliminar una instantánea, identifica el proyecto, el entorno de ejecución y la revisión que la utilizan. Una caché puede contener más que el archivo de modelo que tienes en mente, y un árbol de fuentes o flujo de inferencia local puede depender de una revisión almacenada en caché que no resulte evidente en un explorador de archivos.

Limpieza de la caché frente a conservación a largo plazo

La caché de Hugging Face está optimizada para evitar descargas innecesarias. No es automáticamente un catálogo a largo plazo de las versiones de modelos que quieras conservar. Si un grupo de artefactos de modelos terminados importa para tu trabajo, decide primero qué necesitarás recuperar más adelante y conserva una copia de seguridad independiente cuando proceda.

Tensor Archive encaja después de esa decisión: puede conservar una familia local relacionada, verificarla y restaurar una copia exacta independiente antes de que elimines manualmente una copia de trabajo redundante. No sustituye la gestión de caché propia de Hugging Face ni indica a una biblioteca activa dónde descargar modelos.

Una secuencia segura

1. Comprueba si HF_HUB_CACHE o HF_HOME cambian la ubicación activa.
2. Enumera la caché con las herramientas de Hugging Face e identifica los repositorios que ya no necesitas de inmediato.
3. Conserva o haz una copia de seguridad independiente de cualquier versión de modelo que sea importante.
4. Para una familia relacionada y terminada, analízala, archívala, verifícala y restaura una copia independiente antes de liberar espacio manualmente.

Si la caché está en el disco equivocado, cambia el directorio de la caché de Hugging Face con la variable de entorno correcta. Si el problema son revisiones obsoletas, borra la caché de Hugging Face con seguridad mediante el gestor de caché. Los archivos que pertenezcan a otro entorno de ejecución necesitan la guía de almacenamiento de ese entorno.