← AI TIPS · 따라 하는 AI 활용법

AI 모델이 디스크를 채웠다면? 지우기 전에 정리 후보부터 확인하기

Hugging Face CLI로 로컬 캐시를 살펴보고, 실제 파일을 지우지 않는 미리보기로 정리 대상을 확인합니다.

Hugging Face 모델을 여러 번 받아 쓰다 보면 어떤 파일이 로컬 캐시에 남았는지 기억하기 어렵습니다. 이번 과제는 캐시 목록을 살펴보고 정리 후보를 삭제 없이 미리 보는 것입니다.

hf cache ls는 캐시에 있는 저장소를 보여 줍니다. hf cache prune --dry-run은 참조되지 않는 리비전, 중단된 다운로드 파일, 더 이상 참조되지 않는 공유 파일을 정리 대상으로 미리 보여 줍니다. 현재 브랜치나 태그가 참조하는 리비전까지 모두 지우거나, 다른 도구의 캐시를 검사하는 명령은 아닙니다. 미리보기만 실행하면 디스크 공간은 확보되지 않습니다.

2026년 10월 28일 macOS의 Python 3.12.7·Hugging Face CLI 2.3.0에서 시험했습니다. 비어 있는 임시 캐시와 공개 설정 파일 1개가 든 임시 캐시 모두에서 조회와 미리보기가 동작했습니다. 후자에서는 정리 후보가 없었습니다. 실제 삭제와 정리 후보가 있는 캐시에서의 회수량은 시험하지 않았습니다. 원문의 문장·이미지·코드는 복제하지 않았습니다.

시작하기 전에

Hugging Face 모델 캐시를 조회하고, 파일을 삭제하기 전에 정리 대상을 미리 확인한다.

  • macOS 또는 Linux 터미널과 Python. 아래 설치 명령에는 네트워크 연결이 필요합니다.
  • Hugging Face 계정이나 유료 요금제는 로컬 캐시 조회에 필요하지 않습니다.
  • 기존 캐시가 없다면 항목이 표시되지 않습니다. 이 방법은 Hugging Face CLI가 관리하는 캐시를 대상으로 합니다.

하나씩 따라 해 보세요

  1. CLI가 없다면 `python3 -m venv .venv`로 가상 환경을 만들고 `source .venv/bin/activate`, `python -m pip install -U huggingface_hub` 순서로 설치합니다.
  2. `hf --version`으로 CLI가 실행되는지 확인합니다. 이번 실험에서 사용한 버전은 2.3.0입니다.
  3. `hf cache ls`로 로컬 캐시에 있는 저장소와 크기를 확인합니다.
  4. `hf cache prune --dry-run`으로 정리 대상만 미리 확인합니다. `--dry-run`을 빼지 마세요.
  5. 표시된 대상과 예상 회수량을 읽고 필요한 리비전이 포함되는지 확인합니다. 이번 과제에서는 실제 삭제를 실행하지 않습니다.

입력 예시

hf --version
hf cache ls
hf cache prune --dry-run

결과 예시 · 가상 출력

[설명용 출력 예시]
캐시가 비어 있으면: No results found.
참조된 리비전만 있으면: Nothing to prune.
정리 후보가 있다면: 대상과 예상 회수량을 확인하고 실제 삭제 여부는 별도로 결정합니다.

원하는 결과가 나오지 않았다면

  • `hf` 명령을 찾지 못하면 가상 환경 활성화 여부를 확인하고 공식 설치 안내에 따라 다시 설치합니다.
  • `No results found.`가 나오면 캐시가 비어 있거나 다른 위치를 사용 중인지 확인합니다. 별도 경로를 썼다면 두 명령에 `--cache-dir 경로`를 붙입니다.
  • `Nothing to prune.`는 현재 정리 후보가 없다는 뜻입니다. 캐시에 파일이 있어도 이런 결과가 나올 수 있습니다.
  • 설치한 버전에서 옵션이 보이지 않으면 `hf cache prune --help`를 확인하고 `huggingface_hub`를 갱신합니다.

테스트 조건 · 확인 기록

공개 저장소의 config.json 1개(570바이트)를 임시 캐시에 받은 뒤 `hf cache ls`와 `hf cache prune --dry-run`을 실행

Hugging Face CLI / huggingface_hub 2.3.0

macOS, Python 3.12.7, 격리된 임시 캐시 · 2026.10.28 KST

`hf cache ls`에 model/google-bert/bert-base-uncased 1개 리비전이 표시됐고, 미리보기는 `Nothing to prune.`를 반환했다. 파일 삭제는 없었다.

정리 후보가 실제로 있는 캐시와 실제 삭제·공간 회수는 시험하지 않았다.

출처와 확인 기준

Hugging Face CLI 사용 가이드 ↗

Hugging Face · 원문 게시일 미확인

라이선스: Apache-2.0 (huggingface_hub 저장소)

기능 사실만 확인하고 AIPATH에서 독자적으로 설명함

Hugging Face 캐시 관리 가이드 ↗

Hugging Face · 원문 게시일 미확인

라이선스: Apache-2.0 (huggingface_hub 저장소)

원문 표현·도표·예제 출력 재사용 없음

Hugging Face Hub Python Library 설치 가이드 ↗

Hugging Face · 원문 게시일 미확인

라이선스: Apache-2.0 (huggingface_hub 저장소)

설치 명령을 직접 시험한 결과와 함께 안내함

정정·삭제 요청: [email protected] ↗
← AI TIPS 목록으로