CTF framework and exploit development library
Python Assembly Shell
Permalink
Failed to load latest commit information.
.github Update ISSUE_TEMPLATE.md Nov 7, 2016
docs Add a bit more documentation to context.rst Jan 23, 2017
examples Fix a lot of documentation (#675) Aug 22, 2016
extra Fix bash completion regression (#772) Oct 18, 2016
pwn Greatly enhance and update the pwnlib.elf module documentation. Jan 7, 2017
pwnlib Convert impossible doctest into a code-block Jan 23, 2017
travis Add pwnlib.protocols module (#860) Jan 20, 2017
.coveragerc Add coveralls.io build steps to .travis.yml (#655) Aug 18, 2016
.gitattributes Hopefully make git language statistics more accurate Dec 18, 2014
.gitignore Revert part of 8793dec, fix commands, remove shippable.yml Sep 26, 2016
.isort.cfg Add config Jun 11, 2015
.sublime-settings Add sublime-settings [skip ci] Oct 25, 2015
.travis.yml Add PR_SET_PTRACER to process and ssh.process (#828) Jan 4, 2017
CHANGELOG.md Update changelog for 3.5.0 Jan 19, 2017
CONTRIBUTING.md Fixed some documentation Aug 21, 2016
LICENSE-pwntools.txt Fix a lot of documentation (#675) Aug 22, 2016
MANIFEST.in Merge pull request #752 from zachriggle/fix-setup Sep 19, 2016
README.md Merge branch 'beta' into dev Jan 12, 2017
TESTING.md fix typo in TESTING.md (#769) Oct 15, 2016
requirements.txt have requirements.txt just 'call' setup.py install_requires so that y… Aug 13, 2014
setup.py fixed RuntimeError in setup.py caused by pandoc on non-amd64 arches (#… Dec 29, 2016
tox.ini Revert part of 8793dec, fix commands, remove shippable.yml Sep 26, 2016

README.md

pwntools - CTF toolkit

pwntools logo

Docs PyPI Travis Coveralls Twitter MIT License

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.

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()

Try It Now!

You can now do a live demo of Pwntools, right in your browser.

Documentation

Our documentation is available at docs.pwntools.com

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 12.04 and 14.04, but most functionality should work on any Posix-like distribution (Debian, Arch, FreeBSD, OSX, etc.). Python 2.7 is required.

Most of the functionality of pwntools is self-contained and Python-only. You should be able to get running quickly with

apt-get update
apt-get install python2.7 python-pip python-dev git libssl-dev libffi-dev build-essential
pip install --upgrade pip
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

If you have any questions not worthy of a bug report, feel free to ping us at #pwntools on Freenode and ask away. Click here to connect. There is also a mailing list for higher latency discussion.