Hugging Face 캐시 디렉터리는 어디에 있나요?

Hugging Face Hub의 문서화된 기본 캐시 디렉터리는 ~/.cache/huggingface/hub입니다. 하지만 활성 위치는 재정의할 수 있으므로 폴더를 소모품으로 취급하기 전에 구성과 캐시 자체를 검사하세요.

기본 경로 및 문서화된 재정의

Hub 캐시는 다운로드한 모델, 데이터 세트 및 Space 리포지터리를 캐시 루트 아래에 저장합니다. 기본 루트는 ~/.cache/huggingface/hub입니다. 그 안에서 리포지터리는 보통 models--organization--repository 같은 이름이며 블롭, 스냅샷 및 참조용 디렉터리가 있습니다.

• HF_HUB_CACHE은 Hub 캐시 디렉터리를 직접 설정하며 우선 적용됩니다.
• HF_HOME은 Hugging Face 홈 디렉터리를 설정합니다. 설정되어 있으면 Hub 캐시는 HF_HOME/hub 아래에 있습니다.
• 개별 라이브러리 호출에서도 캐시 디렉터리를 지정할 수 있으므로 프로젝트가 전역 기본값과 다른 경로를 사용할 수 있습니다.

무엇이든 공간을 회수하기 전에 검사

Hugging Face CLI를 사용해 캐시 관리자가 활성 캐시에 대해 알고 있는 내용을 확인하세요. 문서화된 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 캐시를 안전하게 정리하세요. 다른 런타임에 속한 파일에는 해당 런타임의 저장 가이드가 필요합니다.