# Hardware

Informe ao Hub qual hardware de computação você possui (GPUs, CPUs ou Apple Silicon) e ele ajudará você a encontrar modelos que rodam no seu ambiente. Essa informação também aparece no seu perfil público, permitindo que você compare seu ambiente com o da comunidade, e você pode torná-la privada a qualquer momento.

Gerencie-o a qualquer momento em [Configurações de hardware](https://huggingface.co/settings/hardware).

## Adicione seu hardware

Na sua página de [Configurações de hardware](https://huggingface.co/settings/hardware), adicione cada peça de hardware que você possui:

1. Escolha um **tipo**: GPU, CPU ou Apple Silicon.
2. Escolha o **provedor** e o **modelo** (por exemplo, NVIDIA RTX 4090).
3. Defina a **memory** (VRAM, RAM ou memória unificada) e o **number of units** que você possui.

Adicione quantos itens quiser. Se você possui vários, marque um como seu hardware **principal** para que ele apareça primeiro nas páginas de modelos.

> [!TIP]
> Seu hardware é público por padrão. Desative a opção **Visível publicamente** para mantê-lo privado.

## Veja quais modelos se adequam ao seu hardware

Em páginas de modelos que oferecem arquivos [GGUF](./gguf) ou MLX, um painel de **Compatibilidade de hardware** estima se cada quantização será executada no seu hardware salvo, para que você possa escolher um tamanho adequado antes de baixar. Combine-o com [Local Apps](./local-apps) para começar a usar em poucos cliques.

## Compartilhar e comparar

Enquanto seu hardware é público:

- Um selo **TFLOPS** aparece no seu perfil, resumindo sua potência de computação total estimada.
- Você pode navegar por [o que a comunidade está executando](https://huggingface.co/hardware) e ver como sua configuração se compara entre GPUs, CPUs e Apple Silicon.
- Cada fornecedor também possui sua própria página, como [NVIDIA](https://huggingface.co/hardware/nvidia), [AMD](https://huggingface.co/hardware/amd), [Apple](https://huggingface.co/hardware/apple), [Intel](https://huggingface.co/hardware/intel) e [Qualcomm](https://huggingface.co/hardware/qualcomm), agrupando o hardware dessa marca em um único local.

## Leia o hardware da API

Se o seu hardware for público, ele também está [disponível programaticamente](https://huggingface-openapi.hf.space/#tag/users/GET/api/users/{username}/overview):

- `GET https://huggingface.co/oauth/userinfo` inclui uma claim `hardwareItems` quando o seu aplicativo foi concedido o escopo `profile`, de modo que um aplicativo [Sign in with Hugging Face](./oauth) pode ler a configuração do usuário conectado sem uma chamada extra.
- `GET https://huggingface.co/api/users/{username}/overview` retorna um array `hardwareItems` para qualquer usuário cujo hardware seja público.

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

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

Cada item contém:

- `sku`: uma tríade `[type, provider, model]`.
- `mem`: a memória em GB (VRAM, RAM ou memória unificada).
- `num`: o número de unidades.
- `isPrimary`: presente apenas no item marcado como primário.

Se o usuário desativou o alternador **Visível publicamente**, `hardwareItems` é omitido de ambas as respostas. Consulte a [documentação da API do Hub](./api) para os esquemas completos de resposta.

## Próximas etapas

- [Use modelos de IA localmente](./local-apps) — execute modelos com seu aplicativo local favorito.
- [Agentes locais com llama.cpp](./agents-local) — crie um agente de programação no seu próprio hardware.