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.

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

  1. Opentrons Logo Protocol (tutorial below)
  2. Customizable serial dilution for the OT-2

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.

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


  1. 96-well plate
  2. 12-row trough
  3. GEB 300 uL tips 
  4. Single channel pipette 



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 wifi or usb 

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

Continue to the calibration screen by either clicking the calibrate tab or the calibrate word under the check mark. 


Let's begin with pipette calibration.

Click on the right pipette to begin calibration. All labware must be removed when you are calibrating the pipettes. Confirm the trash has been removed. 

The robot will home and come to deck slot 2. Confirm a tip has been attached. 

The pipette will now begin the tip probe process. 

Note: During this process please be advised to not touch/move the pipette or the robot in any way. Doing so will cause the robot to save bad/incorrect data which will affect all calibrations during the run.

Once the pipette has been calibrated, take off the tip and discard. Pipette calibration is now complete!

Now, let's move onto labware calibration. Place the labware  onto the deck. 

In this protocol there are the following labware: 

  • P300 single channel - right axis 
  • Tip-rack 200uL - slot 1
  • 96-flat - slot 2
  • Trough- 12 row - slot 5

Begin calibrating your labware by clicking Continue Moving To Tiprack . The gantry will move to the A1  position in the tiprack. 

If need be use the jog key and the increment buttons to center and flush the pipette to the top of the A1 tip. Once you are happy with the position click Pick Up Tip

The robot will attempt to pick up the tip. If the tip pick up was successful click Yes, Save Calibration . If it was not successful, click No,Try Again  and follow the previous step. 

Continue moving to the rest of the labware using the Move To Next Labware button. Make sure the pipette is flushed and centered with the A1 position in each labware. 

Run Protocol 

Once all the labware has been calibrated, click Return Tip And Proceed To Run. This will take you to the run screen tab of the app. Click start run . A timer will start along with the command lines from your protocol. 

Notice, you can Pause  and Cancel Job   at anytime. 

Did this answer your question?