저장소 관리 — 만들고, 지우고, 브랜치와 태그

저장소 관리

Hugging Face Hub는 git 저장소의 모음이에요. 물론 git clone·git add·git push로도 다룰 수 있지만, 모델 저장소는 대용량 가중치 파일을 담는 경우가 많아서, 로컬 폴더를 거대하게 만드는 git 흐름보다는 HTTP 방식의 전용 메서드가 더 효율적일 때가 많아요.

저장소 목록과 생성

자신(또는 조직)의 저장소를 보려면 list_user_repos()를 써요. 저장소를 만들려면 create_repo()repo_id(username_or_org/repo_name)를 넘기면 돼요.

>>> from huggingface_hub import create_repo
>>> create_repo("lysandre/test-model")
'https://huggingface.co/lysandre/test-model'

기본은 모델 저장소지만 repo_type으로 dataset·space를 지정할 수 있고, visibility="private"로 공개 범위를 정할 수 있어요. CLI로는 hf repos create를 써요.

삭제와 복제

  • delete_repo(repo_id=..., repo_type=...) — 삭제는 되돌릴 수 없으니 신중해야 해요. missing_ok=True를 주면 저장소가 없어도 조용히 무시해요.
  • duplicate_repo() — 다른 사람의 저장소 전체를 git 히스토리까지 보존해 복제해요. 모델·데이터셋·Spaces 모두 가능하지만, Spaces는 하드웨어·환경 설정을 다시 해야 해요.

브랜치·태그·파일 복사

create_branch()·create_tag()로 git 레퍼런스를 만들 수 있고, copy_files()(또는 hf cp)로 허브에 이미 있는 파일을 다운로드 없이 다른 저장소로 서버측 복사할 수 있어요. Xet·LFS 추적 파일은 해시 기반으로 복사돼요.

더 알아보기