README_template.md
All-in-One Hacking Tool for Security Researchers & Pentesters
</div>os.chdir() bugs fixed — tools install to ~/.hackingtool/tools/sudo git clone — tools install to user home, no root neededrequirements.txt cleaned — removed unused flask/boxes/lolcat/requests{{toc}}
{{tools}}
Want a tool included? Raise an Issue or open a PR using the templates below.
Title format:
[Tool Request] ToolName — CategoryExample:[Tool Request] Subfinder — Information Gathering
Use the Tool Request issue template and fill in all required fields: tool name, GitHub URL, category, supported OS, install command, and why it should be added.
Title format:
[New Tool] ToolName — CategoryExample:[New Tool] Subfinder — Information Gathering
Use the PR template checklist. Key requirements:
tools/*.py fileTITLE, DESCRIPTION, INSTALL_COMMANDS, RUN_COMMANDS, PROJECT_URLSUPPORTED_OS = ["linux"] or ["linux", "macos"] appropriatelyTOOLS list in the collection classIssues or PRs that don't follow the title format may be closed without review.
curl -sSL https://raw.githubusercontent.com/Z4nzu/hackingtool/master/install.sh | sudo bash
This handles everything — installs prerequisites, clones the repo, sets up a venv, and creates the hackingtool command.
git clone https://github.com/Z4nzu/hackingtool.git
cd hackingtool
sudo python3 install.py # detects local source, copies instead of re-cloning
Then run:
hackingtool
git clone https://github.com/Z4nzu/hackingtool.git
cd hackingtool
docker build -t hackingtool .
First build takes a few minutes (Kali base + apt packages). Subsequent builds are fast thanks to BuildKit layer caching.
Option A — Direct (no Compose):
docker run -it --rm hackingtool
Option B — With Docker Compose (recommended):
# Start in background
docker compose up -d
# Open an interactive shell
docker exec -it hackingtool bash
# Then launch the tool inside the container
python3 hackingtool.py
Option C — Dev mode (live source mount, changes reflected without rebuild):
docker compose --profile dev up
docker exec -it hackingtool-dev bash
docker compose down # stop and remove container
docker compose down -v # also remove the tools data volume
pip install -r requirements.txt
Please don't use for illegal activity. Thanks to all original authors of the tools included in hackingtool.
Your favourite tool is not listed? Suggest it here