Automation
opentrons-integration avatar

opentrons-integration

Official Opentrons Protocol API for OT-2 and Flex robots. Create, simulate, and execute lab automation protocols including liquid handling and hardware module control.

Introduction

The Opentrons Integration skill provides a comprehensive environment for researchers and lab automation engineers to develop Python-based protocols for Opentrons OT-2 and Flex robotic platforms. This skill centers on the Protocol API v2, allowing users to automate precise liquid handling workflows such as serial dilutions, PCR plate preparation, and complex reagent transfers. It is designed for laboratory environments requiring high-throughput screening, sample preparation, or automated assays. Users can manage hardware configurations, including pipette mounts, labware layouts, and specialized modules such as the Temperature Module, Magnetic Module, Heater-Shaker, and Thermocycler, ensuring full reproducibility in experimental protocols.

  • Full support for Opentrons Protocol API v2 syntax and metadata structure.

  • Capabilities for defining deck layouts, including slot management for plates, reservoirs, and custom labware.

  • Fine-grained control over liquid handling parameters: aspiration/dispensing volumes, flow rates, air gaps, blowout, and touch-tip functions.

  • Support for multi-channel pipettes and 96-well plate operations to maximize experimental throughput.

  • Integration with core hardware modules: heater-shaker, thermocycler, and magnetic modules for advanced chemical and biological workflows.

  • Standardized protocol metadata (author, description, apiLevel) to ensure compatibility with robot fleet management.

  • Always define the API version in the metadata to ensure compatibility with the target robot's firmware version.

  • Protocol logic must be encapsulated within the run(protocol: protocol_api.ProtocolContext) function to be valid for execution.

  • Utilize specific naming conventions for instruments (e.g., p1000_single_flex) and labware (e.g., corning_96_wellplate_360ul_flat) as defined by the Opentrons API.

  • The skill is intended strictly for Opentrons ecosystem hardware; for multi-vendor lab automation needs, consider alternative frameworks like PyLabRobot.

  • Ensure all tip management and labware loading steps are explicitly defined to prevent hardware collisions during simulation and physical execution.

Repository Stats

Stars
19,718
Forks
2,198
Open Issues
42
Language
Python
Default Branch
main
Sync Status
Idle
Last Synced
Apr 29, 2026, 01:04 PM
View on GitHub
opentrons-integration | Skills Hub