Autonomous Debugger system requirements¶
The Autonomous Debugger, included in the Lightrun plugin, has specific system requirements that go beyond the general Lightrun plugin requirements. Ensure your environment meets the following prerequisites before proceeding.
General requirements¶
| Requirement | Details |
|---|---|
| Operating System | - Windows with an Intel x64-compatible CPU - Alpine Linux with an Intel x86-64 - macOS with an Apple Silicon chipset and ARM64 |
| IDE | IntelliJ IDEA |
| Lightrun Plugin | Supported from version 1.59 on demand. - For non-isolated enviroments: The plugin and server must be version 1.59 or later. - For isolated environments: The plugin and server must be on the exact same version to ensure compatibility. Version mismatches will fail the installation and the users will receive an error message in the IDE. Usage of the tool will be blocked. |
| Required Python Versions | 3.9 to 3.12 - For more Python-specific requirements, see Python Requirements. - For isolated environments, see Python requirements for isolated environments. |
Python requirements¶
venv module availability¶
The venv module availability (installed by default) is required to create a lightweight virtual environment for the Autonomous Debugger. It is included by default with most Python installations. However, on Ubuntu, the module needs to be installed manually.
Special case: Install the venv module on Ubuntu¶
On Ubuntu, the venv module must be explicitly installed.
To check if the venv module is installed, run:
<path to python> -m venv env
What to expect:
- If venv is installed: The
<env>directory will be created. Note that the<env>folder can be deleted, as it was created for validation purposes only.
- If
venvis not installed: You will see an error similar to:The virtual environment was not created successfully because the ensurepip module is not available.
To install the venv module (based on your Python version), run:
sudo apt update
sudo apt install python<version>-venv
Python requirements for isolated environments¶
The ensurepip package must be installed. It enables bootstrapping the pip installer into an existing Python installation or virtual environment.
The ensurepip package version 20.3 or higher must be installed when installing Python in an isolated environment. This version controls the default pip version installed in virtual environments.
To check the installed ensurepip version, run this command in your terminal or command prompt:
<path to python> -m ensurepip --version
Note that if you encounter an issue with ensurepip, proceed to install and set Python 3.11 for the Autonomous Debugger. If this fails, contact Lightrun Support.