모델 임포트는 샌드박스 컴퓨팅을 사용하므로 조직의 샌드박스 할당량에 포함됩니다. 임포트에는 GPU 지원 샌드박스가 필요하지 않습니다.임포트용 샌드박스는 레지스트리가 자동으로 생성하고 중지하므로 직접 설정하거나 관리할 필요가 없습니다.
권한
Hugging Face Hub에서 모델을 임포트하려면 다음 요건을 충족해야 합니다.- 대상 레지스트리에 대한 생성 및 쓰기 액세스 권한이 있는 레지스트리 역할
- 조직의 Full Models 시트
- W&B가 아티팩트를 로깅하는 팀의 Member 또는 Admin 역할
- CoreWeave Sandboxes에 대한 액세스 권한 및 충분한 샌드박스 컴퓨팅 할당량
- 임포트할 모델 파일을 저장할 수 있는 충분한 아티팩트 저장소
임포트 제한 및 실패
모델 임포트는 임포트 샌드박스의 디스크 용량에 따라 크기가 90 GB로 제한됩니다. 임포트는 여러 단계에서 실패할 수 있습니다.- 조직의 샌드박스 할당량이 부족하면 레지스트리가 임포트 샌드박스를 생성할 수 없으므로, 모델 전송이 시작되기 전에 임포트가 실패합니다.
- 조직의 아티팩트 저장소가 부족하면 모델 전송이 시작된 후에 임포트가 실패할 수 있습니다.
모델 임포트하기
- Registry로 이동하세요.
- Import model을 선택하세요.
- Repository link 필드에 Hugging Face Hub 모델 URL 또는 저장소 ID를 입력하세요. 예를 들어
bert-base-uncased를 임포트하려면 https://huggingface.co/google-bert/bert-base-uncased 또는google-bert/bert-base-uncased를 입력하세요. - 선택 사항: Version에서 임포트할 커밋, 브랜치 또는 태그를 지정하세요.
- Next를 선택하세요.
- 임포트한 모델을 로깅할 팀과 프로젝트의 이름을 입력하세요.
- Registry에서 대상 레지스트리를 선택하세요.
- Collection에서 대상 컬렉션을 선택하세요.
- Next를 선택하세요.
- 선택 사항: 임포트한 모델을 체계적으로 관리하고 쉽게 찾을 수 있도록 별칭을 추가하세요.
- 임포트 설정을 검토한 후 Import를 선택하세요.
Hugging Face Hub에서 임포트한 모델에는
model 컬렉션 유형이 부여됩니다.임포트 상태 확인
임포트 상태를 확인하려면 다음 단계를 따르세요.- Registry로 이동하세요.
- 작업 메뉴()를 선택한 다음 View import activity를 선택하세요.
임포트한 모델 보기
임포트가 완료되면 임포트한 모델 버전이 대상 컬렉션에 표시됩니다. 레지스트리는hf-<commit-hash> 형식의 별칭을 추가합니다. 여기서 <commit-hash>는 소스 저장소에서 확인된 커밋 해시입니다.
임포트한 모델을 보려면 다음 단계를 따르세요.
- Registry로 이동하세요.
- 대상 레지스트리를 선택하세요.
- 대상 컬렉션을 선택하세요.
- 임포트한 모델 버전을 선택하세요.
- Metadata 탭을 선택하세요.
임포트된 모델 메타데이터
연결된 아티팩트 버전에서 사용 가능한 표준 메타데이터 외에도 임포트된 모델 버전에는 다음 필드가 포함됩니다.
예를 들어 Hugging Face Hub의 YOLOS small 모델을 임포트한다고 가정해 보겠습니다. 임포트가 완료되면 메타데이터가 다음과 같이 표시될 수 있습니다.
repo_id는hustvl/yolos-small입니다.resolved_revision은3d8f7130d3ce4907로, 임포트 당시main이 가리키던 커밋입니다.size_bytes는 245,569,443바이트로, 약 245.6MB 또는 234.2MiB입니다.source는huggingface입니다.