Skip to main content

Browse popular projects on github by star trends from your command line

Project description

Cover image

Browse trending repos on Github by ⭐stars⭐ from your command line! 💻

checks pypi version pypi downloads per month Python Requirements Code style: black GitHub license MIT

starcli demo.gif


  • Requires Python 3.6 or greater


pip install starcli

Remember to use pip3 instead of pip if you also have Python 2 installed on your system


Usage: starcli [OPTIONS]

  Browse trending repos on GitHub by stars

  -l, --lang TEXT                 Language filter eg: python
  -S, --spoken-language TEXT      Spoken Language filter eg: en for English, zh for Chinese, etc
  -d, --date-created TEXT         Specify repo creation date in ISO8601 format
  -t, --topics TEXT               Search by topic. Can be specified multiple
                                  times. Multiple topics will be conjugated
                                  using &
  -u, --last-updated TEXT         Filter repos based on time of last update in
                                  ISO8601 format YYYY-MM-DD
  -L, --layout [list|table|grid]  The output format (list, table, or grid),
                                  default is list
  -s, --stars TEXT                Range of stars required, default is '>=100'
  -r, --limit-results INTEGER     Limit the number of results shown. Default:
  -o, --order [desc|asc]          Specify the order of repos by stars that is
                                  shown, 'desc' or 'asc', default: desc
  --long-stats                    Print the actual stats[1300 instead of 1.3k]
  --debug                         Turn on debugging mode
  --help                          Show this message and exit.


Switch layouts using --layout {list|table|grid}, or use the short option -L


demo list



demo grid

Filtering by language

For example, you only want to find popular Python repos, you can use --lang or -l:

starcli --lang python

Here, we used starcli -l python -L grid, which is python with grid layout:

demo grid

Filtering by spoken language

If you wanted to find repos in your native language, you can use --spoken-language or -S:

starcli --spoken-language zh

The above command lists down repos written in Chinese. A full list of language codes is available here

Specify the number (or range) of stars

(Recommended to be used with --date-created)

The default range is >=100, you can change that! Use --stars or -s to specify what you want, for example, if you want to find repos that has more than 100 stars, you can use:

starcli -s '>100'

Note that if you do something like >1000 not many repos can have more than 1000 and is created within around 200 days, to specify date of creation, use --date-created, see below.

Specify the date of creation

Want to find newer, older, or just created repos? Just use --date-created or -d, and then provide a date in ISO8601 format: yyyy-mm-dd

For example, to 1st January 2014, use:

starcli --date-created 2014-01-01

Filtering by topics

This option helps you to filter by topics. You can use --topicsor -t to include a topic in search. This option can be used multiple times.

starcli -l python -d 2020-07-06 -t deep-learning -t pytorch

Specifying last updated date

Use this --last-updated or -u when you want to find popular repos that are last updated on a given date, say 2020-01-01 for 1st of Jan 2020:

starcli -u 2020-01-01

Limit the number of results shown

Don't like the default 7? You can change it to something else, using --limit-results or -r followed by an integer:

starcli -r 2

The above will only give you two repos. This is useful if you want to put it in your .bashrc, .zshrc, or fish_greeting function.

Just add starcli -r 3 -L grid in there, and every time you open your terminal, you will find 3 trending repos printed neatly in a grid format, great way to start your day (bit like the Hacker Tab Extension 😆 ).

Issues, feature request, and feedback

  • Issues, bug reports, or feature request: Don't hesitate to open an issue in this repo
  • Feedback: any general feedback or questions about using StarCLI you can leave a comment on our Product Hunt page, remember to be nice :)

Development PRs Welcome

For contributing guidelines and how to set up your development environment, please read Remember that all contributions to this project should follow its CODE OF CONDUCT.


  • CommandLine Argument parser: Click
  • Colored and table console print: rich (with click and colorama)
  • HTTP library to send requests: requests

Contributors ✨

Thanks goes to all of these wonderful people (emoji key):





Sam Wellander


Shivam Sinha


Will McGugan


Ashik J M


Yu-Lin Chao


Saif Kazi

💻 📖

This project follows the all-contributors specification. Contributions of any kind welcome!


This project was forked from githunt (python) and its initial intention was to rewrite that project to use Rich instead of colorama + tabulate, but now it has so much more features than before, thanks everyone!

Liked this project? Don't forget to give it a ⭐

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

starcli-2.11.0.tar.gz (12.5 kB view hashes)

Uploaded Source

Built Distribution

starcli-2.11.0-py3-none-any.whl (10.9 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page