HunterOSINT

A Multi-Platform Username Intelligence Toolkit built with Python

HunterOSINT is a command-line Open Source Intelligence (OSINT) tool that searches for usernames across multiple online platforms. It performs concurrent scanning, displays results in a clean Rich-powered terminal interface, and generates reports in JSON, HTML, and CSV formats.

---

Features

• Multi-platform username scanning
• Concurrent scanning for faster results
• Rich terminal interface
• JSON report generation
• HTML report generation
• CSV report generation
• Configurable platform definitions using JSON
• Username validation
• Response time measurement
• Lightweight and easy to extend

---

Screenshots

Banner

---

Scan Results

---

Reports Generated

---

HTML Report

---

CSV Report

---

Installation

Prerequisites

Before installing HunterOSINT, ensure you have:

• Python 3.10 or later
• Git
• Internet connection

Verify your Python installation:

python --version

or

python3 --version

---

Windows

1. Clone the repository

git clone https://github.com/pardhu45/HunterOSINT.git

2. Navigate to the project

cd HunterOSINT

3. Create a virtual environment

python -m venv .venv

4. Activate the virtual environment

PowerShell

.venv\Scripts\Activate.ps1

Command Prompt

.venv\Scripts\activate.bat

5. Install dependencies

pip install -r requirements.txt

6. Run HunterOSINT

python hunterosint.py

---

Linux

1. Clone the repository

git clone https://github.com/pardhu45/HunterOSINT.git

2. Navigate to the project

cd HunterOSINT

3. Create a virtual environment

python3 -m venv .venv

4. Activate the virtual environment

source .venv/bin/activate

5. Install dependencies

pip install -r requirements.txt

If your system uses pip3:

pip3 install -r requirements.txt

6. Run HunterOSINT

python3 hunterosint.py

---

Verifying the Installation

If everything is installed correctly, you should see:

╭────────────────────────────────────────────╮
│ HunterOSINT                                │
│ Multi-Platform Username Intelligence Tool  │
│ Version 1.0.0                              │
╰────────────────────────────────────────────╯

Available Modules

[1] Username Intelligence
[0] Exit

---

Usage

Start the application:

python hunterosint.py

Select the Username Intelligence module:

Select Module > 1

Enter a username:

Enter Username > torvalds

HunterOSINT will:

• Validate the username
• Scan supported platforms
• Display results in the terminal
• Generate reports automatically

Generated reports are saved inside:

output/

---

Supported Platforms

Platform	Status
GitHub	✅
GitLab	✅
Reddit	✅
HackerOne	✅
Dev.to	✅
Docker Hub	✅
Kaggle	✅

---

Output Formats

HunterOSINT automatically generates:

• JSON Report
• HTML Report
• CSV Report

Reports are stored in the output/ directory.

---

Project Structure

HunterOSINT/
│
├── assets/
│   ├── banner.png
│   ├── scan_results.png
│   ├── reports.png
│   ├── html_report.png
│   └── csv_report.png
│
├── core/
│   ├── platform_scanner.py
│   ├── requester.py
│   ├── scanner.py
│   └── validator.py
│
├── modules/
│   └── username.py
│
├── platforms/
│   ├── github.json
│   ├── gitlab.json
│   ├── reddit.json
│   ├── hackerone.json
│   ├── devto.json
│   ├── dockerhub.json
│   └── kaggle.json
│
├── utils/
│   ├── console.py
│   ├── report.py
│   ├── html_report.py
│   └── csv_report.py
│
├── output/
├── hunterosint.py
├── menu.py
├── requirements.txt
├── README.md
├── LICENSE
└── .gitignore

---

Known Limitations

Some platforms implement anti-bot protections such as Cloudflare or similar security mechanisms.

When this occurs, HunterOSINT may return:

UNKNOWN

instead of FOUND or NOT FOUND.

---

Roadmap

Version 1.0.0

• Username Intelligence
• Concurrent Scanning
• Rich Terminal Interface
• JSON Reports
• HTML Reports
• CSV Reports
• Configurable Platform Definitions

Future Plans

• Additional Platforms
• Improved Detection Engine
• Command-Line Arguments
• Plugin System
• Export to PDF
• Async Scanning
• PyPI Package
• Automated Tests

---

Contributing

Contributions are welcome.

If you'd like to improve HunterOSINT:

1. Fork the repository
2. Create a feature branch
3. Commit your changes
4. Open a Pull Request

For major changes, please open an issue first to discuss your proposal.

---

License

This project is licensed under the MIT License.

See the LICENSE file for details.

---