| 항목 | 내용 |
|---|---|
| 무엇인가 | Hugging Face 모델 캐시 (.cache/huggingface) |
| 분류 | AI 모델·캐시 |
| 전형적인 크기 | 5~500GB |
| 안전도 | 지워도 됩니다 |
| 지운 뒤 다시 생기나 | 생깁니다 |
| 첫 번째 자리 | %USERPROFILE%\.cache\huggingface\hub |
| 기준 환경 | NVMe SSD |
파이썬에서 transformers·diffusers 같은 라이브러리를 쓸 때 받아 온 모델이 쌓이는 자리입니다.
코드에서 모델 이름만 적으면 자동으로 받아 옵니다. 그래서 받은 줄도 모르게 쌓이는 게 특징입니다. 버전이 바뀌면 옛 버전도 남습니다.
Hugging Face 캐시의 자리는 한 곳입니다. 탐색기 주소창에 아래 경로를 그대로 붙여 넣으면 바로 열립니다.
경로에 들어 있는 %LOCALAPPDATA% 같은 부분은 탐색기 주소창에서 알아서 풀립니다. 직접 계정 이름을 찾아 들어갈 필요는 없습니다.
%USERPROFILE%\.cache\huggingface\hubHugging Face 캐시는 지워도 됩니다. 다시 생기고, 잃는 게 거의 없습니다.
다시 받을 수 있습니다. 비공개 모델이라면 접근 권한이 아직 있는지 확인하세요.
지운 뒤에도 프로그램을 다시 쓰면 같은 자리에 다시 생깁니다. 그래서 "한 번 지우면 끝"이 아니라 "얼마나 자주 지울 것인가"의 문제입니다.
다음에 그 모델을 쓰는 코드를 돌리면 다시 받습니다. 시간이 오래 걸립니다.
아래 순서대로 하면 됩니다. 중간에 프로그램이 켜져 있으면 일부 파일이 "사용 중"으로 남으니, 먼저 닫고 시작하세요.
환경 변수 HF_HOME 을 D:\hf-cache 로 지정하면 옮겨집니다.
NVMe는 빠르지만, 빈 공간이 10% 아래로 떨어지면 쓰기 속도가 눈에 띄게 떨어집니다. 컨트롤러가 빈 블록을 찾느라 시간을 쓰기 때문입니다.
용량을 비운 뒤 최적화(TRIM)를 한 번 돌리면 지운 자리가 실제로 반납됩니다. 조각 모음이 아니라 최적화입니다.
이 환경에서 남겨 둘 여유 용량은 전체 용량의 10~15% 정도로 잡으세요. 체감 속도가 느려졌다면 용량부터 확인하세요. 수명보다 여유 공간 문제인 경우가 훨씬 많습니다.
huggingface-cli scan-cache 를 실행하면 모델별 크기와 마지막 사용일이 나옵니다. 또는 %USERPROFILE%\.cache\huggingface 폴더 속성으로 보세요.
숫자를 한 번 적어 두세요. 정리한 뒤 다시 재서 비교해야 효과를 알 수 있고, 다음 달에 같은 자리가 또 커졌다면 그건 지울 게 아니라 설정을 바꿔야 하는 항목입니다.
테라클린은 이 문서에서 다룬 자리를 찾아 크기와 함께 목록으로 보여주고, 지워도 되는 이유와 안 되는 이유를 항목마다 적습니다. 지우기 전에 목록을 먼저 봅니다. 파일은 기기를 떠나지 않습니다.
Windows용 무료 다운로드 브라우저에서 체험 →크기부터 재세요. huggingface-cli scan-cache 를 실행하면 모델별 크기와 마지막 사용일이 나옵니다. 또는 %USERPROFILE%\.cache\huggingface 폴더 속성으로 보세요. 숫자를 보고 나서 지울지 말지 정하면 됩니다.
망가지지 않습니다. 다음에 그 모델을 쓰는 코드를 돌리면 다시 받습니다. 시간이 오래 걸립니다. 그 이상은 없습니다.
휴지통을 비웠는지 먼저 보세요. 그래도 그대로면 지운 파일을 아직 잡고 있는 프로그램이 있다는 뜻입니다. 재부팅 한 번이면 대개 반영됩니다. 재부팅 뒤에도 같다면 그 자리를 차지하는 건 Hugging Face 캐시가 아니라 다른 것입니다.
이 문서는 Hugging Face 모델 캐시 (.cache/huggingface)에 대한 한눈에 정리 문서입니다(NVMe SSD 기준). 경로와 명령어는 확인한 것만 적었고, 확인하지 못한 항목은 비워 두었습니다. 지우기 전에 반드시 크기를 먼저 재고, 되돌릴 수 없는 항목은 사본을 두세요.