Skip to content

sweetnight19/InfoHunter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

57 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

InfoHunter 🕵️‍♂️

InfoHunter is a modular Python OSINT (Open Source Intelligence) suite for collecting and analyzing information about users, emails, and domains. It generates professional reports (PDF, JSON, etc.) and supports both interactive and automated workflows.

📑 Table of Contents

🚀 Features

  • Username analysis across social networks (Sherlock, Maigret, etc.)
  • Email leak and password checks (HIBP, BreachDirectory, Holehe, IntelX, EmailRep, Snusbase, etc.)
  • Public domain/company intelligence (WHOIS, DNS, Shodan, Hunter.io, etc.)
  • Automation-ready: CLI parameters and bot/API integration
  • Optional web frontend (Flask/Streamlit)

🛠️ Installation

  1. Clone the repository: git clone https://github.com/sweetnight19/InfoHunter.git

  2. (Recommended) Create and activate a virtual environment: python -m venv venv

On Windows venv\Scripts\activate

On Linux/Mac source venv/bin/activate

  1. Install requirements: pip install -r requirements.txt

  2. Configure your API keys (for more data sources):

  • Create a .env file in the root folder:
    HIBP_API_KEY=your_key
    BREACHDIRECTORY_API_KEY=your_key
    INTELX_KEY=your_key
    SHODAN_API_KEY=your_key
    VT_API_KEY=your_key
    HUNTER_API_KEY=your_key
    

⚡ Quick Usage

Interactive mode

python main.py

Username Analysis

python main.py -u username

Email Analysis

python main.py -e [email protected]

Domain Analysis

python main.py -d example.com

Automated/CLI mode

  • python main.py -e [email protected]
  • python main.py -d example.com
  • python main.py -u username

📦 Supported Modules & Data Sources

  • Usernames: Sherlock, Maigret, Holehe, SocialScan
  • Emails: HIBP, BreachDirectory, Holehe, IntelX, EmailRep, Snusbase, Gravatar
  • Domains: WHOIS, DNS, Shodan, Hunter.io, TheHarvester, VirusTotal

❗ Requirements

  • Python 3.8+
  • Internet access for external sources
  • Some sources require API keys (see .env)

💡 Contributing

Pull requests and suggestions are welcome!
Open an issue to discuss major changes or feature requests.

🛡️ License

MIT License. See LICENSE for details.


📬 Contact

🌐 Web Frontend (Streamlit)

InfoHunter includes a modern, visual frontend built with Streamlit to make OSINT analysis and report management easy and user-friendly.

What does the frontend offer?

  • Interactive OSINT analysis: Tab to analyze domains, emails, or usernames and display results in a clear, formatted way.
  • .env editor: Edit your API keys and configuration directly from the interface, without leaving your browser.
  • PDF report management: Download and delete generated reports easily. Includes a button to instantly refresh the report list.

How to use it?

  1. Launch the frontend:
    streamlit run app.py
    
  2. Open the local URL provided by Streamlit (default: http://localhost:8501).
  3. Navigate between the tabs:
    • OSINT Analysis: Select the type of analysis, enter the value, and click "Search". Results are shown in a user-friendly format.
    • Edit .env: Modify and save your API key configuration file.
    • Generated Reports: Download or delete PDFs. Use the "Refresh report list" button to see changes instantly.

Requirements

  • Make sure your .env file is configured and dependencies are installed.
  • Python 3.8+ and Streamlit installed (pip install streamlit).

About

An open-source OSINT tool designed for cybersecurity professionals and threat intelligence analysts, enabling you to search, collect, and analyze online information to build a comprehensive profile of the individual or organization you are investigating.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages