anuraghazra/github-readme-stats

GitHub Readme Stats generates dynamic cards showing your GitHub activity that you can drop into a README file. Instead of static text, the card is an image served by a small web service: it queries GitHub for your account's data and renders an up-to-date summary every time someone views your README. You add it by copying a single Markdown line into your file and changing the username parameter to your own. The project provides several types of cards. The main "GitHub Stats" card shows things like total stars, commits, pull requests, issues, and a rank letter (S, A+, A, A-, B+, B, B-, C+, or C) computed as a weighted percentile across those statistics, inspired by the Japanese academic grading system. There is also a Top Languages card that summarizes the languages used across your repositories with layout options including compact, donut, vertical donut, and pie chart. "GitHub Extra Pins" let you pin specific repositories or Gists by URL, and a WakaTime Stats card surfaces coding-time data when connected to that service. Each card supports query-string parameters to hide or show stats, swap themes, and tune the format. A public hosted instance is available, but the README warns it is best-effort and subject to rate limits, so for reliable cards the recommended approach is to deploy your own instance, either on Vercel using a Personal Access Token, or via a GitHub Actions workflow that generates the cards in your profile repository. Someone would use this to make a profile README more visually informative, or to display project stats inside a project's README. The service is written in JavaScript and runs as a serverless function.