Skip to content
KitploitKITPLOIT
ToolsExploitsBlog
Log in
Submit
ToolsExploitsBlog
Submit

Hacking, PenTest, and Cybersecurity Tools for Your Security Arsenal!

Kitploit is a directory of hacking, cybersecurity, and pentesting tools. Discover the latest project updates to find vulnerabilities, analyze systems, automate testing, and strengthen your security.

FeedsContactPrivacy© 2026 Kitploit

Tool Directory

Categories

View all categories
Loading categories
Tools/GitHubGitHub/eonraider/violent-python3
OSINT (Open Source Intelligence)ReconnaissanceBluetooth SecurityPassword AttacksExploitationForensicsWeb SecurityNetwork SecurityWireless SecurityPenetration TestingLearning & Education
GitHubeonraider/violent-python3

violent-python3

Source code for the book "Violent Python" by TJ O'Connor. The code has been fully converted to Python 3, reformatted to comply with PEP8 standards and refactored to eliminate dependency issues involving the implementation of deprecated libraries.

View Repository
1.0k179457 days agoReviewed by Kitploit
Share

Violent Python 3

CI Python 3.11-3.14 Managed with uv Open in GitHub Codespaces

The source code from Violent Python: A Cookbook for Hackers, Forensic Analysts, Penetration Testers and Security Engineers by TJ O'Connor (Syngress, 2012), converted from Python 2 to Python 3 and refactored to run on current interpreters and libraries.

The scripts stay close to the printed listings so they can be read side by side with the book. Every change made during the conversion is documented in docs/CONVERSION_NOTES.md.

[!NOTE] A companion conversion of Black Hat Python by Justin Seitz lives at EONRaider/blackhat-python3.

Contents

  • Quick start
  • Chapters
  • Downloading only what you need
  • Authorized use
  • Contributing
  • Translations
  • License and credits

Quick start

Python 3.11 or newer. Pick one of the following setups.

uv (recommended)

uv installs the right Python version if you don't have it and reproduces the exact dependency versions tested in CI from uv.lock.

git clone https://github.com/EONRaider/violent-python3.git
cd violent-python3
uv sync                              # every chapter
uv run python chapter04/geo_ip.py -h

Each chapter is a separate dependency group, so you can install only what you are reading:

uv sync --only-group ch04            # just chapter 4
uv sync --group ch05-bluetooth       # add the opt-in Bluetooth extras (Linux)

pip

git clone https://github.com/EONRaider/violent-python3.git
cd violent-python3
python3 -m venv .venv
source .venv/bin/activate            # Windows: .venv\Scripts\activate
pip install -r requirements.txt      # every chapter
pip install -r requirements/ch04.txt # or just one chapter

requirements*.txt carry version ranges. For the exact versions tested in CI, use requirements-lock.txt (and requirements-lock-bluetooth.txt for the opt-in group) from the latest release. With pip 25.1 or newer, you can also install a chapter's group straight from pyproject.toml with pip install --group ch04.

Docker

Each release publishes an image for linux/amd64 and linux/arm64 with every chapter's dependencies, nmap, tcpdump and the BlueZ runtime preinstalled:

docker run --rm -it ghcr.io/eonraider/violent-python3
# Chapters that sniff or forge packets need raw-socket capabilities:
docker run --rm -it --cap-add=NET_RAW --cap-add=NET_ADMIN ghcr.io/eonraider/violent-python3
# Or build it yourself:
docker build -t violent-python3 . && docker run --rm -it violent-python3

The image runs as root because most raw-socket chapters need it. With only the capabilities above, the container still isolates those scripts from the host, so add just what a chapter needs. Bluetooth (chapter 5) is different: it needs the host's network namespace to reach the adapter, for example with --net=host --cap-add=NET_RAW --cap-add=NET_ADMIN. That removes network isolation, so the container can see and act on all host traffic. Avoid --privileged, which also gives the container access to every host device.

GitHub Codespaces / Dev Containers

Use the Open in GitHub Codespaces badge above, or open the folder in VS Code or JetBrains with the Dev Containers extension. The container (.devcontainer/devcontainer.json) has the same tools as the Docker image, plus uv, git and compilers, and comes with raw-socket capabilities already granted.

System packages

Some chapters call external programs or need native libraries. The Docker image and dev container already include them; on a host install them yourself:

Needed forDebian / Ubuntu / KalimacOS (Homebrew)
chapter02/nmap_scan.py, conficker.pyapt install nmapbrew install nmap
Packet capture (chapters 4-5)apt install libpcap0.8 tcpdumpbuilt in
ch05-bluetooth groupapt install libbluetooth-devnot supported

Chapters

ChapterTopicuv groupPyPI packagesNotes
01Introductionch01standard-crypt (not Windows, Python 3.13+)crypt was removed from the stdlib in 3.13 (PEP 594); the backport keeps passwd_crack.py working. Like the original module it wraps libc crypt(3), so passwd_crack.py does not run on Windows.
02Penetration testingch02pexpect, python-nmapnmap binary required. Uses SSH and FTP against hosts you control.
03Forensic investigationsch03beautifulsoup4, pillow, pypdf4, requestsdiscover_networks.py and dump_recyclebin.py read the Windows registry and need Windows with Administrator rights. Sample Firefox/Skype databases and a PDF are included.
04Network traffic analysisch04dpkt, geoip2, ipy, scapySample .pcap files and a 2020 GeoLite2 City database are included; replace the database with a current download before use (see NOTICE). Live sniffing needs root / NET_RAW.
05Wireless mayhemch05, ch05-bluetoothscapy, pybluez (Linux, opt-in)Wi-Fi scripts need a card in monitor mode. ninja_print.py needs the ObexFTP Python 2 bindings, which have no Python 3 port.
06Web reconnaissancech06beautifulsoup4, mechanicalsoupThe Google and Twitter scripts target APIs that no longer exist; see the conversion notes.
07Antivirus evasion--Standard library only.

The PyPI column is generated by python tools/deps_scan.py report, which reads the imports in each chapter. The OS and privilege notes come from the conversion notes and may be incomplete; corrections are welcome.

Downloading only what you need

A full checkout is about 100 MB, mostly sample data: a 63 MB GeoLite2 database in chapter04/ and a 30 MB archive of weak Debian SSH keys in chapter02/. Shallow clones (--depth 1) save very little because those files are part of the current tree. To download just the chapters you want:

git clone --filter=blob:none --sparse https://github.com/EONRaider/violent-python3.git
cd violent-python3
git sparse-checkout set chapter01 chapter03    # any chapters you want

Or skip cloning entirely and use the Docker image.

Authorized use

Download Tool

Most Popular

View all →

Discover the most used tools by our community.

  • 1

    OsintHunter

    letox4/osinthunter

    🎯 The ultimate OSINT toolkit: investigation graph, confidence scoring, alias families, map, timeline and reports. 49 modules, 400+ sites, no API keys required.

    755
  • 2

    ghostlock-app

    yukonga/ghostlock-app

    GhostLock One-Tap Execution App (CVE-2026-43499)

    510
  • 3

    ARTEX

    baarai/artex

    LLM multi-agent autonomous penetration testing platform with planner/worker agents, asset and exploration graphs, MITM traffic recording, and vulnerability retesting.

    415
  • 4

    redforge

    cybersecurity91/redforge

    Browser-side red team toolkit with 102 offline tools for recon, payload generation, credential attacks, crypto, encoding and engagement reporting.

    343
  • 5

    antifox

    antifox-ai/antifox

    AI multi-agent autonomous penetration testing platform that runs recon, attack-surface discovery, exploitation validation and evidence-backed report delivery.

    259
  • 6

    CyberStrikeAI

    ed1s0nz/cyberstrikeai

    The system of action for AI-native cybersecurity—where intent becomes governed execution, evidence becomes operational memory, and every operation improves the next.

    258

Explore all tools

Browse our collection of tools

View all tools →