Repository files navigation

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

• 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).

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

For more information, check out thePyarmor Environments.

1. Install Pyarmor:

pip install pyarmor

2. Obfuscate thefoo.py script:

pyarmor gen foo.py

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

frompyarmor_runtimeimport__pyarmor____pyarmor__(__name__,__file__,b'\x28\x83\x20\x58....')

3. Run the obfuscated script:

python dist/foo.py

For more information, check out thegetting started tutorial.

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

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

Please read thePyarmor EULA.

• Ask in learning system orlook through check list
• Consult thePyarmor Documentation.
• Check theFAQ for answers to common questions.
• Try the documentationindex or thedetailed table of contents.
• If you still can't find the information you need, seeasking questions on GitHub.
• Report bugs following the issue template.
• For business and security inquiries, send an email topyarmor@163.com.

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

• Ask Pyarmor Guru, it is a Pyarmor-focused AI to answer your questions

• Website
• Documentation
• Documentation 8.x
• Documentation 7.x
• Pyarmor 9.1 new features
• Pyarmor Learning System

中文资源

• Pyarmor 网站
• Pyarmor 在线文档
• Pyarmor 8.x 在线文档
• Pyarmor 7.x 在线文档
• Pyarmor 9.1 新功能
• Pyarmor 学习系统

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:

• Pyarmor 8.x Changelog
• Pyarmor 9.x Changelog

Full changelogs atreleases

Upcoming features atPyarmor Release Plan