pwninit

Tests Status

A Python toolkit for CTF binary exploitation. Streamline setup, development, and execution of exploits with automated binary analysis, library management, and template generation.

📖 Full documentation: pwninit.0xb0tm4n.org

Installation

pip install pwninit.py

Basic Usage Example

Setup the chall:

$ pwninit

Edit exploit.py:

from pwninit import *

Config(
    binary="./chall",
    libc="./libc.so.6"
)


def setup(args: Args, config: Config):
    open("flag.txt", "w").write('flag{hello}')


def exploit(ctx: PwnContext, io: IOContext):
    exe = ctx.elf
    libc = ctx.libc

    ctx.offset = 128
    sl(ret2win('shell', ret=False))
    itrv()

Run the exploit:

$ run

Metadata

Release files for pwninit.py 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pwninit.py 0.1.6
File	Size	Uploaded
pwninit_py-0.1.6.tar.gz	6.5 MB	Jun 14, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for pwninit.py 0.1.6
File	Interpreter	ABI	Platform	Reset
pwninit_py-0.1.6-py3-none-any.whl 55.8 kB Jun 14, 2026	Python 3	none	any	Details

Total release size: 6.5 MB

Release files / pwninit_py-0.1.6.tar.gz

Download URL	pwninit_py-0.1.6.tar.gz
Size	6.5 MB
Tags	Source
SHA-256 checksum How to use checksums	`ee232139ec96fa6f35348af55ac45e6e2c60178dcad4ec499e464e96aab57efb`
BLAKE2b-256 checksum How to use checksums	`2576f7447022799b08e9acae94b617cd6144a56321b47804901f50a6d16d8c0a`
Upload date	Jun 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Super-Botman/pwninit.py
Publishing commit: github.com/Super-Botman/pwninit.py/tree/2373844de497d8f279bbe1f3a34b2178032f6485

Workflow

Publishing configuration: github.com/Super-Botman/pwninit.py/blob/2373844de497d8f279bbe1f3a34b2178032f6485/.github/workflows/publish.yml
Publishing logs: github.com/Super-Botman/pwninit.py/actions/runs/27507921041/attempts/1

Artifact

Subject: pwninit_py-0.1.6.tar.gz
SHA-256 checksum: ee232139ec96fa6f35348af55ac45e6e2c60178dcad4ec499e464e96aab57efb Verifying attestations

Release files / pwninit_py-0.1.6-py3-none-any.whl

Download URL	pwninit_py-0.1.6-py3-none-any.whl
Size	55.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`085ca132b712a5c15ceffce81999fd686a3c19d20b22ed51dbcd0a4d9eebb8f3`
BLAKE2b-256 checksum How to use checksums	`ae485b27e045267008059e02454dccc1d9f16c0ff4ebaa55ec2ea048e05458f9`
Upload date	Jun 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Super-Botman/pwninit.py
Publishing commit: github.com/Super-Botman/pwninit.py/tree/2373844de497d8f279bbe1f3a34b2178032f6485

Workflow

Publishing configuration: github.com/Super-Botman/pwninit.py/blob/2373844de497d8f279bbe1f3a34b2178032f6485/.github/workflows/publish.yml
Publishing logs: github.com/Super-Botman/pwninit.py/actions/runs/27507921041/attempts/1

Artifact

Subject: pwninit_py-0.1.6-py3-none-any.whl
SHA-256 checksum: 085ca132b712a5c15ceffce81999fd686a3c19d20b22ed51dbcd0a4d9eebb8f3 Verifying attestations