/github-stars-by-topic

:star: Generate a list of your GitHub stars by topic - automatically!

Primary LanguagePython

Your GitHub stars sorted by topic/category

This is a python script that fetches your GitHub stars and uses Machine Learning (buzzword, check) to extract a given number of topics. It then generates a folder structure so you can easily browse through the topics in markdown.

The result can be viewed in the example folder.

Usage

Just run python3 main.py on the command line. It will ask you for your GitHub credentials to fetch your stars and then do its job. The result will be a folder in the main directory that you can copy or save in a GitHub repository for others to browse.

Dependencies

  • PyGithub to fetch your stars. install
  • requests to fetch readmes from github. install
  • Markdown to generate html from markdowns. install
  • BeautifulSoup: extract text from generated html (easiest method to get plain text from markdown). install
  • scikit-learn and the scipy stack for the machine learning algorithms (topic extraction, tf-idf vectors, etc.). install