Gallopsled /pwntools
CTF framework and exploit development library
★ 13,864⑂ 1,877👁 272⑃ 1,639● 1,138▤ 80
+4
Daily
+43
Weekly
+93
Monthly
13,864
stars
1,877
forks
272
watchers
1,639
prs
1,138
issues
80
releases
README
pwntools - CTF toolkit
!pwntools logo
Pwntools is a CTF framework and exploit development library. Written in Python, it is designed for rapid prototyping and development, and intended to make exploit writing as simple as possible.
python
from pwn import
context(arch = 'i386', os = 'linux')
r = remote('exploitme.example.com', 31337)
EXPLOIT CODE GOES HERE
r.send(asm(shellcraft.sh()))
r.interactive()
Documentation
Our documentation is available at docs.pwntools.com
A series of tutorials is also available online
To get you started, we've provided some example solutions for past CTF challenges in our write-ups repository.
Installation
Pwntools is best supported on 64-bit Ubuntu LTS releases (22.04 and 24.04). Most functionality should work on any Posix-like distribution (Debian, Arch, FreeBSD, OSX, etc.).
Pwntools supports Python 3.10+ since version 5.0.0. Use Pwntools 4.x for older versions as well as Python 2.7. Most of the functionality of pwntools is self-contained and Python-only. You should be able to get running quickly with
sh
sudo apt-get update
sudo apt-get install python3 python3-pip python3-dev git libssl-dev libffi-dev build-essential
python3 -m pip install --upgrade pip
python3 -m pip install --upgrade pwntools
However, some of the features (assembling/disassembling foreign architectures) require non-Python dependencies. For more information, see the complete installation instructions here.
Contribution
See CONTRIBUTING.md
Contact and Community
If you have any questions not worthy of a bug report, join the Discord server at https://discord.gg/96VA2zvjCBTop issues
#2731GDB is stuck in kitty12 comments · 2026-05-08#2705cannot Ctrl-C remote connection when network is flaky11 comments · 2026-03-24#1628add dockerized tube for better pwning10 comments · 2020-07-04#932Automatic finding one-gadget10 comments · 2017-03-24#2002Switch tests to use pytest9 comments · 2021-11-25#1236Feature: Async IO?9 comments · 2018-12-18#1976UDP recv works in Python console, does not work when executed as python3 exploit.py6 comments · 2021-10-05#2433gdb.debug stops at every breakpoint, running slow5 comments · 2024-08-02
Discussions
#2779Show prompt or recentoutut in clli stream1 comments · 2026-09-15#2412syscall execve ignores the -c parameter0 comments · 2024-05-25#2404Switch to different zstandard library?1 comments · 2024-05-11#2340pwntools cannot handle SIGSEGV in my Archlinux2 comments · 2024-01-28#2292debug with tmux2 comments · 2023-11-01#2138How do I exit interactive mode gracefully?1 comments · 2022-11-19#2109Is it possible to log to `context.log_file` with a different log level than used with stdout?1 comments · 2022-09-18#2099Welcome to pwntools Discussions!0 comments · 2022-08-22
Latest release
Release 4.15.0 4.15.0 2025-10-12This is the last release supporting Python 2 and Python exploit loop. - Improved libcdb handling of a local libc-database without relying on external services. (@the-soloist) - Cache the output of asm() to speed up subsequent exploit runs. (Disable the cache using context.cache_dir = None) - Improve documentation regarding which ELF functions run the binary internally. (Thanks to @Hackrrr who made a CTF challenge for it at Compete With Team Europe CTF 2025) Deprecations Removal of some CLI command scripts Many of the CLI utilities coming with pwntools had ambiguous names and caused