Onde fica o diretório da cache do Hugging Face?

Para o Hugging Face Hub, o diretório predefinido documentado da cache é ~/.cache/huggingface/hub. No entanto, a localização ativa pode ser substituída, por isso inspecione a configuração e a própria cache antes de considerar uma pasta dispensável.

Caminho predefinido e substituições documentadas

A cache do Hub armazena abaixo da respetiva raiz os repositórios descarregados de modelos, conjuntos de dados e aplicações Space. A raiz predefinida é ~/.cache/huggingface/hub. Dentro dela, os repositórios têm normalmente nomes como models--organization--repository, com diretórios para blobs, snapshots e referências.

• HF_HUB_CACHE define diretamente o diretório da cache do Hub e tem prioridade.
• HF_HOME define o diretório principal do Hugging Face; quando está definida, a cache do Hub fica em HF_HOME/hub.
• As chamadas individuais das bibliotecas também podem indicar um diretório de cache, pelo que um projeto pode utilizar um caminho diferente da predefinição global.

Inspecione antes de libertar qualquer elemento

Utilize a CLI do Hugging Face para ver o que o respetivo gestor sabe sobre a cache ativa. O comando documentado hf cache ls lista repositórios em cache, tamanho e informações de acesso. Se tiver movido a cache, combine os comandos de gestão com a opção de diretório correspondente em vez de presumir a predefinição.

# Mostre que localização esta shell utilizará
printf '%s\n' "${HF_HUB_CACHE:-${HF_HOME:-$HOME/.cache/huggingface}/hub}"

# Inventarie os repositórios em cache antes da poda
hf cache ls

Antes de remover um snapshot, identifique o projeto, o ambiente de execução e a revisão que o utilizam. Uma cache pode conter mais do que o ficheiro de modelo em que está a pensar, e uma árvore de código-fonte ou um fluxo de inferência local pode depender de uma revisão em cache que não é evidente num explorador de ficheiros.

Limpeza da cache versus conservação a longo prazo

A cache do Hugging Face está otimizada para evitar descargas desnecessárias. Não é automaticamente um catálogo a longo prazo das versões de modelos que pretende preservar. Se um grupo de artefactos de modelos concluídos for importante para o seu trabalho, decida primeiro o que precisa de recuperar mais tarde e mantenha uma cópia de segurança independente quando adequado.

O Tensor Archive entra depois dessa decisão: pode preservar uma família local relacionada, verificá-la e restaurar uma cópia exata separada antes de remover manualmente uma cópia de trabalho redundante para libertar espaço. Não substitui a gestão de cache do próprio Hugging Face nem indica a uma biblioteca ativa onde descarregar modelos.

Uma sequência segura

1. Verifique se HF_HUB_CACHE ou HF_HOME altera a localização ativa.
2. Liste a cache através das ferramentas do Hugging Face e identifique os repositórios de que já não precisa imediatamente.
3. Conserve ou crie uma cópia de segurança independente de qualquer versão de modelo importante.
4. Para uma família relacionada concluída, analise-a, arquive-a, verifique-a e restaure uma cópia separada antes de recuperar espaço manualmente.

Se a cache estiver no disco errado, altere o diretório da cache do Hugging Face com a variável de ambiente correta. Se o problema forem revisões obsoletas, limpe a cache do Hugging Face em segurança através do gestor de cache. Os ficheiros pertencentes a outro ambiente de execução exigem o guia de armazenamento desse ambiente.