Skip to content

hideckies/ihunt

Repository files navigation

ihunt

Information gathering tool that collects information using OSINT and AI, while remaining undetected by the target.

Installation

Option 1. Using Pip

The most easiest way is to install the Python package with pip.

pipx install ihunt
# or
pip install ihunt

After installing, run the following command to show the usage:

ihunt --help

Option 2. Using uv

If you want to use the latest features (but unstable), clone the repository and run the following command.
Assuming that you've already installed the uv package manager.

git clone https://github.com/hideckies/ihunt.git
cd ihunt
uv run ihunt --help

Usage

It's easy to use. Simply run one of the following commands:

# Research domain
ihunt example.com

# Research email address
ihunt [email protected]

# Research hash
ihunt ed076287532e86365e841e92bfc50d8c

# Research IP address
ihunt 8.8.8.8

# Research organization
ihunt Google

# Research person
ihunt "Elon Musk"

# Research phone number
ihunt "+1 202-555-0123"

# Research URL
ihunt https://example.com

Using API Keys

Some API need api keys, so if you want to collect information more, I recommend to set the api keys.
To set them, copy the .config.template and set each api key, then execute with the -c/--config option:

ihunt -c .config example.com

Alternatively, we can directly set api keys to environment variables via command-line:

export IHUNT_APIKEY_ABUSEIPDB=xxxxxxxxxxxxxxx...
ihunt 8.8.8.8

Output Format

Using -o/--output option, the result will be saved to a specified file. The ihunt detects the output format from the extension of the file path as below:

# JSON
ihunt -o output.json example.com

# YAML
ihunt -o output.yaml example.com

# Others (pretty print)
ihunt -o output.txt example.com