Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Other skills

opentrons-heater-shaker

Opentrons Heater-Shaker Module - temperature control (37-95°C) with orbital mixing (200-3000 rpm) for cell culture, enzymatic reactions, and sample preparation requiring simultaneous heating and agitation

jkitchin · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add jkitchin/knowhow --skill opentrons-heater-shaker

About this skill


name: opentrons-heater-shaker description: Opentrons Heater-Shaker Module - temperature control (37-95°C) with orbital mixing (200-3000 rpm) for cell culture, enzymatic reactions, and sample preparation requiring simultaneous heating and agitation allowed-tools: ["*"]

Opentrons Heater-Shaker Module

Overview

The Heater-Shaker Module combines precise temperature control (37-95°C) with orbital shaking (200-3000 rpm) for automated protocols requiring simultaneous heating and mixing. Ideal for cell culture incubation, enzymatic reactions, bacterial transformations, and any workflow needing temperature-controlled agitation.

Core value: Automate temperature-sensitive mixing protocols with reproducible timing and conditions. Replace manual incubator transfers with on-deck temperature control.

When to Use

Use the Heater-Shaker skill when:

  • Performing enzymatic reactions requiring temperature control and mixing
  • Incubating cell cultures or bacterial transformations
  • Conducting ELISA washing steps with temperature control
  • Running temperature-sensitive binding or hybridization reactions
  • Protocols requiring precise timing of heating + mixing cycles
  • Resuspending beads or particles with controlled agitation

Don't use when:

  • Only temperature control needed (use Temperature Module instead)
  • Only mixing needed (consider manual shaking or alternative approaches)
  • Temperature outside 37-95°C range (or <1.5°C above ambient)

Quick Reference

OperationMethodKey Parameters
Load moduleprotocol.load_module()"heaterShakerModuleV1", location
Set temperature (blocking)set_and_wait_for_temperature()celsius (37-95)
Set temperature (non-blocking)set_target_temperature()celsius
Wait for temperaturewait_for_temperature()-
Start shaking (blocking)set_and_wait_for_shake_speed()rpm (200-3000)
Stop shakingdeactivate_shaker()-
Stop heatingdeactivate_heater()-
Open latchopen_labware_latch()-
Close latchclose_labware_latch()-
Check status.current_temperature, .current_speed-

Platform Compatibility

Opentrons Flex

  • Allowed slots: Column 1 or Column 3 (A1, B1, C1, D1, A3, B3, C3, D3)
  • No adjacent restrictions - Full deck flexibility

OT-2

  • Allowed slots: 1, 3, 4, 6, 7, or 10
  • Adjacent slot restrictions:
    • Keep adjacent slots clear or use only low-profile labware (<53mm height)
    • 8-channel pipettes cannot pipette in adjacent slots (tip racks OK if front/back)

Loading the Module

Basic Loading

from opentrons import protocol_api

metadata = {'apiLevel': '2.19'}

def run(protocol: protocol_api.ProtocolContext):
    # Load Heater-Shaker in deck slot
    hs_mod = protocol.load_module("heaterShakerModuleV1", location="D1")  # Flex
    # hs_mod = protocol.load_module("heaterShakerModuleV1", location="1")  # OT-2

Loading Labware with Adapters

Two-step approach (recommended):

# Load adapter first, then labware
hs_adapter = hs_mod.load_adapter("opentrons_96_flat_bottom_adapter")
hs_plate = hs_adapter.load_labware("nest_96_wellplate_200ul_flat")

Available adapters:

  • opentrons_96_flat_bottom_adapter - Universal flat-bottom plates
  • opentrons_96_pcr_adapter - PCR plates and strips
  • opentrons_96_deep_well_adapter - Deep-well plates
  • opentrons_universal_flat_adapter - Custom flat-bottom labware

Pre-configured combinations (legacy):

# Load labware directly (adapter implicit)
hs_plate = hs_mod.load_labware("nest_96_wellplate_200ul_flat")

Latch Control

The labware latch MUST be closed for shaking operations.

# Close latch before shaking
hs_mod.close_labware_latch()

# Open latch for pipetting or gripper access
hs_mod.open_labware_latch()

Important:

  • Pipetting is possible with latch open or closed
  • Shaking requires latch closed (method will error if open)
  • Gripper access requires latch open
  • Always open latch before gripper operations

Temperature Control

Blocking Temperature Control

Protocol waits until temperature is reached before continuing:

# Set temperature and wait
hs_mod.set_and_wait_for_temperature(celsius=37)

# Perform operations at target temperature
protocol.delay(minutes=10)

# Turn off heater
hs_mod.deactivate_heater()

Temperature range:

  • Minimum: The greater of 37°C or ambient temperature + 1.5°C (the Heater-Shaker cannot actively cool)
  • Maximum: 95°C
  • Resolution: 1°C

Non-Blocking Temperature Control

Set target temperature and continue with other operations while heating:

# Start heating (non-blocking)
hs_mod.set_target_temperature(celsius=75)

# Perform pipetting while heating
pipette.transfer(100, source, hs_plate.columns()[0])

# Wait for temperature before critical step
hs_mod.wait_for_temperature()

# Now at target temperature
protocol.delay(minutes=5)

Use case: Parallel pipetting during heating to save time.

Checking Temperature Status

# Get current temperature
current_temp = hs_mod.current_temperature

# Log temperature
protocol.comment(f"Heater-Shaker at {current_temp}°C")

Shaking Control

Basic Shaking

# Close latch first (required)
hs_mod.close_labware_latch()

# Start shaking and wait to reach speed
hs_mod.set_and_wait_for_shake_speed(rpm=500)

# Shake for specific duration
protocol.delay(minutes=5)

# Stop shaking
hs_mod.deactivate_shaker()

# Open latch for pipetting access
hs_mod.open_labware_latch()

Speed range:

  • Minimum: 200 rpm
  • Maximum: 3000 rpm

Checking Shake Speed

# Get current speed
current_speed = hs_mod.current_speed

if current_speed > 0:
    protocol.comment(f"Shaking at {current_speed} rpm")

Shake Speed Guidelines

Recommended speeds by application:

  • Gentle mixing: 200-500 r
Read the complete source ↗