Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Tool:PyLingual

From ReverseEngineering.wiki
Tool
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 with transformers ... from_pretrained and huggingface_hub.hf_hub_download, so the models come from the Hugging Face hub (a pinned REVISION for the translation model). The README gives no download size and no offline instructions; Unverified: size and fully offline use.

Sources

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