Skip to content

Installation guide

First make sure you have a working installation of Python. If you have never worked with Python before, we recommend installing Miniconda alongside the Visual Studio Code text editor. After selecting Miniconda as the Python interpreter in VS Code, you may now install OpenTerrace using pip:

Install using pip

pip install openterrace

Install in editable mode

  1. If you plan on extending or modifying OpenTerrace, you should install it in editable mode. First, use any git client such as GitHub Desktop to clone the OpenTerrace repository

  2. Next, I recommend using Linux or WSL (if on Windows). Inside a linux terminal do: 

    mkdir -p ~/miniconda3
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda3/miniconda.sh
bash ~/miniconda3/miniconda.sh -b -u -p ~/miniconda3
rm -rf ~/miniconda3/miniconda.sh

  3. Then, initialise your conda environment: 

    ~/miniconda3/bin/conda init bash

  4. Now, reopen your terminal and create a virtual environment called ot: 

    conda create -n ot python=3.11.8 pip

  5. Then activate it: 

    conda activate ot

  6. Verify that the right pip version is picked up: 

    which pip
    which should give you something like /home/[username]/miniconda3/envs/ot/bin/pip

  7. Finally, install OpenTerrace inside our virtual environment by navigating to the "openterrace-python" folder and install in editable mode by: 

    pip install --editable .

  8. Verify that the ot virtual environment is picked up as the interpreter in VS Code.

  9. Now you are ready to run tutorials and modify and extend OpenTerrace as you like.