Opentrons Integration
Overview
Create production-minded Python Protocol API v2 protocols for Opentrons Flex and OT-2. This skill covers protocol structure, hardware and deck configuration, liquid handling, runtime customization, module control, simulation, and safe deployment.
The verified baseline as of 2026-07-23 is:
opentrons==9.1.1for reproducible Flex simulation.opentrons==9.0.0for local OT-2 API 2.28 compatibility simulation.- Flex supports API levels 2.15 through 2.29 on current software.
- OT-2 supports API levels 2.0 through 2.28 on current software.
- API 2.29 is Flex-only at this baseline. Do not put
2.29in an OT-2 protocol.
Read references/sources.md for the upstream documentation used for this
snapshot. Recheck the official versioning page before targeting newer robot
software.
Safety Boundary
Opentrons protocols control physical equipment. Never treat successful Python syntax or local simulation as permission to run on a robot.
Before live execution:
- Simulate locally with the same pinned
opentronsversion used for authoring. - Import the protocol into the correct Opentrons App and require successful analysis.
- Verify ro…