> ## 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 から Registry に事前トレーニング済みモデルをインポートします。

Hugging Face Hub から事前トレーニング済みモデルを Registry のコレクションにインポートします。Registry は各インポートをサンドボックス内で実行します。サンドボックスが選択されたモデルのリビジョンを取得し、W\&B がインポートされたファイルを[アーティファクト](/ja/products/wandb/artifacts)としてログします。

W\&B は選択されたチームと project にアーティファクトをログしたうえで、[アーティファクトのバージョンを指定のコレクションにリンクします](/ja/products/registry/link_version)。チームと project によって、W\&B 内でのアーティファクトの保存場所が決まります。一方、Registry とコレクションによって、Registry 内でのモデルの表示場所が決まります。

<Info>
  モデルのインポートはサンドボックスのコンピュートを消費し、組織のサンドボックスのクォータに加算されます。インポートに GPU 対応のサンドボックスは不要です。

  インポート用のサンドボックスは Registry が自動的に作成・停止するため、ユーザーが設定や管理を行う必要はありません。
</Info>

コミット、ブランチ、またはタグを指定すると、Hugging Face の特定のリビジョンをインポートできます。リビジョンを指定しない場合、Registry はリポジトリのデフォルトブランチをインポートします。同じモデルの別のリビジョンを同じコレクションにインポートすると、新しいモデルのバージョンが作成されます。

<h2 id="permissions">
  権限
</h2>

Hugging Face Hub からモデルをインポートするには、次の要件を満たす必要があります。

* インポート先の Registry に対する[作成および書き込みアクセス権を持つ Registry ロール](/ja/products/registry/configure_registry#details-about-registry-roles)。
* 組織内の [Full Models シート](/ja/products/wandb/platform/hosting/iam/access-management/manage-organization#seats-and-pricing)。
* W\&B がアーティファクトをログするチームにおける [Member または Admin ロール](/ja/products/wandb/platform/app/settings-page/teams#team-roles-and-permissions)。
* CoreWeave [Sandboxes](/products/sandboxes) へのアクセス権と、十分なサンドボックスのコンピュートクォータ。
* インポートするモデルファイルを格納できる[十分なアーティファクトストレージ](/ja/products/registry/registry_huggingface#import-limits-and-failures)。

<h2 id="import-limits-and-failures">
  インポートの制限と失敗
</h2>

モデルのインポートには、インポート用サンドボックスのディスクキャパシティに基づき、90 GB のサイズ制限があります。

インポートは、次のようにさまざまな段階で失敗する可能性があります。

* 組織のサンドボックスのクォータが不足している場合、Registry はインポート用サンドボックスを作成できず、モデルの転送が始まる前にインポートが失敗します。
* 組織のアーティファクトストレージが不足している場合、モデルの転送開始後にインポートが失敗することがあります。

開始したインポートはキャンセルできません。インポートが[完了したか失敗したかは、インポートのステータスで確認できます](/ja/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** で、保存先の 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** | Registry がモデルをインポート中です。 |
| **Completed** | Registry がモデルを正常にインポートしました。 |
| **Failed** | Registry がモデルをインポートできませんでした。 |

<h2 id="view-an-imported-model">
  インポートしたモデルを表示する
</h2>

インポートが完了すると、インポートしたモデルのバージョンがインポート先のコレクションに表示されます。Registry は `hf-<commit-hash>` 形式の[エイリアス](/ja/products/registry/aliases)を追加します。`<commit-hash>` は、ソースリポジトリの解決されたコミットハッシュです。

インポートしたモデルを表示するには、次の手順に従います。

1. **Registry** にアクセスします。
2. インポート先の Registry を選択します。
3. インポート先のコレクションを選択します。
4. インポートしたモデルのバージョンを選択します。
5. **Metadata** タブを選択します。

<h3 id="imported-model-metadata">
  インポートしたモデルのメタデータ
</h3>

[リンクされたアーティファクトのバージョンで利用できる標準メタデータ](/ja/products/registry/link_version#view-linked-artifacts-in-a-registry)に加えて、インポートしたモデルのバージョンには次のフィールドが含まれます。

| フィールド | 説明 |
| - | - |
| `artifact type` | インポートしたアーティファクトのタイプです。通常、この値は `model` です。 |
| `file_count` | アーティファクトにインポートされたファイルの数です。 |
| `import_id` | インポート操作の一意の ID です。インポートのトラブルシューティングを行う際に使用します。アーティファクトのバージョン、モデル、アーティファクトのダイジェストを識別するものではありません。 |
| `import_spec_hash` | ソースリポジトリ、リクエストされたリビジョン、インポートオプションから算出したフィンガープリントで、Registry がインポートリクエストの比較に使用します。ファイルのチェックサムではありません。インポートされたコンテンツは、アーティファクトのダイジェストによって識別されます。 |
| `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.6 MB (234.2 MiB) です。
* `source` は `huggingface` です。