Metadata-Version: 2.4
Name: hunterx-reconhive
Version: 0.2.5
Summary: Modern modular reconnaissance framework for bug bounty hunters and security researchers.
Author: Alireza
License-File: LICENSE
Requires-Python: >=3.13
Requires-Dist: beautifulsoup4>=4.15.0
Requires-Dist: bs4>=0.0.2
Requires-Dist: dnspython>=2.8.0
Requires-Dist: h2>=4.3.0
Requires-Dist: httpx>=0.28.1
Requires-Dist: lxml>=6.1.1
Requires-Dist: rich>=14.0.0
Requires-Dist: typer>=0.16.0
Description-Content-Type: text/markdown

<!-- ========================================================= -->

<!-- Banner -->

<!-- ========================================================= -->

<p align="center">
  <img src="assets/images/banner.png" alt="HunterX Banner" width="100%" style="border-radius: 5px;">
</p>

<h1 align="center">HunterX</h1>

<p align="center">
  <strong>Modern Workspace-Aware Reconnaissance Framework</strong>
</p>

<p align="center">
  Built for Bug Bounty Hunters • Penetration Testers • Security Researchers
</p>

<p align="center">
  Fast • Modular • Intelligent • Extensible
</p>

---

<p align="center">

<a href="https://pypi.org/project/hunterx-reconhive/">
<img src="https://img.shields.io/pypi/v/hunterx-reconhive?style=for-the-badge&logo=pypi">
</a>

<a href="LICENSE">
<img src="https://img.shields.io/github/license/ReconHive/HunterX?style=for-the-badge">
</a>

<a href="https://www.python.org/">
<img src="https://img.shields.io/badge/Python-3.11+-3776AB?style=for-the-badge&logo=python&logoColor=white">
</a>

<a href="https://github.com/ReconHive/HunterX/stargazers">
<img src="https://img.shields.io/github/stars/ByBug-Developers/HunterX?style=for-the-badge">
</a>

<a href="https://github.com/ReconHive/HunterX/issues">
<img src="https://img.shields.io/github/issues/ByBug-Developers/HunterX?style=for-the-badge">
</a>

</p>

<p align="center">

🇺🇸 English • 🇮🇷 <a href="README_FA.md">فارسی</a>

</p>

---

# HunterX

HunterX is a modern reconnaissance framework written entirely in Python.

Unlike traditional reconnaissance tools, HunterX executes plugins through a shared workspace, allowing collected artifacts to be reused across scans instead of repeating the same network operations.

Its modular architecture, automatic dependency resolution, and workspace-aware execution make reconnaissance faster, cleaner, and more efficient.

---

# 🚀 Quick Install

Using pip

```bash
pip install hunterx-reconhive
```

Using uv

```bash
uv tool install hunterx-reconhive
```

---

# ⚡ Quick Start

Run a complete reconnaissance scan.

```bash
hunterx scan example.com
```

Run only selected plugins.

```bash
hunterx scan example.com -p dns,http,crawler
```

Generate a report.

```bash
hunterx scan example.com -o report.json
```

More examples are available in the Wiki.

---

# Why HunterX?

HunterX is designed around a simple philosophy:

**Discover once. Store everything. Reuse everywhere.**

Instead of repeating reconnaissance tasks, plugins share artifacts through a common workspace. This minimizes redundant requests, speeds up scans, and enables intelligent plugin orchestration.

---

# Features

* Modular plugin architecture
* Workspace-aware execution
* Automatic dependency resolution
* DNS reconnaissance
* HTTP fingerprinting
* Subdomain enumeration
* Website crawling
* JavaScript analysis
* Parameter extraction
* Directory enumeration
* Port scanning
* TLS inspection
* Takeover detection
* JSON & Markdown reports
* Rich terminal interface
* Extensible plugin system

---

# 📚 Documentation

Complete documentation is available in the GitHub Wiki.

| Guide                 | Description                    |
| --------------------- | ------------------------------ |
| Installation          | Install HunterX                |
| Quick Start           | Run your first scan            |
| CLI Reference         | Command-line options           |
| Plugins               | Available plugins              |
| Workspace             | Shared artifact storage        |
| Dependency Resolution | Automatic plugin orchestration |
| Architecture          | Framework design               |
| Examples              | Practical workflows            |
| FAQ                   | Frequently asked questions     |

---

# 🏗 Architecture

```text
             CLI
              │
              ▼
      HunterX Core Engine
              │
              ▼
   Dependency Resolution
              │
              ▼
      Workspace Engine
              │
      ┌───────┼────────┐
      ▼       ▼        ▼
     DNS     HTTP   Crawler
                      │
             ┌────────┴────────┐
             ▼                 ▼
      JavaScript         Parameters
             │
             ▼
      Report Generator
```

See the Wiki for a detailed explanation of the architecture.

---

# 🤝 Community

Contributions are always welcome.

* Report bugs
* Suggest new features
* Submit pull requests
* Improve documentation

If HunterX helps your security research, consider giving the project a ⭐ on GitHub.

---

# 📄 License

MIT License.

---

# ⚠ Disclaimer

HunterX is intended for authorized security assessments and educational purposes only.

The author assumes no responsibility for misuse or damage caused by this software.
