Guide
Lire une fiche de modèle Hugging Face (model card)
Licence, modèle de base, données, limites, résultats d'évaluation : comment lire une fiche de modèle sur Hugging Face avant de choisir un modèle ouvert.
Mis à jour le
La fiche d'un modèle (en anglais model card) est la page qui accompagne chaque modèle sur Hugging Face : c'est le fichier README.md du dépôt. Selon la documentation de Hugging Face, elle doit décrire le modèle, ses usages prévus et ses limites (biais et questions éthiques compris), ses paramètres d'entraînement, les jeux de données utilisés et ses résultats d'évaluation. Elle a deux parties : un en-tête de métadonnées, lu par la machine, et un texte, écrit pour vous. Avant de retenir un modèle, lisez les deux.
L'en-tête : les métadonnées
En haut du fichier, entre deux lignes ---, un bloc au format YAML (un format texte de configuration) contient les métadonnées. Celles qui comptent pour un choix :
| Champ | Ce qu'il indique | Ce qu'il faut vérifier |
|---|---|---|
license |
L'identifiant de la licence | Si la valeur est other, lisez license_name et license_link : c'est une licence propre à l'éditeur |
base_model |
Le modèle d'origine, pour un modèle ajusté, un adaptateur, une version compressée ou une fusion | Les conditions du modèle d'origine peuvent s'ajouter à celles du modèle dérivé |
datasets |
Les jeux de données d'entraînement déclarés | Ils s'affichent sous « Datasets used to train » avec un lien quand ils sont sur le Hub |
language |
Les langues prises en charge | Le français est-il cité ? |
library_name |
La bibliothèque logicielle prévue | Compatibilité avec vos outils |
pipeline_tag |
La tâche visée (génération de texte, image vers texte…) | Le modèle fait-il ce que vous attendez ? |
new_version |
Un lien vers une version plus récente | Ne partez pas d'une version déjà remplacée |
gated |
Accès contrôlé | Demande d'accès à prévoir pour chaque développeur |
Ces champs sont déclarés par l'auteur : le Hub les affiche, il ne les certifie pas. Un champ absent ne veut pas dire « rien à signaler ».
Le texte : les sections à ne pas sauter
- La licence, dans le texte. Elle peut préciser ce que l'étiquette ne dit pas. Exemple : l'étiquette de Mistral Large 4 indique
other; le texte nomme la Mistral Ecosystem Open-Weight License et précise qu'une offre de modèle en service demande une licence commerciale séparée. - L'héritage. La fiche de Helium 1 (Kyutai) affiche CC-BY-SA 4.0, mais ajoute dans le texte que le modèle, distillé de Gemma 2, est aussi soumis aux conditions d'utilisation de Gemma. Ce genre de phrase ne figure pas dans les métadonnées.
- Les caractéristiques techniques. Taille, nombre de paramètres actifs, longueur de contexte. Exemple : la fiche de Qwen3.8-27B annonce une longueur de contexte de 262 144 jetons, extensible jusqu'à 1 000 000.
- Les usages prévus et hors champ. Ce que l'éditeur déconseille vous sert pour paramétrer l'outil et former vos équipes.
- Les limites et biais. Lisez-les avec votre usage en tête.
- Les évaluations. Les résultats peuvent être structurés dans les métadonnées et affichés dans un encart. Notez sur quels tests et dans quelles conditions ils ont été obtenus.
Les incohérences, ça arrive
Une fiche est écrite à la main et peut contenir des écarts. Deux exemples relevés le 15/11/2026 :
- Qwen3.8-27B : « 27B » dans la description, « 28B params » dans l'encart des fichiers.
- DeepSeek V4.1 Flash : 552 milliards de paramètres « backbone » dans l'introduction, un total plus élevé dans les métadonnées des fichiers.
Ces écarts ont souvent une explication (ce qui est compté ou non), mais pour dimensionner un serveur, retenez la valeur la plus haute.
La grille de lecture en cinq minutes
| Question | Où regarder |
|---|---|
| Qui publie ? | Le nom du compte dans l'adresse (éditeur/modèle) |
| Sous quelle licence ? | Étiquette, puis texte, puis lien de licence |
| Dérivé de quoi ? | base_model et texte |
| Entraîné sur quoi ? | datasets et section données |
| Pour quoi faire, et pas pour quoi ? | Usages prévus, limites |
| Quels fichiers ? | Onglet des fichiers : préférez les .safetensors (voir sécurité d'un modèle téléchargé) |
| Est-ce la dernière version ? | new_version, date de mise à jour |
Pour savoir comment Hugging Face fonctionne dans son ensemble, voir Hugging Face expliqué.
Questions fréquentes
Où se trouve la fiche d'un modèle sur Hugging Face ?
C'est le fichier README.md du dépôt du modèle, affiché sur la page du modèle. Son en-tête contient les métadonnées (licence, langues, jeux de données, modèle de base).
Que faire si deux chiffres d'une fiche ne concordent pas ?
Notez l'écart et retenez la donnée la plus prudente pour vos calculs. Par exemple, la fiche de Qwen3.8-27B annonce 27 milliards de paramètres dans le texte alors que l'encart des fichiers indique 28 milliards.
Sources
Pages consultées pour écrire cet article :