Installation#

These instructions describe how to install PyLabRobot.

Note that there are additional installation steps for using the firmware (universal) interface to Hamiltons and Tecans, see below.

Installing PyLabRobot#

It is highly recommended that you install PyLabRobot in a virtual environment. virtualenv is a popular tool for doing that, but you can use any tool you like. Note that virtualenv needs to be installed separately first.

Here’s how to create a virtual environment using virtualenv:

mkdir your_project
cd your_project
python -m virtualenv env
source env/bin/activate

From source#

Alternatively, you can install PyLabRobot from source. This is particularly useful if you want to contribute to the project.

git clone https://github.com/pylabrobot/pylabrobot.git
cd pylabrobot
pip install -e '.[dev]'

See CONTRIBUTING.md for specific instructions on testing, documentation and development.

Using the firmware interface with Hamilton or Tecan robots#

If you want to use the firmware version of the Hamilton or Tecan interfaces, you need to install a backend for PyUSB. You can find the official installation instructions here. The following is a complete (and probably easier) guide for macOS, Linux and Windows.

Reminder: when you are using the firmware version, make sure to install the firmware dependencies as follows:

pip install pylabrobot[fw]

On Linux#

You should be all set!

On Mac#

You need to install libusb. You can do this using Homebrew:

brew install libusb

On Windows#

Installing#

  1. Download and install Zadig.

  2. Make sure the Hamilton is connected using the USB cable and that no other Hamilton/VENUS software is running.

  3. Open Zadig and select “Options” -> “List All Devices”.

  1. Select “ML Star” from the list if you’re using a Hamilton STAR or STARlet. If you’re using a Tecan robot, select “TECU”.

  1. Select “libusbK” using the arrow buttons.

  1. Click “Replace Driver”.

  1. Click “Close” to finish.

Uninstalling#

These instructions only apply if you are using VENUS on your computer!

If you ever wish to switch back from firmware command to use pyhamilton or plain VENUS, you have to replace the updated driver with the original Hamilton or Tecan one.

  1. This guide is only relevant if ML Star is listed under libusbK USB Devices in the Device Manager program.

  1. If that”s the case, double click “ML Star” (or similar) to open this dialog, then click “Driver”.

  1. Click “Update Driver”.

  1. Select “Browse my computer for driver software”.

  1. Select “Let me pick from a list of device drivers on my computer”.

  1. Select “Microlab STAR” and click “Next”.

  1. Click “Close” to finish.

Troubleshooting#

If you get a usb.core.NoBackendError: No backend available error: this may be helpful.

If you are still having trouble, please reach out on the forum.