<h1 align="center">
⭐ <code>GitStarPercentile</code>
</h1>
<div align="center">
[](https://twitter.com/ChenLiu_1996)
[](https://www.linkedin.com/in/chenliu1996/)
<br>
[](https://pypi.org/project/git-star-percentile/)
[](https://pepy.tech/projects/git-star-percentile)
[](https://pypistats.org/packages/git-star-percentile)
[](https://opensource.org/licenses/MIT)
</div>
<br>
🤔 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?"
<br>
<code>GitStarPercentile</code> 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.
## 📦 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:
<div align="center">
<img src="assets/github_stars_distribution_all.png" alt="GitHub Stars Distribution" style="max-width:100%; height:auto;">
</div>
### If we only count public repositories with at least 1 star:
<div align="center">
<img src="assets/github_stars_distribution_nonzero.png" alt="GitHub Stars Distribution" style="max-width:100%; height:auto;">
</div>
- 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.
Raw data
{
"_id": null,
"home_page": "https://github.com/ChenLiu-1996/GitStarPercentile",
"name": "git-star-percentile",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "GitHub, repository, star, popularity, percentile",
"author": "Chen Liu",
"author_email": "chen.liu.cl2482@yale.edu",
"download_url": "https://files.pythonhosted.org/packages/0b/3c/37a8807a9b07d278289758c5e6b5d464167c7f4dd3fca2d3df14964dc45e/git-star-percentile-1.8.tar.gz",
"platform": null,
"description": "<h1 align=\"center\">\n⭐ <code>GitStarPercentile</code>\n</h1>\n\n<div align=\"center\">\n\n[](https://twitter.com/ChenLiu_1996)\n[](https://www.linkedin.com/in/chenliu1996/)\n<br>\n[](https://pypi.org/project/git-star-percentile/)\n[](https://pepy.tech/projects/git-star-percentile)\n[](https://pypistats.org/packages/git-star-percentile)\n[](https://opensource.org/licenses/MIT)\n\n</div>\n\n<br>\n\n🤔 Have you ever wondered **how popular your GitHub repository really is**?\n\n😠 Frustrated that GitHub **doesn\u2019t show star percentiles anywhere**?\n\nMaybe you\u2019ve thought:\n> \"I have 200 stars \u2014 but is that a lot?\"\n\n> \"Where does my repo rank compared to the other repos?\"\n\n<br>\n<code>GitStarPercentile</code> tells you instantly:\n\nEnter your star count and instantly see your percentile, calculated from GitHub-wide data.\n\n\n## 🚀 Features\n\n- 📊 **Instant percentile lookup** \u2014 get your repo\u2019s rank in milliseconds.\n- 🖥 **Simple CLI** \u2014 just type `git-star-percentile` and enter your star count.\n\n\n## 📦 Installation\nFrom the command line:\n\n```bash\npip install git-star-percentile --upgrade\n```\n\n## ⚡ Usage\nFrom the command line:\n\n```bash\ngit-star-percentile\n```\n\nYou\u2019ll be prompted to enter the number of stars for your repository:\n\n```bash\nEnter the number of GitHub stars: 200\nYour repo is approximately among the top xx.xxxx%.\n```\n\n## 📄 Data Source\n\n### If we count all public repositories:\n<div align=\"center\">\n <img src=\"assets/github_stars_distribution_all.png\" alt=\"GitHub Stars Distribution\" style=\"max-width:100%; height:auto;\">\n</div>\n\n### If we only count public repositories with at least 1 star:\n<div align=\"center\">\n <img src=\"assets/github_stars_distribution_nonzero.png\" alt=\"GitHub Stars Distribution\" style=\"max-width:100%; height:auto;\">\n</div>\n\n\n- Star statistics are **pulled from all public GitHub repositories**.\n- Data is stored in [stats/github_repo_stars.csv](stats/github_repo_stars.csv).\n- Want fresher stats? Run [the stats counter](count_all_repo_stars.py) yourself and submit a pull request.\n ```bash\n python count_all_repo_stars.py --github-token $YOUR_GITHUB_TOKEN\n ```\n\n The line above would run over all public repositories. For a more manageable run, sample 1 million instead.\n ```bash\n python count_all_repo_stars.py --github-token $YOUR_GITHUB_TOKEN --sample-size 1000000\n ```\n\n Note I will not consider merging results with `--sample-size` below 1 million.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A simple tool to quantify your GitHub repo star percentile.",
"version": "1.8",
"project_urls": {
"Homepage": "https://github.com/ChenLiu-1996/GitStarPercentile"
},
"split_keywords": [
"github",
" repository",
" star",
" popularity",
" percentile"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "e6e8e55bf11a07e228ab042a796fefc18a3e0d59adf844842c0df9e6f282e7f0",
"md5": "8289a8554a15182eb87534fd41641847",
"sha256": "52a4548595785265c499ca395e5f876b1fa8da7743816272c275d2d760d8a92f"
},
"downloads": -1,
"filename": "git_star_percentile-1.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8289a8554a15182eb87534fd41641847",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 4888,
"upload_time": "2025-08-14T09:49:28",
"upload_time_iso_8601": "2025-08-14T09:49:28.055223Z",
"url": "https://files.pythonhosted.org/packages/e6/e8/e55bf11a07e228ab042a796fefc18a3e0d59adf844842c0df9e6f282e7f0/git_star_percentile-1.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0b3c37a8807a9b07d278289758c5e6b5d464167c7f4dd3fca2d3df14964dc45e",
"md5": "01038d734a7ef982dd7e2977a8bc73c7",
"sha256": "f81b762c5eea41d5a3e135b4fbe365f75fab95e0837c60c120664e123d25a892"
},
"downloads": -1,
"filename": "git-star-percentile-1.8.tar.gz",
"has_sig": false,
"md5_digest": "01038d734a7ef982dd7e2977a8bc73c7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4321,
"upload_time": "2025-08-14T09:49:29",
"upload_time_iso_8601": "2025-08-14T09:49:29.171648Z",
"url": "https://files.pythonhosted.org/packages/0b/3c/37a8807a9b07d278289758c5e6b5d464167c7f4dd3fca2d3df14964dc45e/git-star-percentile-1.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-14 09:49:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ChenLiu-1996",
"github_project": "GitStarPercentile",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "git-star-percentile"
}
JSON
