Description

GitFive is an OSINT tool to investigate GitHub profiles.

Main features :

• Usernames / names history
• Usernames / names variations
• Email address to GitHub account
• Find GitHub’s accounts from a list of email addresses
• Lists identities used by the target
• Clones and analyze every target’s repos
• Highlights emails tied to GitHub’s target account
• Finds local identities (UPNs, ex : jeanpierre@My-Computer.local)
• Finds potential secondary GitHub accounts
• Don’t need repos to work (but better)
• Generates every possible email address combinations and looks for matchs
• Dumps SSH public keys
• JSON export

Optimizations :

• Very low API consumption, stays under the rate-limit
• Multi-processing tasks (bypassing Python’s GIL)
• Async scraping

Workflow

Click here for a full view

Requirements

• Git
• Python >= 3.10

Installation

$ pip3 install pipx
$ pipx ensurepath
$ pipx install gitfive

It will automatically use venvs to avoid dependency conflicts with other projects.

Usage

First, login to GitHub (preferably with a secondary account) :

$ gitfive login

Then, profit :

usage: gitfive [-h] {login,user,email,emails,light} ...

positional arguments:
  {login,user,email,emails,light}
    login               Let GitFive authenticate to GitHub.
    user                Track down a GitHub user by its username.
    email               Track down a GitHub user by its email address.
    emails              Find GitHub usernames of a given list of email addresses.
    light               Quickly find emails addresses from a GitHub username.

options:
  -h, --help            show this help message and exit

PS : plz avoid testing on torvalds or other authors of repos with 1 million commits

📄 You can also use –json with user and email modules to export in JSON ! Example :

$ gitfive user mxrch --json mxrch_data.json

Have fun 🥰💞

Video demo

Obvious disclaimer

This tool is for educational purposes only, I am not responsible for its use.

Less obvious disclaimer

The use of this tool in an automated paid service / software is strictly forbidden without my personal agreement.
Please use it only in personal, criminal investigations, or open-source projects.