> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hugging Face Hub에서 모델 임포트하기

> 샌드박스 컴퓨팅을 사용하여 Hugging Face Hub의 사전 트레이닝된 모델을 레지스트리로 임포트합니다.

Hugging Face Hub의 사전 트레이닝된 모델을 레지스트리 컬렉션으로 임포트하세요. 레지스트리는 각 임포트 작업을 샌드박스에서 실행합니다. 샌드박스가 선택한 모델 리비전을 가져오면 W\&B가 임포트된 파일을 [아티팩트](/ko/products/wandb/artifacts)로 로깅합니다.

W\&B는 선택한 팀과 프로젝트에 아티팩트를 로깅한 다음 [아티팩트 버전을 지정한 컬렉션에 연결](/ko/products/registry/link_version)합니다. 팀과 프로젝트는 W\&B 내에서 아티팩트가 저장되는 위치를 정하고, 레지스트리와 컬렉션은 레지스트리에서 모델이 표시되는 위치를 정합니다.

<Info>
  모델 임포트는 샌드박스 컴퓨팅을 사용하므로 조직의 샌드박스 할당량에 포함됩니다. 임포트에는 GPU 지원 샌드박스가 필요하지 않습니다.

  임포트용 샌드박스는 레지스트리가 자동으로 생성하고 중지하므로 직접 설정하거나 관리할 필요가 없습니다.
</Info>

커밋, 브랜치 또는 태그를 지정하여 특정 Hugging Face 리비전을 임포트할 수 있습니다. 리비전을 지정하지 않으면 레지스트리는 저장소의 기본 브랜치를 임포트합니다. 같은 모델의 다른 리비전을 같은 컬렉션으로 임포트하면 새 모델 버전이 생성됩니다.

<h2 id="permissions">
  권한
</h2>

Hugging Face Hub에서 모델을 임포트하려면 다음 요건을 충족해야 합니다.

* 대상 레지스트리에 대한 [생성 및 쓰기 액세스 권한이 있는 레지스트리 역할](/ko/products/registry/configure_registry#details-about-registry-roles)
* 조직의 [Full Models 시트](/ko/products/wandb/platform/hosting/iam/access-management/manage-organization#seats-and-pricing)
* W\&B가 아티팩트를 로깅하는 [팀의 Member 또는 Admin 역할](/ko/products/wandb/platform/app/settings-page/teams#team-roles-and-permissions)
* CoreWeave [Sandboxes](/products/sandboxes)에 대한 액세스 권한 및 충분한 샌드박스 컴퓨팅 할당량
* 임포트할 모델 파일을 저장할 수 있는 [충분한 아티팩트 저장소](/ko/products/registry/registry_huggingface#import-limits-and-failures)

<h2 id="import-limits-and-failures">
  임포트 제한 및 실패
</h2>

모델 임포트는 임포트 샌드박스의 디스크 용량에 따라 크기가 90 GB로 제한됩니다.

임포트는 여러 단계에서 실패할 수 있습니다.

* 조직의 샌드박스 할당량이 부족하면 레지스트리가 임포트 샌드박스를 생성할 수 없으므로, 모델 전송이 시작되기 전에 임포트가 실패합니다.
* 조직의 아티팩트 저장소가 부족하면 모델 전송이 시작된 후에 임포트가 실패할 수 있습니다.

임포트는 시작된 후에는 취소할 수 없습니다. 임포트가 [완료되었는지 실패했는지 확인하려면 임포트 상태를 확인하세요](/ko/products/registry/registry_huggingface#check-import-status).

<h2 id="import-a-model">
  모델 임포트하기
</h2>

1. **Registry**로 이동하세요.
2. **Import model**을 선택하세요.
3. **Repository link** 필드에 Hugging Face Hub 모델 URL 또는 저장소 ID를 입력하세요. 예를 들어 `bert-base-uncased`를 임포트하려면 [https://huggingface.co/google-bert/bert-base-uncased](https://huggingface.co/google-bert/bert-base-uncased) 또는 `google-bert/bert-base-uncased`를 입력하세요.
4. 선택 사항: **Version**에서 임포트할 커밋, 브랜치 또는 태그를 지정하세요.
5. **Next**를 선택하세요.
6. 임포트한 모델을 로깅할 팀과 프로젝트의 이름을 입력하세요.
7. **Registry**에서 대상 레지스트리를 선택하세요.
8. **Collection**에서 대상 컬렉션을 선택하세요.
9. **Next**를 선택하세요.
10. 선택 사항: 임포트한 모델을 체계적으로 관리하고 쉽게 찾을 수 있도록 별칭을 추가하세요.
11. 임포트 설정을 검토한 후 **Import**를 선택하세요.

<Note>
  Hugging Face Hub에서 임포트한 모델에는 `model` 컬렉션 유형이 부여됩니다.
</Note>

<h2 id="check-import-status">
  임포트 상태 확인
</h2>

임포트 상태를 확인하려면 다음 단계를 따르세요.

1. **Registry**로 이동하세요.
2. 작업 메뉴(<Icon icon="ellipsis" iconType="solid" />)를 선택한 다음 **View import activity**를 선택하세요.

임포트 활동에는 다음 상태 중 하나가 표시됩니다.

| 상태 | 설명 |
| - | - |
| **Importing** | 레지스트리에서 모델을 임포트하는 중입니다. |
| **Completed** | 레지스트리에서 모델을 성공적으로 임포트했습니다. |
| **Failed** | 레지스트리에서 모델을 임포트하지 못했습니다. |

<h2 id="view-an-imported-model">
  임포트한 모델 보기
</h2>

임포트가 완료되면 임포트한 모델 버전이 대상 컬렉션에 표시됩니다. 레지스트리는 `hf-<commit-hash>` 형식의 [별칭](/ko/products/registry/aliases)을 추가합니다. 여기서 `<commit-hash>`는 소스 저장소에서 확인된 커밋 해시입니다.

임포트한 모델을 보려면 다음 단계를 따르세요.

1. **Registry**로 이동하세요.
2. 대상 레지스트리를 선택하세요.
3. 대상 컬렉션을 선택하세요.
4. 임포트한 모델 버전을 선택하세요.
5. **Metadata** 탭을 선택하세요.

<h3 id="imported-model-metadata">
  임포트된 모델 메타데이터
</h3>

[연결된 아티팩트 버전에서 사용 가능한 표준 메타데이터](/ko/products/registry/link_version#view-linked-artifacts-in-a-registry) 외에도 임포트된 모델 버전에는 다음 필드가 포함됩니다.

| 필드 | 설명 |
| - | - |
| `artifact type` | 임포트된 아티팩트의 유형입니다. 일반적으로 `model`입니다. |
| `file_count` | 아티팩트로 임포트된 파일 수입니다. |
| `import_id` | 임포트 오퍼레이션의 고유 식별자입니다. 임포트 문제를 해결할 때 이 값을 사용하세요. 이 값으로는 아티팩트 버전, 모델, 아티팩트 digest를 식별할 수 없습니다. |
| `import_spec_hash` | 소스 저장소, 요청된 리비전, 임포트 옵션으로 생성한 지문으로, 레지스트리가 임포트 요청을 비교하는 데 사용합니다. 파일 체크섬이 아니며, 임포트된 콘텐츠는 아티팩트 digest로 식별합니다. |
| `repo_id` | Hugging Face Hub에 있는 모델 저장소의 식별자입니다. |
| `repo_type` | 임포트된 Hugging Face Hub 저장소의 유형입니다. 일반적으로 `model`입니다. |
| `requested_revision` | 임포트 시 요청한 브랜치, 태그 또는 커밋 해시입니다. |
| `resolved_revision` | 요청한 리비전이 가리키는 Hugging Face 커밋 해시입니다. |
| `size_bytes` | 임포트된 파일의 총 크기(바이트 단위)입니다. |
| `source` | 임포트된 모델의 소스입니다. 값은 `huggingface`입니다. |

예를 들어 [Hugging Face Hub의 YOLOS small 모델](https://huggingface.co/hustvl/yolos-small)을 임포트한다고 가정해 보겠습니다. 임포트가 완료되면 메타데이터가 다음과 같이 표시될 수 있습니다.

<Frame>
  <img src="https://mintcdn.com/coreweave-dbfa0e8d/3Dv_sw2eg8feUJlx/products/registry/_media/hugging_face_yolo_small.png?fit=max&auto=format&n=3Dv_sw2eg8feUJlx&q=85&s=4bbc607384aae4a579ef52d3f3e0d161" alt="임포트된 YOLOS small 모델의 메타데이터" width="2444" height="1842" data-path="products/registry/_media/hugging_face_yolo_small.png" />
</Frame>

이 예제에서는 다음과 같습니다.

* `repo_id`는 `hustvl/yolos-small`입니다.
* `resolved_revision`은 `3d8f7130d3ce4907`로, 임포트 당시 `main`이 가리키던 커밋입니다.
* `size_bytes`는 245,569,443바이트로, 약 245.6MB 또는 234.2MiB입니다.
* `source`는 `huggingface`입니다.