ghunt

library2.3.4pypypiunverified

An offensive Google framework that provides modules to gather information from Google services. Current version 2.3.4, requires Python >=3.10. Released actively, with major refactors in v2.0.0 (async, CLI, library usage) and v2.1.0 (replaced cookies with OAuth token).

gcp

pipx install ghunt

github ↗package ↗

INSTALL

IMPORT

SIG · GHUNT

ghunt

gcppythonv2.3.4

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

GHuntLib

✓ from ghunt import GHuntLib

✗ from ghunt.core import GHuntLib

Asynchronous example of using GHunt as a library. Requires authentication via OAuth (run `ghunt auth` first).

import asyncio from ghunt.auth import Auth from ghunt.core import GHuntLib async def main(): auth = Auth() await auth.load() # loads existing credentials or starts OAuth flow ghunt = GHuntLib(auth) result = await ghunt.search("example@gmail.com") print(result) asyncio.run(main())

ghunt --version

Debug

Known issues

breakingv2.1.0 removed cookie-based authentication entirely. OAuth token is now required.

fix

Run `ghunt auth` to generate OAuth token. Remove any cookie files.

affects: <2.1.0

breakingv2.0.0 refactored the entire library - async, new CLI, new API. All v1 scripts are incompatible.

fix

Rewrite code to use async/await and the new library API. See GitHub README for migration.

affects: <2.0.0

gotchaOAuth token (Android token) expires after a certain period. You must re-run `ghunt auth` periodically.

fix

Check token expiry with `ghunt auth check` or reauthenticate before running modules.

affects: >=2.1.0

gotchaNot all Google accounts work; GHunt requires an account with Google's 'multilogin' OAuth flow enabled (typically Android-style tokens).

fix

Use a personal Google account (not G Suite/Workspace with restrictions).

affects: >=2.1.0

Upgrade

Version history

2.3.4latest on PyPI · released Mar 16, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

33 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/mxrch/GHunt ↗

packagehttps://pypi.org/project/ghunt/ ↗