Lightrun Python agent system requirements🔗
The following page describes the IDE and operating system requirements for running the Lightrun Python agent.
Python agent version and architecture requirements
Python 3.12 requires Lightrun Python agent version 1.96 or later. Python 3.13 requires Lightrun Python agent version 1.97 or later. Linux on ARM64, including Alpine Linux and AWS Lambda, requires Lightrun Python agent version 1.98 or later.
Unsupported Python 3.13 builds
Lightrun supports standard GIL-enabled CPython 3.13. Free-threaded Python 3.13 (3.13t) and experimental JIT-enabled Python 3.13 builds are not supported.
Supported operating systems🔗
| OS | Requirements |
|---|---|
| Linux | - Python versions 3.10, 3.11, 3.12, and 3.13 - Alpine Linux: Supported architecture: x86-64, ARM64; Supported versions 3.22, 3.23, and 3.24 (libstdc++ is required to use Lightrun in Alpine Linux) - Ubuntu LTS: Supported architecture: x86-64, ARM64; Supported versions 20.04, 22.04, 24.04, and 26.04. (Linux with GLIBC_2.29 and GLIBCXX_3.4.19 or later) - CentOS versions 7, 8, and 9 versions (Linux with GLIBC_2.29 and GLIBCXX_3.4.19 or later) |
| Windows OS | - Python versions 3.10, 3.11, 3.12, and 3.13 - Supported architecture: x86-64; Windows Server versions 2016 (limited), 2019, and 2022 |
| macOS | - Python versions 3.10, 3.11, 3.12, and 3.13 - macOS: Supported architecture: ARM64; Supported versions 14 and higher for Apple Chipset-based MACs. |
| AWS Lambda | Python versions 3.10, 3.11, 3.12, and 3.13 on x86-64 and ARM64 |
Lightrun IDE Plugins🔗
- VS Code (Versions 1.82 and later).
- IntelliJ IDEA and PyCharm (versions 2024.2 through 2026.2.3).
To verify whether your version of the Lightrun plugin is supported for a given IDE version, refer to the Lightrun version compatibility page. - VSCode.dev.
Last update: November 8, 2026