+2
Daily
19,851
stars
1,752
forks
560
watchers
114
prs
444
issues
3
releases
README
!
🌐 GHunt Online version : https://osint.industries
🐍 Now Python 3.13 compatible !
!Python minimum version
😊 Description
GHunt (v2) is an offensive Google framework, designed to evolve efficiently.\
It's currently focused on OSINT, but any use related with Google is possible.
Features :
- CLI usage and modules
- Python library usage
- Fully async
- JSON export
- Browser extension to ease login
✔️ Requirements
- Python = 3.10
⚙️ Installation
bash
$ pip3 install pipx
$ pipx ensurepath
$ pipx install ghunt
It will automatically use venvs to avoid dependency conflicts with other projects.
💃 Usage
Login
First, launch the listener by doing ghunt login and choose between 1 of the 2 first methods :
bash
$ ghunt login
[1] (Companion) Put GHunt on listening mode (currently not compatible with docker)
[2] (Companion) Paste base64-encoded cookies
[3] Enter manually all cookies
Choice =
Then, use GHunt Companion to complete the login.
The extension is available on the following stores :\
\
Modules
Then, profit :
bash
Usage: ghunt [-h] {login,email,gaia,drive,geolocate} ...
Positional Arguments:
{login,email,gaia,drive,geolocate}
login Authenticate GHunt to Google.
email Get information on an email address.
gaia Get information on a Gaia ID.
drive Get information on a Drive file or folder.
geolocate Geolocate a BSSID.
spiderdal Find assets using Digital Assets Links.
Options:
-h, --help show this help message and exit
📄 You can also use --json with email, gaia, drive and geolocate modules to export in JSON ! Example :
bash
$ ghunt email --json user_data.json
Have fun 🥰💞
🧑💻 Developers
📕 I started writing some docs here and examples here, feel free to contribute !
To use GHunt as a lib, you can't use pipx because it uses a venv.\
So you should install GHunt with pip :
bash
$ pip3 install ghunt
And now, you should be able to import ghunt in your projects !\
You can right now play with the examples.
📮 Details
Obvious disclaimer
This tool is for educational purposes only, I am not responsible for its use.
Less obvious disclaimer
This project is under AGPL Licence, and you have to respect it.\
Use it only in personal, criminal investigations, pentesting, or open-source projects.
Thanks
- novitae for being my Python colleague
- All the people on Malfrats Industries and elsewhere for the beta test !
- The HideAndSec team 💗 (blog : https://hideandsec.sh)
- Med Amine Jouini for his beautiful rework of the Google logo, which I was inspired by a lot.
Sponsors
Thanks to these awesome people for supporting me !
\
You like my work ?\
Sponsor me on GitHub ! 🤗Top issues
#591Email lookup failing / Possible Google change12 comments · 2026-04-08#515Ghunt won't retrieve name11 comments · 2024-04-03#417Stuck at target's location preferences / Calculating confidence both gaiga-email11 comments · 2023-01-20#513KeyError: 'people' on 3 different accounts10 comments · 2024-03-28#492Doesn't work!(10 comments · 2024-01-25#478Unable to Install GHunt -> ERROR: Could not build wheels for pillow, which is required to install pyproject.toml-based projects9 comments · 2024-01-10#482[Bug] Some Profile Pictures are not shown when an account with multiple profile photos are specified.6 comments · 2024-01-12#414Help - Creds aren't loaded. Are you logged in? 6 comments · 2023-01-17
Discussions
#618Ho198wev1 comments · 2026-11-15#585Flexible to input0 comments · 2026-03-08#583Sponsor Ghunt0 comments · 2026-03-07#577Is Ghunt still being maintained/location issues not resolved for some time...?1 comments · 2026-02-03#559What are all major differences between online ghunt version and python/cli version ?4 comments · 2025-09-11#557Breaking when trying to run ghunt email <email_address> --json user_data.json0 comments · 2025-06-30#538Public document creator email1 comments · 2024-10-30#534simplify email parameter by removing @gmail.com0 comments · 2024-10-09
Latest release
v2.2.0 v2.2.0 2024-06-06New module ! 📍🗺️ Releasing the geolocate module, that lets you geolocate a BSSID. No API key required ! Update pipx upgrade ghunt 🥰