README

GitHub Readme Stats
  Get dynamically generated GitHub stats on your READMEs!



  
    
  
  
    
  
  
    
  
  
    
  
  
    
  
  
    
  
  
  
  
    
  


Love the project? Please consider donating to support the original creator!

 [!CAUTION]
 This repository is no longer maintained. Please use the successor project GitHub Stats Extended instead! GitHub Stats Extended is an actively maintained fork of this repository with additional features and improved stability. Alternatively you can also use GitHub Readme Stats Action.


Click here to view the outdated documentation. Kept for reference only.




  View Demo
  ·
  Report Bug
  ·
  Request Feature
  ·
  FAQ
  ·
  Ask Question



Table of contents (Click to show)

- GitHub Stats Card
    - Hiding individual stats
    - Showing additional individual stats
    - Showing icons
    - Showing commits count for specified year
    - Themes
    - Customization
- GitHub Extra Pins
    - Usage
    - Options
    - Demo
- GitHub Gist Pins
    - Usage
    - Options
    - Demo
- Top Languages Card
    - Usage
    - Options
    - Language stats algorithm
    - Exclude individual repositories
    - Hide individual languages
    - Show more languages
    - Compact Language Card Layout
    - Donut Chart Language Card Layout
    - Donut Vertical Chart Language Card Layout
    - Pie Chart Language Card Layout
    - Hide Progress Bars
    - Change format of language's stats
    - Demo
- WakaTime Stats Card
    - Options
    - Demo
- All Demos
  - Quick Tip (Align The Cards)
    - Stats and top languages cards
    - Pinning repositories
- Deploy on your own
  - GitHub Actions (Recommended)
  - Self-hosted (Vercel/Other) (Recommended)
    - First step: get your Personal Access Token (PAT)
    - On Vercel
    - :film\_projector: Check Out Step By Step Video Tutorial By @codeSTACKr
    - On other platforms
    - Available environment variables
  - Keep your fork up to date
- :sparkling\_heart: Support the project


 Important Notices 


⚠️Warning

The public Vercel instance at https://github-readme-stats.vercel.app/api is best-effort and can be unreliable due to rate limits and traffic spikes (see 1471). We use caching to improve stability (see common options), but for reliable cards we recommend self-hosting (Vercel or other) or using the GitHub Actions workflow to generate cards in your profile repository.



⚠️Warning

We're a small team, and to prioritize, we rely on upvotes :+1:. We use the Top Issues dashboard for tracking community demand (see 1935). Do not hesitate to upvote the issues and pull requests you are interested in. We will work on the most upvoted first.


 GitHub Stats Card

Copy and paste this into your markdown, and that's it. Simple!

Change the ?username= value to your GitHub username.

md




⚠️Warning

By default, the stats card only shows statistics like stars, commits, and pull requests from public repositories. To show private statistics on the stats card, you should deploy your 

Top issues

Discussions