Model cards in practice
Writing and reading **model cards** that document intended use, data, metrics, limits, and ethical considerations. On Hugging Face Hub, the card’s metadata also carries the **license identifier** others rely on when scanning repositories...
What it is
Writing and reading model cards that document intended use, data, metrics, limits, and ethical considerations. On Hugging Face Hub, the card’s metadata also carries the license identifier others rely on when scanning repositories.
<!-- IMAGE: card sections: use, data, metrics, limits, license -->
Visual Spec & Architecture Diagram
Model card mock sections: intended use, limitations, metrics, ethical considerations, training data summary. Fake 'ToyLM-1B'.
Why it matters
Cards are how teams communicate honestly—and how buyers compare options. A Hub license tag without a filled card still leaves eval and misuse gaps. Mistral points readers to model cards for explicit licensing terms per model.
How it works (plain)
- Fill intended use / out-of-scope use.
- Summarize data and known gaps.
- Report metrics with dataset names and dates.
- State limits and risks.
- Link license + AUP; update on every release.
Refuse vague “state of the art” without tasks.
Everyday example
A nutrition label: calories without serving size misleads. Metrics without test-set identity mislead the same way.
Try it
Draft a half-page card for a tiny classifier you trained in Course 21. Include license field even if other + LICENSE file.
Myths
- ⚠️ Myth: Marketing one-pagers equal model cards.
- ✓ Reality: Cards need limits and eval details.
- ⚠️ Myth: License metadata replaces the card.
- ✓ Reality: License ≠ performance or safety story.
Sources
- Hugging Face Hub licenses / cards: https://huggingface.co/docs/hub/main/en/repositories-licenses ↗
- Mistral licensing → model cards: https://help.mistral.ai/en/articles/347393-under-which-license-are-mistral-s-open-models-available ↗
- NIST AI RMF: https://www.nist.gov/itl/ai-risk-management-framework ↗
- Course 02 datasheets
