Installation

General Requirements

LabOne Q requires Python 3.9 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.

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 most recent LabOne release and currently requires LabOne version 24.01 or higher. 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.

pip3 install --upgrade laboneq

Note

During the initial, managed beta phase, LabOn Q required an access token to run on real hardware. No token is required from release 2.9 and newer. However, you are welcome to contact us at info@zhinst.com anytime if you need assistance.

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.