uncompyle -- A Python 2.7 byte-code decompiler
0.12 2012-1-23


'uncompyle' converts Python byte-code back into equivalent Python source. It accepts byte-code from Python version 2.7 only.

The generated source is very readable: docstrings, lists, tuples and hashes get pretty-printed.

'uncompyle' may also verify the equivalence of the generated source by by compiling it and comparing both byte-codes.

'uncompyle' is based on John Aycock's generic small languages compiler 'spark' (http://www.csr.uvic.ca/~aycock/python/) and his prior work on 'decompyle'.

Additional note (3 July 2004, Ben Burton):

The original website from which this software was obtained is no longer available. It has now become a commercial decompilation service, with no software available for download.

Any developers seeking to make alterations or enhancements to this code should therefore consider these debian packages an appropriate starting point.


  • decompiles Python byte-code into equivalent Python source
  • decompiles byte-code from Python version 2.7
  • pretty-prints docstrings, hashes, lists and tuples
  • reads directly from .pyc/.pyo files, bulk-decompile whole directories
  • output may be written to file, a directory or to stdout
  • option for including byte-code disassembly into generated source

For a list of changes please refer to the 'CHANGES' file.


'decompile' requires Python 2.2 or later.


You may either create a RPM and install this, or install directly from the source distribution.

Creating RPMS:

python setup.py bdist_rpm

If you need to force the python interpreter to eg. pyton2:
python2 setup.py bdist_rpm --python=python2

Installation from the source distribution:

python setup.py install
To install to a user's home-dir:
python setup.py install --home=<dir>
To install to another prefix (eg. /usr/local)
python setup.py install --prefix=/usr/local
If you need to force the python interpreter to eg. pyton2:
python2 setup.py install
For more information on 'Installing Python Modules' please refer to


uncompyler -h prints short usage uncompyler --help prints long usage

Known Bugs/Restrictions