🐍 Now Python 3.13 compatible !

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

gitfive.mp4

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.

Thanks

novitae for being my Python colleague
rayanlecat, ABH, 22sh, BlackWasp, Tartofraise, mpgn, M3SS and n1nj4sec for the beta test
The HideAndSec team 💗 (blog : https://hideandsec.sh)

mxrch/GitFive