Skip to main content

Protect your python script, encrypt it as .pye and decrypt when import it

Project description

Travis AppVeyor PyPI Version PyPI PyVersion PyPI License

Protect your python script, encrypt .pyc to .pye and decrypt when import it

Protect python script work flow

  • import pyconcrete
  • pyconcrete will hook import module
  • when your script do import MODULE, pyconcrete import hook will try to find MODULE.pye first and then decrypt MODULE.pye via _pyconcrete.pyd and execute decrypted data (as .pyc content)
  • encrypt & decrypt secret key record in _pyconcrete.pyd (like DLL or SO) the secret key would be hide in binary code, can’t see it directly in HEX view


  • only support AES 128 bit now
  • encrypt & decrypt by library OpenAES


  • need to input your passphrase create secret key for encrypt python script.
  • same passphrase will generate the same secret key
  • installation will add pyconcrete.pth into your site-packages for execute under pyconcrete which will automatic import pyconcrete


$ pip install pyconcrete

If you only execute ``pip install`` will not display any prompt(via
stdout) from pyconcrete. Installation will be ``blocked`` and
``waiting for user input passphrase twice``. You must input
passphrase for installation continuously.
$ pip install pyconcrete --egg --install-option="--passphrase=<your passphrase>"

pyconcrete installed as egg, if you want to uninstall pyconcrete
will need to manually delete ``pyconcrete.pth``.


  • get the pyconcrete source code

    $ git clone <pyconcrete repo> <pyconcre dir>
  • install pyconcrete

    $ python install


Full encrypted

  • convert all of your .py to *.pye

    $ compile --source=<your py script>  --pye
    $ compile --source=<your py module dir> --pye
  • remove *.py *.pyc or copy *.pye to other folder

  • encrypted as main.pye, it can’t be executed by normal python. You must use pyconcrete to process the main.pye script. pyconcrete(exe) will be installed in your system path (ex: /usr/local/bin)

pyconcrete main.pye
src/*.pye  # your libs

Partial encrypted (pyconcrete as lib)

  • download pyconcrete source and install by

    $ python install \
      --install-lib=<your project path> \
      --install-scripts=<where you want to execute and pyconcrete(exe)>
  • import pyconcrete in your main script

  • recommendation project layout       # import pyconcrete and your lib
    pyconcrete/*  # put pyconcrete lib in project root, keep it as original files
    src/*.pye     # your libs


  • test all case

    $ ./ test
  • test all case, setup TEST_PYE_PERFORMANCE_COUNT env to reduce testing time


Building on Windows

Python 2.7 - Visual Studio 2008

  • Open VS2008 Command Prompt


  • set SET MSSdk=1

  • create distutils.cfg and put inside


Python 3.5, 3.6 - Visual Studio 2015

MSVC 2015 Build Tools


  • make sure setuptools >= 24.0

    python -c 'import setuptools; print(setuptools.__version__)'
  • Open VS2015 Build Tools Command Prompt


  • setenv /x64 /release or setenv /x86 /release


pyconcrete is an experimental project, there is always a way to decrypt .pye files, but pyconcrete just make it harder.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pyconcrete, version 0.11.3
Filename, size File type Python version Upload date Hashes
Filename, size pyconcrete-0.11.3.tar.gz (44.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page