Skip to main content

Network and Vulnerability scanner

Project description

Gambozino Hunter ๐Ÿ•ต๏ธโ€โ™‚๏ธ

Gambozino Hunter is a Python CLI tool for performing network scans and vulnerability scans with easy-to-read terminal output and JSON report generation.

It is designed for cybersecurity professionals, sysadmins, and developers who need quick insight into network assets and their potential weaknesses.


๐Ÿš€ Features

  • ๐Ÿ” Network Scanner:
    • Discovers active hosts on a subnet
    • Scans for open ports and running services
  • ๐Ÿ›ก๏ธ Vulnerability Scanner:
    • Matches known patterns and vulnerabilities
  • ๐Ÿ“„ Output:
    • Beautiful Rich tables for CLI viewing
    • JSON reports saved locally for further analysis
  • ๐Ÿ Fully compatible with Python 3.12+

๐Ÿ“ฆ Installation

You can install from PyPI:

pip install gambozino-hunter

Or install locally from source:

git clone https://github.com/ScriptK-dd13s/GambozinoHunter.git
cd GambozinoHunter
pip install .

๐Ÿ› ๏ธ Usage of Network Scanner

Run from the CLI

# If you need help just type
gh --help

# Scann all of the network 192.168.1.0/24 on port 22
gh network-scanner 192.168.1.0/24 -p 22

# Use the result of the last network scann to check for vulnerabilities and store it to a specific file
gh vuln-scanner -o /home/b3rrypi/some/folder/output.json

๐Ÿ“š Project Structure

.
โ”œโ”€โ”€ LICENSE
โ”œโ”€โ”€ pyproject.toml
โ”œโ”€โ”€ README.md
โ”œโ”€โ”€ requirements.txt
โ””โ”€โ”€ src
    โ”œโ”€โ”€ gh
    โ”‚ย ย  โ”œโ”€โ”€ cli.py
    โ”‚ย ย  โ”œโ”€โ”€ commands
    โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ __init__.py
    โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ network_scanner.py
    โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ __pycache__
    โ”‚ย ย  โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ __init__.cpython-312.pyc
    โ”‚ย ย  โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ network_scanner.cpython-312.pyc
    โ”‚ย ย  โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ portscanner.cpython-312.pyc
    โ”‚ย ย  โ”‚ย ย  โ”‚ย ย  โ”œโ”€โ”€ report_generation.cpython-312.pyc
    โ”‚ย ย  โ”‚ย ย  โ”‚ย ย  โ””โ”€โ”€ vuln_scanner.cpython-312.pyc
    โ”‚ย ย  โ”‚ย ย  โ””โ”€โ”€ vuln_scanner.py
    โ”‚ย ย  โ”œโ”€โ”€ __init__.py
    โ”‚ย ย  โ”œโ”€โ”€ __main__.py
    โ”‚ย ย  โ”œโ”€โ”€ patterns.json
    โ”‚ย ย  โ”œโ”€โ”€ __pycache__
    โ”‚ย ย  โ”‚ย ย  โ””โ”€โ”€ __init__.cpython-312.pyc
    โ”‚ย ย  โ””โ”€โ”€ tests
    โ”‚ย ย      โ””โ”€โ”€ typer_poc
    โ”‚ย ย          โ”œโ”€โ”€ goodbye.py
    โ”‚ย ย          โ”œโ”€โ”€ __init__.py
    โ”‚ย ย          โ””โ”€โ”€ main.py
    โ””โ”€โ”€ reports
        โ”œโ”€โ”€ gh_network_scan_report.json
        โ””โ”€โ”€ gh_vuln_scan_report.json

๐Ÿ“ License

This project is licensed under the MIT License.

๐Ÿง  Author & Contributing

Developed with โค๏ธ by FilipeS0usa and Grilinux. Contributions are welcome!

TODO / Roadmap

  • Add unit tests for core modules

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gambozino_hunter-1.0.9.tar.gz (9.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gambozino_hunter-1.0.9-py3-none-any.whl (9.2 kB view details)

Uploaded Python 3

File details

Details for the file gambozino_hunter-1.0.9.tar.gz.

File metadata

  • Download URL: gambozino_hunter-1.0.9.tar.gz
  • Upload date:
  • Size: 9.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.10

File hashes

Hashes for gambozino_hunter-1.0.9.tar.gz
Algorithm Hash digest
SHA256 97066d24e3ac3071d92f0524bce9af83a4f12899129bd617e951833f1dde6eac
MD5 c251a89fdcd7dde6658ca1b2059cc166
BLAKE2b-256 d9ddfe622f0b8add1ba73f126f3ee9ac1e43e5a91a82336fd6342cbba78926d1

See more details on using hashes here.

File details

Details for the file gambozino_hunter-1.0.9-py3-none-any.whl.

File metadata

File hashes

Hashes for gambozino_hunter-1.0.9-py3-none-any.whl
Algorithm Hash digest
SHA256 5e11da476078e3a8e165330168170fa1e6ec58eede779e6e68ad346f6324d4b2
MD5 9fe05e3c152768687be40fc27f4e78e9
BLAKE2b-256 493642b15ff3a10bd724088c41e98047140dc69362d9243857a22943b538317b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page