Welcome to the Python API

Onboarding Protocol Tutorial

Try one of two basic protocols from the Opentrons Protocol Library to get started with your OT-2.

In order to have the best experience with the Python API, we recommend reviewing the below resources to see what has been written already, how to write protocols for yourself, and what resources we have if you would like to request your own protocol:

  1. Protocol Library: If you find a protocol that matches a workflow you would like to use, you can download it and run it as shown below.

  2. If you are familiar with Python and would like to write your own protocol or modify one of ours on Protocol Library, you can read our Python API documentation for examples and learn what each command does.

  3. If you are unfamiliar with Python, but want the capabilities of the Python API, then you can request a custom protocol by using the Opentrons Custom Protocol Development Request Form. Our Applications Engineers will create one for you that is specifically tailored to your workflow needs.

Note: If you have determined the Protocol Designer protocol writing method is better for you, run your first protocol on PD using the Protocol Designer onboarding tutorial. If you intend to write Python code for your future protocols, continue here. Either way, we encourage you to check out the Protocol Designer to see if it meets your protocol requirements or the needs of your other labmates.

If you have determined you will use the Python API, you can get started with these two basic protocols from the Opentrons Protocol Library.

  1. Opentrons Logo Protocol (tutorial below)

  2. OT-2 Guided Walkthrough

Opentrons Logo Protocol tutorial: 

For our first protocol on the OT2, we will be drawing the Opentrons logo on a 96-well plate! 

We will be using two colors, so be sure to find some food dye, or colored liquids you can use. In this tutorial, we’ve chosen to use blue food dye in water, diluted to two different shades. 

The procedure is as follows: 

Upload protocol > Calibrate > Run


First, download the Opentrons Logo protocol based on the pipette you are using for this run. 

Open the OT app, and connect to the robot via Wi-Fi or USB

Once the app has been connected to a robot, click the Protocol tab. Upload the downloaded Opentrons Logo protocol. 

Did this answer your question?