Skip to content

ChenLiu-1996/GitStarPercentile

Repository files navigation

GitStarPercentile

Twitter LinkedIn
Latest PyPI version PyPI download 3 month PyPI download month License: MIT


🤔 Have you ever wondered how popular your GitHub repository really is?

😠 Frustrated that GitHub doesn’t show star percentiles anywhere?

Maybe you’ve thought:

"I have 200 stars — but is that a lot?"

"Where does my repo rank compared to the other repos?"


GitStarPercentile tells you instantly:

Enter your star count and instantly see your percentile, calculated from GitHub-wide data.

🚀 Features

  • 📊 Instant percentile lookup — get your repo’s rank in milliseconds.
  • 🖥 Simple CLI — just type git-star-percentile and enter your star count.
  • 💾 Big data — computation is based on over 1 million public repos, stratified by creation date.

📦 Installation

From the command line:

pip install git-star-percentile --upgrade

⚡ Usage

From the command line:

git-star-percentile

You’ll be prompted to enter the number of stars for your repository:

Enter the number of GitHub stars: 200
Your repo is approximately among the top xx.xxxx%.

📄 Data Source

If we count all public repositories:

GitHub Stars Distribution

If we only count public repositories with at least 1 star:

GitHub Stars Distribution
  • Star statistics are pulled from all public GitHub repositories.

  • Data is stored in stats/github_repo_stars.csv.

  • Want fresher stats? Run the stats counter yourself and submit a pull request.

    python count_all_repo_stars.py --github-token $YOUR_GITHUB_TOKEN

    The line above would run over all public repositories. For a more manageable run, sample 1 million instead.

    python count_all_repo_stars.py --github-token $YOUR_GITHUB_TOKEN --sample-size 1000000

    Note I will not consider merging results with --sample-size below 1 million.

About

Ever wondered how popular your GitHub repo is compared to others?

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages