# ハードウェア

Hubに所有している計算ハードウェア（GPU、CPU、またはApple Silicon）を伝えると、お使いの環境で実行できるモデルの検索を支援します。また、この情報はパブリックプロファイルにも表示されるため、コミュニティとの環境比較が可能であり、いつでも非公開に設定できます。

いつでも[ハードウェア設定](https://huggingface.co/settings/hardware)から管理できます。

## ハードウェアを追加

[ハードウェア設定](https://huggingface.co/settings/hardware)ページで、所有しているハードウェアをそれぞれ追加します:

1. **タイプ**を選択してください: GPU、CPU、または Apple Silicon。
2. **プロバイダー**と**モデル**（例: NVIDIA RTX 4090）を選択します。
3. **メモリ**（VRAM、RAM、または統一メモリ）と、ご使用の**ユニット数**を設定してください。

お好きなだけアイテムを追加できます。複数所有している場合は、**primary**（プライマリ）ハードウェアとして1つを指定してください。そうすることで、モデルページで最初に表示されます。

> [!TIP]
> ハードウェアはデフォルトで公開されています。非公開にするには、**Publicly Visible**のトグルをオフにしてください。

## お使いのハードウェアに適合するモデルを確認

[GGUF](./gguf)またはMLXファイルを提供するモデルページでは、**Hardware compatibility**パネルが、保存済みのハードウェアで各量子化が実行可能かどうかを推定します。これにより、ダウンロード前に適切なサイズを選択できます。[Local Apps](./local-apps)と組み合わせることで、数回のクリックでセットアップを完了できます。

## 共有と比較

ハードウェアが公開されている間:

- **TFLOPS**バッジがプロファイルに表示され、推定される総計算能力を要約します。
- [コミュニティが実行している内容](https://huggingface.co/hardware)を閲覧し、GPU、CPU、Apple Silicon 間で自分のセットアップがどのように比較されるかを確認できます。
- 各ベンダーには、[NVIDIA](https://huggingface.co/hardware/nvidia)、[AMD](https://huggingface.co/hardware/amd)、[Apple](https://huggingface.co/hardware/apple)、[Intel](https://huggingface.co/hardware/intel)、[Qualcomm](https://huggingface.co/hardware/qualcomm)などの個別ページがあり、そのブランドのハードウェアを1か所にまとめて紹介しています。

## APIからハードウェアを読み取る

ハードウェアがパブリックな場合、[プログラムからも利用可能](https://huggingface-openapi.hf.space/#tag/users/GET/api/users/{username}/overview)です:

- `GET https://huggingface.co/oauth/userinfo` は、アプリに `profile` スコープが許可されている場合、`hardwareItems` クレームを含みます。そのため、[Hugging Face でサインイン](./oauth) アプリは、追加の呼び出しなしでサインインしたユーザーのセットアップを読み取ることができます。
- `GET https://huggingface.co/api/users/{username}/overview` は、ハードウェアが公開されているユーザーに対して `hardwareItems` 配列を返します。

```bash
curl https://huggingface.co/api/users/{username}/overview
```

```json
{
  "hardwareItems": [
    { "sku": ["GPU", "NVIDIA", "RTX 4090"], "mem": 24, "num": 2, "isPrimary": true }
  ]
}
```

各項目には、以下が含まれます:

- `sku`: `[type, provider, model]` の3要素組。
- `mem`: メモリ量（GB単位、VRAM、RAM、または統合メモリ）。
- `num`: ユニットの数。
- `isPrimary`: プライマリとしてマークされたアイテムにのみ存在します。

ユーザーが**Publicly Visible**のトグルをオフにしている場合、`hardwareItems`は両方のレスポンスから省略されます。完全なレスポンスのスキーマについては、[Hub API ドキュメント](./api)を参照してください。

## 次のステップ

- [AIモデルをローカルで使用する](./local-apps) — お好みのローカルアプリでモデルを実行します。
- [llama.cppによるローカルエージェント](./agents-local) — 独自のハードウェアでコーディングエージェントを構築します。