Skip to content

pyREtic is an extensible framework for in-memory Python 2.x bytecode reverse engineering


Notifications You must be signed in to change notification settings


Repository files navigation

pyREtic 0.5.1 README

Rich Smith -

Latest version of pyREtic can be found at:

What is it ?

pyREtic is an extensible framework to assist in performing various reverse engineering tasks for Python language projects.

It assists a reverse engineer in gaining sourcecode (.py's) back from bytecode (.pyc's), in particular it assists when the code that is being reversed has put some effort into trying to stop decompilation using standard toolsets.

It consists of 3 main parts:

  • REpdb : A RE centric superset of the pdb functionality to allow the easy interaction by a reverser to the code they are reversing.

  • OpcodeRemap : The component that is able to deduce a new opcode table from a Python runtime that has changed its opcode layout in order to confuse many standard Python decompilers.

  • LiveUnpyc : An extension to Dmitri Kornev's UnPyc decompiler project which allows live Python objects in memory to be decompiled back to Python sourcecode via 3 different methods.

The capabilities within the pyREtic toolkit were written to be effective against the protections that a majority of closed source Python developers were using to protect the code they were distributing from being read in its source form.

The output from pyREtic was to produce a source code representation of an object to which you could gain access to in a running instance of the target application. This representation only needed to be good enough to be able to assess the security of the target application rather than being absolutely perfect copy.


A detailed howto document can be found in the docs/ directory.


pyREtic is released under the GPLv3 which can be found in the docs/ directory or GPLv3.

Other components which pyREtic uses are released under their own licenses:

UnPyc : BSD License
pycallgraph GPLv2


pyREtic began life when I worked at Immunity Inc, and was first publicly presented at the BlackHat 2010 conference in Las Vegas, and then at Defcon 17. A paper that accompanied its release can be found in the docs/ dir

I am now no longer employed by Immunity but Dave Aitel was kind enough to allow me to release the code under the GPL to allow people to access it and allow its development to continue.

The latest version of the framework can be found at

I recently moved the project to a new home on GitHub due to renewed interest from some in the community and will be releasing some enhancements that until now never saw the light of day.


The features that will be added to pyREtic in future will reflect the development of my needs for dealing with reversing Python applications moving forward. If you have suggestions however let me know.

##Technical Details For those interested more of the technicalities of how pyREtic does things can be found in the paper pyREtic: In memory reverse engineering for obfuscated Python bytecode which is in the docs/ directory, and a presentation discussing it can be found at :


pyREtic is an extensible framework for in-memory Python 2.x bytecode reverse engineering







No releases published


No packages published