https://github.com/chenliu-1996/gitstarpercentile

Ever wondered how popular your GitHub repo is compared to others?
https://github.com/chenliu-1996/gitstarpercentile

eb1 eb1a eb1b github github-star github-star-count github-star-percentile github-stars niw

Last synced: 7 days ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/chenliu-1996/gitstarpercentile
• Owner: ChenLiu-1996
• License: mit
• Created: 2025-08-12T22:38:08.000Z (5 months ago)
• Default Branch: main
• Last Pushed: 2025-08-15T03:26:26.000Z (5 months ago)
• Last Synced: 2025-12-10T01:47:07.282Z (about 2 months ago)
• Topics: eb1, eb1a, eb1b, github, github-star, github-star-count, github-star-percentile, github-stars, niw
• Language: Python
• Homepage:
• Size: 120 MB
• Stars: 15
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: Readme.md
  • License: LICENSE

Awesome Lists containing this project

README

          


⭐ GitStarPercentile





[![Twitter](https://img.shields.io/twitter/follow/ChenLiu-1996.svg?style=social)](https://twitter.com/ChenLiu_1996)

[![LinkedIn](https://img.shields.io/badge/LinkedIn-ChenLiu-1996?color=blue)](https://www.linkedin.com/in/chenliu1996/)




[![Latest PyPI version](https://img.shields.io/pypi/v/git-star-percentile.svg)](https://pypi.org/project/git-star-percentile/)

[![PyPI download 3 month](https://static.pepy.tech/badge/git-star-percentile)](https://pepy.tech/projects/git-star-percentile)

[![PyPI download month](https://img.shields.io/pypi/dm/git-star-percentile.svg)](https://pypistats.org/packages/git-star-percentile)

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/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:

```bash

pip install git-star-percentile --upgrade

```

## ⚡ Usage

From the command line:

```bash

git-star-percentile

```

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

```bash

Enter the number of GitHub stars: 200

Your repo is approximately among the top xx.xxxx%.

```

## 📄 Data Source

### If we count all public repositories:



    



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



    



- Star statistics are **pulled from all public GitHub repositories**.

- Data is stored in [stats/github_repo_stars.csv](stats/github_repo_stars.csv).

- Want fresher stats? Run [the stats counter](count_all_repo_stars.py) yourself and submit a pull request.

    ```bash

    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.

    ```bash

    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.