Tool:PyLingual
| Developer | syssec-utd (UT Dallas) |
|---|---|
| License | GPL-3.0 |
| Website | https://github.com/syssec-utd/pylingual |
| On this wiki | Facts · Code · Notes · Topics |
PyLingual is a research CPython bytecode decompiler (GPL-3.0) for all released Python versions since 3.6, using translation models plus control-flow segmentation; also offered as a web service.
Overview
Its README describes a decompiler supporting all released Python versions since 3.6, runnable through a web service (pylingual.io) or locally; the local codebase is optimised for readability and may be less accurate in control flow than the hosted service. The design is described in an IEEE S&P 2025 paper linked from the README.
Setup
Install with uv tool install ./pylingual after cloning. It needs the target Python version to compile and verify its output: uv managed interpreters for 3.8 to 3.15, and pyenv (pyenv-win on Windows) for 3.6 and 3.7. An optional Redis cache reuses model predictions.
Choosing it
See Technique:Choosing a decompiler. It covers the 3.9 to 3.13 range where the Python-based tools stop at 3.8.
Caveats
- Hosted use uploads the sample to a third party; the README links the web service pylingual.io but states no privacy terms, so assume the file leaves your machine and use the local install for sensitive files.
pylingual/models.py(commit 509ea92e560b2c2c99b0c9901bd33e404fbfb4b8, lines 153-186) loads the segmentation and translation models withtransformers ... from_pretrainedandhuggingface_hub.hf_hub_download, so the models come from the Hugging Face hub (a pinnedREVISIONfor the translation model). The README gives no download size and no offline instructions; Unverified: size and fully offline use.
Sources
- README of https://github.com/syssec-utd/pylingual.
Code & repositories
- https://github.com/syssec-utd/pylingual @
509ea92e560b2c2c99b0c9901bd33e404fbfb4b8· license: GPL-3.0-only (declared by the contributor; GitHub's detector did not recognize LICENSE)
PyLingual, CPython 3.6+ bytecode decompiler
Tested on: source read, not run: not run; README read · checked 2026-10-18