Installation

Basic Installation

BESSER is tested on Python 3.10, 3.11, and 3.12. We recommend creating a virtual environment (e.g. venv, conda).

Warning

Python 3.13 is not supported yet because some dependencies have not released compatible wheels. Please use Python 3.10 or 3.12 for now.

The latest stable version of BESSER is available in the Python Package Index (PyPi) and can be installed using

$ pip install besser

BESSER can be used with any of the popular IDEs for Python development such as VScode, PyCharm, Sublime Text, etc.

VSCode

Running BESSER Locally

If you are interested in developing new code generators or designing BESSER extensions, you can download and modify the full codebase, including tests and examples.

Step 1: Clone the repository

$ git clone https://github.com/BESSER-PEARL/BESSER.git
$ cd BESSER

Step 2: Create a virtual environment

Run the setup script to create a virtual environment (if not already created), install the requirements, and configure the PYTHONPATH. This ensures compatibility with IDEs (like VSCode) that may not automatically set the PYTHONPATH for recognizing besser as an importable module.

$ python -m venv venv
$ venv\Scripts\activate
$ source venv/bin/activate  # Linux / macOS
$ pip install -r requirements.txt

Note

Each time you start your IDE, activate the virtual environment to ensure the environment is properly configured.

Step 3: Run an example

To verify the setup, you can run a basic example.

$ cd tests/BUML/metamodel/structural/library
$ python library.py

For common installation issues, see Troubleshooting.