A collection of small offensive-security tools written in Python, built as personal learning exercises. Each tool lives in its own module with a focused CLI and no external dependencies beyond what it actually needs.
Educational use only. These tools are intended for authorized security testing, labs, and CTF practice. Only run them against systems you own or have explicit written permission to test. Unauthorized use is illegal in most jurisdictions and is solely your responsibility.
| Tool | Module | What it does |
|---|---|---|
| Port Scanner | tools.port_scanner |
Fast concurrent TCP port scanner with optional banner grabbing. |
| ICMP Scanner | tools.icmp_scanner |
Host discovery by parallel ICMP echo (ping sweep). |
| Keylogger | keylogger.main |
Keystroke capture reported over email (Gmail SMTP). |
Requires Python 3.10+.
# Clone the repository
git clone git@github.com:danielvaldess/Pyoffensive-tools.git
cd Pyoffensive-tools
# Install dependencies (the ICMP and port scanners are stdlib-only;
# only the keylogger needs pynput)
pip3 install -r requirements.txtpython3 -m tools.port_scanner -t 192.168.1.1 -p 1-1024python3 -m tools.icmp_scanner -t 192.168.1.1-254export SMTP_USERNAME=you@gmail.com
export SMTP_APP_PASSWORD=your-app-password
python3 -m keylogger.mainPython-Ofensivo/
├── tools/ # Network reconnaissance tools (stdlib-only)
│ ├── port_scanner.py # concurrent TCP port scanner
│ └── icmp_scanner.py # ICMP host discovery
├── keylogger/ # Keystroke capture + email reporting
│ ├── keylogger.py
│ └── main.py
├── docs/ # Per-tool usage documentation
├── .env.example # Keylogger credential template
└── requirements.txt