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

opentrons-temperature-module

Opentrons Temperature Module - precise heating and cooling (4-95°C) for sample storage, enzyme reactions, and temperature-sensitive protocols with aluminum block adapters for plates, tubes, and PCR strips

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-temperature-module

About this skill


name: opentrons-temperature-module description: Opentrons Temperature Module - precise heating and cooling (4-95°C) for sample storage, enzyme reactions, and temperature-sensitive protocols with aluminum block adapters for plates, tubes, and PCR strips allowed-tools: ["*"]

Opentrons Temperature Module

Overview

The Opentrons Temperature Module provides precise temperature control (4-95°C) for maintaining samples at specific temperatures during automated protocols. Ideal for keeping reagents cold, pre-warming reaction components, temperature-sensitive incubations, and any workflow requiring stable thermal conditions without mixing.

Core value: Eliminate ice buckets and water baths. Maintain precise, reproducible temperatures on-deck for reagents, samples, and reaction components throughout your protocol.

When to Use

Use the Temperature Module skill when:

  • Keeping reagents cold during protocol (e.g., enzymes at 4°C)
  • Pre-warming reaction components (e.g., buffers at 37°C)
  • Maintaining samples at specific temperatures
  • Temperature-sensitive enzyme reactions without mixing
  • Cooling samples after thermal processing
  • Any protocol requiring stable temperature control (4-95°C)

Don't use when:

  • Need mixing/shaking during temperature control (use Heater-Shaker Module)
  • Require PCR thermal cycling (use Thermocycler Module)
  • Temperature outside 4-95°C range
  • Precise temperature ramping or cycling needed

Quick Reference

OperationMethodKey Parameters
Load moduleprotocol.load_module()"temperature module gen2", location
Set temperatureset_temperature()celsius (4-95)
Get current temperature.temperatureRead-only property
Check status.statusReturns "holding at target" or "idle"
Deactivatedeactivate()-

Platform Compatibility

Both Opentrons Flex and OT-2

Module Generations

  • GEN1 - Original temperature module
  • GEN2 - Improved cooling performance, better isolation (recommended)

Key GEN2 improvements:

  • Plastic insulation around plate
  • Shrouds for aluminum blocks
  • Better cooling when sharing deck with running Thermocycler
  • Same API as GEN1

Loading the Module

from opentrons import protocol_api

metadata = {'apiLevel': '2.19'}

def run(protocol: protocol_api.ProtocolContext):
    # Load Temperature Module GEN2
    temp_mod = protocol.load_module("temperature module gen2", "D1")  # Flex
    # temp_mod = protocol.load_module("temperature module gen2", "4")  # OT-2

    # Load labware on module
    cold_plate = temp_mod.load_labware("opentrons_96_aluminumblock_generic_pcr_strip_200ul")

Module versions:

  • "temperature module gen2" - GEN2 (recommended)
  • "temperatureModuleV1" - GEN1 (legacy)

Deck slot: Any compatible slot (Flex: A1-D3, OT-2: 1-11)

Loading Labware

Standalone Adapters (API 2.15+)

Recommended approach - Load adapter first, then labware:

# 96-well aluminum block
temp_block = temp_mod.load_adapter("opentrons_96_well_aluminum_block")
sample_plate = temp_block.load_labware("opentrons_96_wellplate_200ul_pcr_full_skirt")

Available adapters:

Adapter NameCompatible Labware
opentrons_96_well_aluminum_block96-well plates, PCR plates
opentrons_aluminum_flat_bottom_plateFlat-bottom plates
opentrons_96_deep_well_temp_mod_adapterDeep-well plates

Block-and-Tube Combinations

For tube racks with aluminum blocks:

# 24-well block with various tube types
tubes_nest = temp_mod.load_labware("opentrons_24_aluminumblock_nest_1.5ml_snapcap")
tubes_generic = temp_mod.load_labware("opentrons_24_aluminumblock_generic_2ml_screwcap")

Legacy Block-and-Plate Combinations

# Pre-configured combinations (older API versions)
plate_combo = temp_mod.load_labware("opentrons_96_aluminumblock_biorad_wellplate_200ul")

Recommendation: Use standalone adapters (API 2.15+) for better flexibility.

Temperature Control

Setting Temperature

# Set temperature and wait until reached
temp_mod.set_temperature(celsius=4)

# Protocol waits here until 4°C is reached

# Perform operations at target temperature
pipette.transfer(100, cold_reagent, dest_plate.wells())

Temperature range: 4-95°C (1°C resolution)

Behavior: Protocol execution blocks (waits) until target temperature is reached.

Temperature Status

# Get current temperature
current_temp = temp_mod.temperature
protocol.comment(f"Module at {current_temp}°C")

# Check status
status = temp_mod.status
# Returns: "holding at target" or "idle"

if status == "holding at target":
    protocol.comment("Temperature stable, proceeding")

Deactivating

# Turn off temperature control
temp_mod.deactivate()

Important: Module does not automatically deactivate at protocol end. Must be manually turned off via Opentrons App if protocol completes or is cancelled.

Common Patterns

Keeping Reagents Cold

# Keep enzymes and master mix cold throughout protocol
temp_mod = protocol.load_module("temperature module gen2", "D1")
reagent_block = temp_mod.load_adapter("opentrons_24_aluminumblock_nest_1.5ml_snapcap")

# Set to 4°C before starting
temp_mod.set_temperature(4)

# Reagents stay cold during entire protocol
pipette.transfer(10, reagent_block["A1"], dest_plate.wells())
# ... rest of protocol ...

# Turn off at end
temp_mod.deactivate()

Pre-Warming Reaction Components

# Pre-warm buffer to 37°C
temp_mod = protocol.load_module("temperature module gen2", "C2")
warm_block = temp_mod.load_adapter("opentrons_96_well_aluminum_block")
warm_plate = warm_block.load_labware("corning_96_wellplate_360ul_flat")

# Set to reaction temperature
temp_mod.set_temperature(37)

# Use pre-warmed components
pipette.transfer(50, warm_plate["A1"], reaction_plate
Read the complete source ↗