mirror of
https://github.com/syssec-utd/pylingual.git
synced 2026-05-10 18:39:03 -07:00
Josh Wiedemeier
56 lines
2.3 KiB
Markdown
56 lines
2.3 KiB
Markdown
# PyLingual - Python Decompiler for 3.6+
|
|
|
|
PyLingual is a CPython bytecode decompiler supporting all released Python versions since 3.6. For information about the design and implementation of PyLingual, please refer to our [research paper](https://www.computer.org/csdl/proceedings-article/sp/2025/223600a052/21B7QZB86cg).
|
|
|
|
PyLingual can be run through our [web service](https://pylingual.io) or run locally.
|
|
|
|
This codebase is optimized for readability and future extension, so there may initially be some control flow accuracy regression compared to the version hosted on the web service.
|
|
|
|
## Requirements
|
|
|
|
- `uv` Python package manager ([installation](https://docs.astral.sh/uv/getting-started/installation/)), used for project dependencies and managed Python versions.
|
|
|
|
### Decompiling End-Of-Life Python Versions
|
|
|
|
To verify decompilation correctness and produce model training sets, PyLingual requires the ability to compile Python in the target version.
|
|
|
|
For current Python versions (3.8-3.14), PyLingual uses `uv`'s managed installations, but for Python 3.6 and 3.7, PyLingual uses [pyenv](https://github.com/pyenv/pyenv) ([pyenv-win](https://github.com/pyenv-win/pyenv-win) for Windows).
|
|
|
|
## Setup
|
|
|
|
Install from source, using [uv](https://docs.astral.sh/uv/):
|
|
|
|
```sh
|
|
git clone https://github.com/syssec-utd/pylingual
|
|
uv tool install ./pylingual
|
|
```
|
|
|
|
## Usage
|
|
|
|
```
|
|
Usage: pylingual [OPTIONS] [FILES]...
|
|
|
|
End to end pipeline to decompile Python bytecode into source code.
|
|
|
|
Options:
|
|
-o, --out-dir PATH The directory to export results to.
|
|
-c, --config-file PATH Config file for model information.
|
|
-v, --version VERSION Python version of the .pyc, default is auto
|
|
detection.
|
|
-k, --top-k INT Maximum number of additional segmentations to
|
|
consider.
|
|
-q, --quiet Suppress console output.
|
|
--trust-lnotab Use the lnotab for segmentation instead of the
|
|
segmentation model.
|
|
--init-pyenv Install pyenv before decompiling.
|
|
-h, --help Show this message and exit.
|
|
```
|
|
|
|
## Demo
|
|
|
|
|
|
|
|
## Support
|
|
|
|
If you have any issues for installing and using PyLingual, please create an issue or send your message via our support email at pylingual.io@gmail.com.
|