Installation

General Requirements

LabOne Q requires Python 3.7 or higher. We recommend to use Anaconda. To ease the maintenance of multiple installations and software packages, it is recommended to use Python environments through e.g. venv, pipenv, or conda.

It is recommended to use Python 3.9+, as Python 3.7 and 3.8 support is deprecated and will be removed in the future LabOne Q releases.

LabOne Q also requires an installation of the Zurich Instruments LabOne Software. LabOne and LabOne Q follow a frequent release cycle with updates and new features. LabOne Q always supports the current LabOne release. Changes to this are mentioned in the release notes.

Latest Release

The following command will make the latest officially released LabOne Q version available in your current Python environment. Use pip3 and python3 with your corresponding python version.

pip install --upgrade laboneq

To run LabOne Q on real hardware, an access token is required during an initial, managed beta phase. Please visit https://www.zhinst.com/ch/en/install-labone-q-today to get the access token.

Setup for Development

A development setup is only needed if you need deeper insights into the software or when you want to contribute to the development. The LabOne Q repository is found here: https://github.com/zhinst/laboneq

git clone git@github.com:zhinst/laboneq.git <YOUR_DIR>
cd <YOUR_DIR>

Use your favorite shell to configure a virtual Python environment. With conda you can create and activate your virtual environment.

conda create -n laboneq anaconda
conda activate laboneq

Then make the Python package available as editable installations in-place (from repository root directory).

pip3 install -r requirements-dev.txt
pip3 install -e .

With this approach, Python code can be edited and executed in the source directories with your favorite IDE.