PUDA Machines
Goal
Provide machine-selection and capability guidance for PUDA workflows, then load the correct machine reference before generating commands.
Critical Rule
If you are unsure which machine should be used for a command, ask the user before proceeding.
Do not assume.
Machine Capabilities and When to Use
First Machine (machine_id: "first")
Use for liquid handling and deck operations.
Capabilities:
- Pipetting workflows: aspirate, dispense, attach tip, drop tip
- Deck and labware workflows: load deck, position-dependent operations
- Sequenced robotic handling steps in wet-lab protocols
Use this machine when:
- The task is about moving liquids between wells/labware
- The user mentions tip usage, aspiration/dispensing, or deck slots/labware setup
Before command generation:
- Refer to: first-machine
- Run
puda machine commands first to understand available commands
- Follow constraints and sequencing in
references/first-machine.md
PipQuBotV3 Machine (machine_id: "pipqubotv3")
Use for liquid handling and deck operations.
Capabilities:
- Pipetting workflows: aspirate, dispense, attach tip, drop tip
- Deck and labware workflows: load deck, position-dependent operations
- Sequenced robotic handling steps in wet-lab protocols
Use this machine when:
- The task is about moving liquids between wells/labware
- The user mentions tip usage, aspiration/dispensing, or deck slots/labware setup
Before command generation:
- Refer to: pipqubotv3-machine
- Run
puda machine commands pipqubotv3 to understand available commands
- Follow constraints and sequencing in
references/pipqubotv3-machine.md
Biologic Machine (machine_id: "biologic")
Use for electrochemical testing and characterization.
Capabilities:
- OCV (Open Circuit Voltage)
- CA (Chronoamperometry)
- PEIS / GEIS (Impedance spectroscopy)
- CV (Cyclic Voltammetry)
- MPP variants (MPP, MPP_Cycles, MPP_Tracking)
Use this machine when:
- The task is an electrochemical measurement or battery/cell characterization
- The user asks for OCV, CA, EIS, CV, or MPP tests
Before command generation:
- Refer to: biologic-machine
- Run
puda machine commands biologic to understand available commands
- Follow constraints in
references/biologic-machine.md
Centrifuge Machine (machine_id: "centrifuge")
Use for centrifugation, spin-downs, and phase or pellet separation.
Capabilities:
- Sample spin-downs before or after handling steps
- Separation workflows based on centrifugal force
- Pelleting, clarification, and phase-separation preparation steps
Use this machine when:
- The user asks to centrifuge, spin, spin down, pellet, or clarify samples
Before command generation:
- Refer to: centrifuge-machine
- Run
puda machine commands centrifuge to understand available commands
- Follow constraints in
references/centrifuge-machine.md
Dobot M1Pro Machine (machine_id: "dobot-m1pro")
Use for gripper-based tube transfers between fixed positions.
Capabilities:
- Pick-and-place tube handling with a gripper
- Moving tubes between predefined source and destination positions
- Position-based transfer steps between pipqubotv3, bioshake, centrifuge machines
Use this machine when:
- The user asks to transfer tubes with a gripper
- The workflow involves moving tubes between known hardcoded positions
- A step references Dobot M1Pro positions such as centrifuge tube or MTP coordinates
Before command generation:
- Refer to: dobot-m1pro-machine
- Run
puda machine commands dobot-m1pro to understand available commands
- Follow constraints in
references/dobot-m1pro-machine.md
BioShake Machine (machine_id: "bioshake")
Use for shaking, heating, and plate clamping operations.
Capabilities:
- Shaking at a specified RPM for a given duration
- Heating (or cooling) to a target temperature and holding for a given duration
- Clamping and unclamping plates on the shaker
- Homing the shaker to its locked home position
Use this machine when:
- The user asks to shake, vortex, or mix a plate on a shaker
- The user asks to heat or incubate a plate at a specific temperature
- The user asks to clamp or unclamp a plate on the BioShake
- The workflow requires holding a plate at temperature while shaking
Before command generation:
- Run
puda machine commands bioshake to understand available commands
Balance Machine
Use for gravimetric mass measurement via an Arduino-based USB load-cell balance on Linux.
Capabilities:
- Continuous calibrated mass readings from a load-cell over USB serial (
/dev/ttyUSB* or /dev/ttyACM*)
- Background reader thread streaming readings at ~4 Hz; no polling required
- Tare command to zero the balance before a dispense step
- Freshness check (
fresh flag) to detect stale/disconnected readings
- NATS telemetry publishing via the edge service
- Custom calibration CSV support
Use this machine when:
- The workflow requires weighing a container before or after a liquid transfer
- The user asks for gravimetric calibration, transfer error calculation, or balance feedback
- The task involves viscosity or transfer accuracy experiments needing mass data
Before use:
- Refer to: balance-machine
- Ask the user for the Linux serial port (
/dev/ttyUSB1, etc.) — do not assume
- Ensure the edge service is running (
uv run --package balance-edge python edge/balance.py)
Opentrons Machine (machine_id: "opentrons")
Use for automated liquid handling and full protocol generation on the Opentrons OT-2 robot.
Capabilities:
- Full protocol code generation via
Protocol.to_python_code() — produces valid runnable OT-2 Python
- Pipetting workflows:
aspirate, dispense, mix, transfer (with auto-chunking for large volumes)
- Tip management:
pick_up_tip, drop_tip
- Deck and labware setup:
load_labware, load_instrument
- Flow control:
flow_rate, air_gap, blow_out, touch_tip, move_to
- Protocol utilities:
delay, comment, home
- CSV-driven loops:
read_csv_file + loop for data-driven protocols
- Custom labware support: AMDM mass balance vials (30 mL, 50 mL) loaded inline
- All gen2 pipette types: p10, p20, p300, p1000 (single and multi-channel)
- External camera image capture:
camera_capture — triggers the external camera mounted above the deck to capture and save a still image of the wellplate
Use this machine when:
- The user references an Opentrons OT-2 robot
- The task involves generating a complete OT-2 protocol or individual liquid handling commands
- The user mentions Opentrons labware (tip racks, well plates, reservoirs, NEST, Corning, mass balance vials)
- The workflow requires data-driven dispensing from a CSV file
- The workflow requires capturing a camera image of the wellplate after dispensing steps
Before command generation:
- Refer to: opentrons-machine
- Run
puda machine commands opentrons to understand available commands
- Follow all command types, params, sequencing rules, and labware constraints in
references/opentrons-machine.md
Selection Workflow
- Parse user intent and identify the tasks.
- Match intent to the machine capabilities above.
- If machine selection is unclear or ambiguous, ask the user and wait for confirmation.
- Load the corresponding reference file and CLI help.
- Generate commands only after machine choice is confirmed.
Output Guidance
When answering machine-selection questions:
- State the recommended machine and a one-line reason tied to capability.
- If uncertain, ask a direct clarification question instead of guessing.
Critical sequencing rules
bioshake must not be shaking while any machine is operating on a Bioshake position.
centrifuge must not be spinning while any machine is operating on a Centrifuge position.
opentrons protocols must always end with no tip attached to any pipette.
opentrons deck slot (location) for every load_labware command must be explicitly confirmed by the user — never assume a slot.
opentrons capture_image must be its own standalone protocol — never combined with pipetting commands in the same protocol.
balance — always call startup() before reading and shutdown() after. Always tare before a dispense step. Always verify fresh == True before using a reading.
1---2name: ntu-machines3description: Discover PUDA machine capabilities in ntu lab and choose the right machines for protocol generation. Use when you need to know more about a machine, how to use a machine, or how to generate commands and protocols for any PUDA-connected machine4metadata:5 source: https://skillmd.com/skills/pudap/ntu-machines6---78# PUDA Machines910## Goal1112Provide machine-selection and capability guidance for PUDA workflows, then load the correct machine reference before generating commands.1314## Critical Rule1516If you are unsure which machine should be used for a command, **ask the user** before proceeding. 17Do **not** assume.1819## Machine Capabilities and When to Use2021### First Machine (`machine_id: "first"`)2223Use for **liquid handling and deck operations**.2425Capabilities:26- Pipetting workflows: aspirate, dispense, attach tip, drop tip27- Deck and labware workflows: load deck, position-dependent operations28- Sequenced robotic handling steps in wet-lab protocols2930Use this machine when:31- The task is about moving liquids between wells/labware32- The user mentions tip usage, aspiration/dispensing, or deck slots/labware setup3334Before command generation:35- Refer to: [first-machine](references/first-machine.md)36- Run `puda machine commands first` to understand available commands37- Follow constraints and sequencing in `references/first-machine.md`3839### PipQuBotV3 Machine (`machine_id: "pipqubotv3"`)4041Use for **liquid handling and deck operations**.4243Capabilities:44- Pipetting workflows: aspirate, dispense, attach tip, drop tip45- Deck and labware workflows: load deck, position-dependent operations46- Sequenced robotic handling steps in wet-lab protocols4748Use this machine when:49- The task is about moving liquids between wells/labware50- The user mentions tip usage, aspiration/dispensing, or deck slots/labware setup5152Before command generation:53- Refer to: [pipqubotv3-machine](references/pipqubotv3-machine.md)54- Run `puda machine commands pipqubotv3` to understand available commands55- Follow constraints and sequencing in `references/pipqubotv3-machine.md`5657### Biologic Machine (`machine_id: "biologic"`)5859Use for **electrochemical testing and characterization**.6061Capabilities:62- OCV (Open Circuit Voltage)63- CA (Chronoamperometry)64- PEIS / GEIS (Impedance spectroscopy)65- CV (Cyclic Voltammetry)66- MPP variants (MPP, MPP_Cycles, MPP_Tracking)6768Use this machine when:69- The task is an electrochemical measurement or battery/cell characterization70- The user asks for OCV, CA, EIS, CV, or MPP tests7172Before command generation:73- Refer to: [biologic-machine](references/biologic-machine.md)74- Run `puda machine commands biologic` to understand available commands75- Follow constraints in `references/biologic-machine.md`7677### Centrifuge Machine (`machine_id: "centrifuge"`)7879Use for **centrifugation, spin-downs, and phase or pellet separation**.8081Capabilities:82- Sample spin-downs before or after handling steps83- Separation workflows based on centrifugal force84- Pelleting, clarification, and phase-separation preparation steps8586Use this machine when:87- The user asks to centrifuge, spin, spin down, pellet, or clarify samples8889Before command generation:90- Refer to: [centrifuge-machine](references/centrifuge-machine.md)91- Run `puda machine commands centrifuge` to understand available commands92- Follow constraints in `references/centrifuge-machine.md`9394### Dobot M1Pro Machine (`machine_id: "dobot-m1pro"`)9596Use for **gripper-based tube transfers between fixed positions**.9798Capabilities:99- Pick-and-place tube handling with a gripper100- Moving tubes between predefined source and destination positions101- Position-based transfer steps between pipqubotv3, bioshake, centrifuge machines102103Use this machine when:104- The user asks to transfer tubes with a gripper105- The workflow involves moving tubes between known hardcoded positions106- A step references Dobot M1Pro positions such as centrifuge tube or MTP coordinates107108Before command generation:109- Refer to: [dobot-m1pro-machine](references/dobot-m1pro-machine.md)110- Run `puda machine commands dobot-m1pro` to understand available commands111- Follow constraints in `references/dobot-m1pro-machine.md`112113### BioShake Machine (`machine_id: "bioshake"`)114115Use for **shaking, heating, and plate clamping operations**.116117Capabilities:118- Shaking at a specified RPM for a given duration119- Heating (or cooling) to a target temperature and holding for a given duration120- Clamping and unclamping plates on the shaker121- Homing the shaker to its locked home position122123Use this machine when:124- The user asks to shake, vortex, or mix a plate on a shaker125- The user asks to heat or incubate a plate at a specific temperature126- The user asks to clamp or unclamp a plate on the BioShake127- The workflow requires holding a plate at temperature while shaking128129Before command generation:130- Run `puda machine commands bioshake` to understand available commands131132### Balance Machine133134Use for **gravimetric mass measurement via an Arduino-based USB load-cell balance on Linux**.135136Capabilities:137- Continuous calibrated mass readings from a load-cell over USB serial (`/dev/ttyUSB*` or `/dev/ttyACM*`)138- Background reader thread streaming readings at ~4 Hz; no polling required139- Tare command to zero the balance before a dispense step140- Freshness check (`fresh` flag) to detect stale/disconnected readings141- NATS telemetry publishing via the edge service142- Custom calibration CSV support143144Use this machine when:145- The workflow requires weighing a container before or after a liquid transfer146- The user asks for gravimetric calibration, transfer error calculation, or balance feedback147- The task involves viscosity or transfer accuracy experiments needing mass data148149Before use:150- Refer to: [balance-machine](references/balance-machine.md)151- Ask the user for the **Linux serial port** (`/dev/ttyUSB1`, etc.) — do not assume152- Ensure the edge service is running (`uv run --package balance-edge python edge/balance.py`)153154### Opentrons Machine (`machine_id: "opentrons"`)155156Use for **automated liquid handling and full protocol generation on the Opentrons OT-2 robot**.157158Capabilities:159- Full protocol code generation via `Protocol.to_python_code()` — produces valid runnable OT-2 Python160- Pipetting workflows: `aspirate`, `dispense`, `mix`, `transfer` (with auto-chunking for large volumes)161- Tip management: `pick_up_tip`, `drop_tip`162- Deck and labware setup: `load_labware`, `load_instrument`163- Flow control: `flow_rate`, `air_gap`, `blow_out`, `touch_tip`, `move_to`164- Protocol utilities: `delay`, `comment`, `home`165- CSV-driven loops: `read_csv_file` + `loop` for data-driven protocols166- Custom labware support: AMDM mass balance vials (30 mL, 50 mL) loaded inline167- All gen2 pipette types: p10, p20, p300, p1000 (single and multi-channel)168- **External camera image capture**: `camera_capture` — triggers the external camera mounted above the deck to capture and save a still image of the wellplate169170Use this machine when:171- The user references an Opentrons OT-2 robot172- The task involves generating a complete OT-2 protocol or individual liquid handling commands173- The user mentions Opentrons labware (tip racks, well plates, reservoirs, NEST, Corning, mass balance vials)174- The workflow requires data-driven dispensing from a CSV file175- The workflow requires capturing a camera image of the wellplate after dispensing steps176177Before command generation:178- Refer to: [opentrons-machine](references/opentrons-machine.md)179- Run `puda machine commands opentrons` to understand available commands180- Follow all command types, params, sequencing rules, and labware constraints in `references/opentrons-machine.md`181182183## Selection Workflow1841851. Parse user intent and identify the tasks.1862. Match intent to the machine capabilities above.1873. If machine selection is unclear or ambiguous, **ask the user** and wait for confirmation.1884. Load the corresponding reference file and CLI help.1895. Generate commands only after machine choice is confirmed.190191## Output Guidance192193When answering machine-selection questions:194- State the recommended machine and a one-line reason tied to capability.195- If uncertain, ask a direct clarification question instead of guessing.196197## Critical sequencing rules1981. `bioshake` must not be shaking while any machine is operating on a Bioshake position.1992. `centrifuge` must not be spinning while any machine is operating on a Centrifuge position.2003. `opentrons` protocols must always end with no tip attached to any pipette.2014. `opentrons` deck slot (`location`) for every `load_labware` command must be explicitly confirmed by the user — **never assume a slot**.2025. `opentrons` `capture_image` must be its own standalone protocol — never combined with pipetting commands in the same protocol.2036. `balance` — always call `startup()` before reading and `shutdown()` after. Always tare before a dispense step. Always verify `fresh == True` before using a reading.204