Matériel

Indiquez au Hub le matériel de calcul dont vous disposez (GPU, CPU ou Apple Silicon) et il vous aidera à trouver des modèles qui s’exécutent sur votre configuration. Cette information apparaît également sur votre profil public, ce qui vous permet de comparer votre configuration avec celle de la communauté, et vous pouvez la rendre privée à tout moment.

Gérez-le à tout moment depuis vos Paramètres matériel.

Ajoutez votre matériel

Sur votre page Paramètres du matériel, ajoutez chaque composant matériel dont vous disposez :

1. Choisissez un type : GPU, CPU ou Apple Silicon.
2. Choisissez le fournisseur et le modèle (par exemple, NVIDIA RTX 4090).
3. Définissez la mémoire (VRAM, RAM ou mémoire unifiée) et le nombre d’unités dont vous disposez.

Ajoutez autant d’éléments que vous le souhaitez. Si vous en possédez plusieurs, marquez-en un comme votre matériel principal afin qu’il apparaisse en premier sur les pages de modèles.

Votre matériel est public par défaut. Désactivez l’interrupteur Visible publiquement pour le garder privé.

Vérifiez quels modèles sont compatibles avec votre matériel

Sur les pages de modèles qui proposent des fichiers GGUF ou MLX, un panneau Compatibilité matériel estime si chaque quantification fonctionnera sur votre matériel enregistré, afin que vous puissiez choisir une taille adaptée avant le téléchargement. Associez-le à Applications locales pour vous mettre en route en quelques clics.

Partager et comparer

Tant que votre matériel est public :

• Un badge TFLOPS apparaît sur votre profil, résumant votre puissance de calcul totale estimée.
• Vous pouvez parcourir ce que la communauté exécute et voir comment votre configuration se compare sur GPU, CPU et Apple Silicon.
• Chaque fabricant dispose également de sa propre page, comme NVIDIA, AMD, Apple, Intel et Qualcomm, qui regroupe le matériel de cette marque en un seul endroit.

Lire le matériel depuis l'API

Si votre matériel est public, il est également disponible de manière programmatique :

• GET https://huggingface.co/oauth/userinfo inclut une revendication hardwareItems lorsque votre application a reçu l’étendue profile, ce qui permet à une application Sign in with Hugging Face de lire la configuration de l’utilisateur connecté sans appel supplémentaire.
• GET https://huggingface.co/api/users/{username}/overview renvoie un tableau hardwareItems pour tout utilisateur dont le matériel est public.

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

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

Chaque élément contient :

• sku : un triplet [type, provider, model].
• mem : la mémoire en Go (VRAM, RAM ou mémoire unifiée).
• num : le nombre d'unités.
• isPrimary : présent uniquement sur l'élément marqué comme principal.

Si l'utilisateur a désactivé l'interrupteur Publicly Visible, hardwareItems est omis des deux réponses. Consultez la documentation de l'API Hub pour les schémas de réponse complets.

Étapes suivantes

• Utiliser des modèles d’IA en local — exécutez des modèles avec votre application locale préférée.
• Agents locaux avec llama.cpp — créez un agent de codage sur votre propre matériel.