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.

Adicione seu hardware

Na sua página de Configurações de 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.

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 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 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 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, AMD, Apple, Intel e Qualcomm, agrupando o hardware daquela marca em um único local.

Leia o hardware da API

Se o seu hardware for público, ele também está disponível programaticamente:

• 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 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.

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

{
  "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 para os esquemas completos de resposta.

Próximas etapas

• Use modelos de IA localmente — execute modelos com seu aplicativo local favorito.
• Agentes locais com llama.cpp — crie um agente de programação no seu próprio hardware.