GitHub Readme Stats

GitHub Readme Stats generates statistics cards for use in GitHub README files.

github.com/anuraghazra/github-readme-stats
GitHub Readme Stats homepage screenshot

About GitHub Readme Stats

GitHub Readme Stats is an open source repository that creates dynamically generated statistics cards for GitHub README files. The cards are added with a markdown snippet and display data based on a GitHub username.

You can add a GitHub stats card, a top languages card, repository pins, gist pins, and a WakaTime stats card. Options include hiding or showing individual stats, showing icons, selecting themes, and adjusting layouts for language cards. For private statistics, the documentation describes deploying your own instance with a personal access token via Vercel, another platform, or GitHub Actions.

It suits GitHub users and developers who maintain profile or project READMEs. The repository page states that the project is no longer maintained and points to a successor fork and an Actions-based alternative.

Key features

  • Dynamically generated GitHub stats cards for READMEs
  • Top languages card with multiple layout options
  • Repository and gist pins for README files
  • WakaTime stats card for coding activity
  • Themes and customization options for cards
  • Self-hosting via Vercel or GitHub Actions
Best for: GitHub users who want to show account statistics in README files.
Good for
  • Open source code available on GitHub
  • Embeds with simple markdown snippet
  • Offers stats, languages, pins, and WakaTime cards
  • Includes themes and display customization options
Watch out for
  • Repository is no longer maintained
  • Public instance can be unreliable due to rate limits
  • Default cards show public repositories only

GitHub Readme Stats at a glance

Type
Open-source project
Pricing
Not confirmed. Check the site
Open source
Yes · Source code
Language
English
Last checked
Oct 5, 2026 · Online when checked
Listed
Oct 5, 2026

GitHub Readme Stats alternatives

Tools and sites you could use instead, ranked by how closely they match.

All 24 alternatives

Popular in Developer Tools

Well-known listings from the same topic.

All 423

GitHub Readme Stats FAQ

Is GitHub Readme Stats still maintained?
No. The repository page states it is no longer maintained and points to GitHub Stats Extended as the successor.
How do I add the stats card to my README?
Copy the markdown snippet into your README and change the ?username= value to your GitHub username.
Does it show private repository statistics?
By default it shows statistics from public repositories only. To show private statistics you need to deploy your own instance with a GitHub API token.
Why is my stats card not loading reliably?
The public Vercel instance is best-effort and can be unreliable due to rate limits and traffic. The documentation recommends self-hosting or using GitHub Actions.
Is something wrong or out of date?

Tell us and an editor will check it.

Own this website?

Claim the listing and suggest updates yourself. An editor checks every claim first.

Claim this listing