ML-powered 🤖 for finding and labeling good first issues in your GitHub project!


Python Lint GFI-Bot Tests GFI-Bot Coverage License GFI-Bot

A GFI-Bot introduction paper is available as follows (submitted to ESEC/FSE 2022 Demonstration Track):

  • Hao He, Haonan Su, Wenxin Xiao, Runzhi He, and Minghui Zhou. 2022. GFI-Bot: Automated Good First Issue Recommendation on GitHub. Currently Under Review at the ESEC/FSE 2022 Demonstration Track.

The underlying ML approach is introduced in the following paper:

  • Wenxin Xiao, Hao He, Weiwei Xu, Xin Tan, Jinhao Dong, and Minghui Zhou. 2022. Recommending Good First Issues in GitHub OSS Projects. In Proceedings of the 44th International Conference on Software Engineering, ICSE 2022, Pittsburgh, PA, USA, May 21–29, 2022. ACM.

We provide a good first issue recommendation dataset at Zenodo.

Get Started

GFI-Bot is available at, where you can browse through existing good first issue recommendations or register your own repository for recommendation. GFI-Bot can be installed in GitHub repositories from the GitHub App page.

NOTE: GFI-Bot is currently in pre-alpha stage. It is undergoing rapid development and still highly unstable. We cannot guanrantee the preseveration of registered users and repositories in the next release and it may have unexpected behaviors on GitHub. We will change this note after GFI-Bot reaches a certain level of maturity


We describe our envisioned use cases for GFI-Bot in this documentation.

Currently, we are focusing on the following tasks:

  1. Identifying an optimal training strategy
  2. Improving user experience


More development details are available at