A comand line tool to obfuscate python scripts


Keywords
protect, obfuscate, encrypt, obfuscation, distribute, obfuscate-scripts, python, python-script
License
SGI-B-2.0
Install
pip install pyarmor.cli==8.1.6

Documentation

Pyarmor

Pyarmor is a command-line tool designed for obfuscating Python scripts, binding obfuscated scripts to specific machines, and setting expiration dates for obfuscated scripts.

Key Features

  • Seamless Replacement: Obfuscated scripts remain as standard .py files, allowing them to seamlessly replace the original Python scripts in most cases.
  • Balanced Obfuscation: Offers multiple ways to obfuscate scripts to balance security and performance.
  • Irreversible Obfuscation: Renames functions, methods, classes, variables, and arguments.
  • C Function Conversion: Converts some Python functions to C functions and compiles them into machine instructions using high optimization options for irreversible obfuscation.
  • Script Binding: Binds obfuscated scripts to specific machines or sets expiration dates for obfuscated scripts.
  • Themida Protection: Protects obfuscated scripts using Themida (Windows only).

Supported Platforms

  • Python 2 and Python 31
  • Windows
  • Various Linux distributions, including embedded systems and Raspberry Pi
  • Apple Intel and Apple Silicon
  • Supported architectures: x86_64, aarch64, armv7, etc.2

For more information, check out the Pyarmor Environments.

Quick start

  1. Install Pyarmor:
pip install pyarmor
  1. Obfuscate the foo.py script:
pyarmor gen foo.py

This command generates an obfuscated script like this at dist/foo.py:

from pyarmor_runtime import __pyarmor__
__pyarmor__(__name__, __file__, b'\x28\x83\x20\x58....')
  1. Run the obfuscated script:
python dist/foo.py

For more information, check out the getting started tutorial.

License

Pyarmor is published as shareware. The free trial version never expires, but has some limitations.

Refer to Pyarmor licenses for information on license types, features, limitations, and purchasing a Pyarmor license.

Please read the Pyarmor EULA.

Getting Help

  1. Consult the Pyarmor Documentation.
  2. Check the FAQ for answers to common questions.
  3. Try the documentation index or the detailed table of contents.
  4. If you still can't find the information you need, see asking questions on GitHub.
  5. Report bugs following the issue template.
  6. For business and security inquiries, send an email to pyarmor@163.com.

There are also some third-party learn platforms (not Pyarmor offical)

Resources

中文资源

Changelog

Each major version comes with a separate changelog file, detailing fixed issues, new features, and compatibility issues between different versions.

Make sure to read the changelog carefully before upgrading Pyarmor:

Full changelogs at releases

Upcoming features at Pyarmor Release Plan

Footnotes

  1. Some features may be exclusive to Python 3.

  2. Some features may be exclusive to specific architectures.