GitHub README stats: add a live stats card
A stats card is an image link in your README that a server draws from your public GitHub data each time the page loads. You paste one line once, and the numbers keep themselves up to date.
See your profile in a template
What it looks like
Add it to your README
Type your username to get the line to paste, then put it near the top of README.md in your profile repository.
<img src="https://www.gitskins.com/api/card-animated?username=YOUR_USERNAME&theme=github-dark" alt="YOUR_USERNAME's GitHub stats" />
It is plain HTML that GitHub allows in Markdown, so it works in any README, not only your profile.
Themes
Change theme= at the end of the link. Four themes are free: github-dark, neon, zen and satan. More themes come with GitSkins Pro.
Why your numbers don't change right away
GitHub doesn't load images straight from the card's server. It fetches them through its own image proxy and caches them, so a new star or commit can take a while to show on your profile. Reloading your own page won't skip that cache; the card catches up by itself.
Other stats cards
The best-known alternative is the open-source github-readme-stats project, which has static stats, top-language and pin cards and can be self-hosted. GitHub also shows your contribution graph on your profile by itself, under the README.
Want more than a card?
A stats card is one line. If you want the whole profile designed, with projects, stack and activity laid out for you, look at the GitHub profile README templates or try the generator with your username.
Build yours now
Questions
Is the GitHub stats card free?
Yes. The animated card and four themes (github-dark, neon, zen and satan) are free to use in any README.
Does it update automatically?
Yes. The card is drawn from your public GitHub data when it loads. GitHub caches images through its proxy, so changes can take a little while to appear.
Do I need an account or a token?
No. The card only reads public GitHub data, so you only need your username.