What a Model Card Contains
A model card is a structured README.md. It documents: model architecture (transformer variant, parameter count), training data (what it was trained on, cutoff date), intended use, limitations and biases, evaluation results (benchmark scores), and license.
The YAML Frontmatter
Model cards start with YAML metadata: language:, license:, tags:, pipeline_tag:, base_model:. This metadata powers search and filtering on the Hub. pipeline_tag: text-generation tells the Hub this model generates text. base_model: meta-llama/Llama-3.1-8B tracks lineage.
Reading Benchmark Results
Treat benchmark tables as directional signal, not final truth. Compare models evaluated under similar settings, and then validate on your own task with a representative prompt and dataset slice.
Red flags in model cards: Missing training data description, no benchmark numbers, vague 'research purposes only' language without explanation, or no mention of RLHF/alignment. A well-maintained model will have thorough, honest documentation.