PipetteC · Stakeholder report Source & code: github.com/ewijaya/opentrons-protocol-compiler
A plain-language report · no prior knowledge assumed

Turning a simple experiment recipe into cheaper, self-checked instructions for a lab robot.

Written from the ground up for a reader who has never touched a laboratory or written a line of code. It covers what problem this tool solves, how it works, and how you can judge for yourself whether it is any good. Every result quoted here is produced by the tool itself and checked by an independent referee.

Audience: non-technical stakeholders Read time: ~8 minutes Tool: PipetteC
Executive summary

The 30-second version

Modern labs use robots to move tiny amounts of liquid between hundreds of little cups. This is the everyday work behind drug discovery, medical testing, and research. Today a scientist writes the robot's instructions by hand: it is slow, easy to get wrong, and wasteful of expensive single-use plastic tips.

PipetteC lets the scientist write a short "recipe" instead. The tool turns that recipe into precise robot instructions, automatically makes them cheaper and faster, and has an independent referee check every result before anyone trusts it.

93%
fewer disposable plastic tips on the flagship experiment (184 down to 13)
500/500
generated instruction-sets passed the independent referee, with zero failures
100%
guaranteed to deliver the same liquid as the hand-written version. Proven, not promised.

Section 02The world this lives in

The setting first, so the problem makes sense. No jargon; skip nothing.

Labs move liquid for a living

A huge amount of science and medicine comes down to moving small drops of liquid from one little cup to another and seeing what happens. Testing whether a drug works, running a COVID test, checking a blood sample: under the hood, it is liquids being combined in precise amounts.

A "plate" is a flat tray with a grid of tiny cups, commonly 96 of them (8 rows × 12 columns), each holding a drop smaller than a raindrop. Each cup is called a "well."

A robot does the pipetting

Doing this by hand, thousands of tiny identical drops, is tedious and imprecise. So labs use a liquid-handling robot: a machine with a motorized eyedropper (a "pipette") that moves over the tray and squirts exact amounts into each cup. A popular, affordable one is the Opentrons OT-2. That is the machine this tool writes instructions for.

Everyday analogy Think of an automated icing machine for cupcakes. The tray of cupcakes is the "plate," each cupcake is a "well," and the nozzle that pipes icing is the "pipette." The robot follows a written program telling it exactly where to squirt and how much.
A "tip" is the small disposable plastic nozzle on the pipette. To avoid contaminating one liquid with another, the robot often throws the tip away and grabs a fresh one. Tips cost money and create plastic waste, so using fewer of them is a real, measurable win. Reusing a tip is only safe when it won't mix things that shouldn't be mixed.

Section 03The problem we are solving

Writing the robot's program by hand is slow, error-prone, and wasteful. Three costs, concretely:

① It is easy to get wrong

The program is hundreds of low-level "move this much liquid from here to there" commands. One typo can ruin an experiment, wasting days of work and costly materials, or, worse, produce results that look fine but are subtly incorrect.

② It wastes expensive tips

A careless program grabs a brand-new plastic tip for every single drop, even when the same tip could safely be reused. On a busy plate that is hundreds of needless tips: real money and real plastic, every run.

③ It is slow to write and hard to trust

Optimizing the program by hand to save tips is fiddly and risky. Every hand-optimization is a new chance to accidentally change what the experiment actually does.

Everyday analogy It is like writing turn-by-turn driving directions by hand for a delivery driver, every single street. Doable, but slow, and one wrong turn wastes the whole trip. You would much rather describe the destinations, let a GPS compute the efficient route, and confirm it is valid before the driver leaves.

Section 04The idea, and why this tool

PipetteC is a "compiler" for lab experiments. That word deserves one plain sentence.

A "compiler" is a translator: you write instructions in an easy, high-level form, and it automatically produces the exact, detailed, machine-ready version. Every app on your phone was built by a compiler translating human-written code into machine code.

PipetteC does the same for lab work. The scientist writes a short, readable recipe, such as "make a standard dilution series of Drug A, 8 copies, 12 steps." The tool then does three jobs automatically:

  1. Translate. It turns the recipe into complete, correct robot instructions, with no hand-writing of hundreds of commands.
  2. Optimize. It rearranges the work to reuse tips wherever it is safe, cutting cost, plastic, and time while guaranteeing the experiment is unchanged.
  3. Verify. It hands every result to an independent referee (see Section 06) that catches mistakes before the robot ever moves.
Everyday analogy You describe the meal you want; the tool writes the precise cooking steps, finds the time-saving shortcuts a pro chef would use, and has a food inspector sign off before it reaches the kitchen.

Section 05What you put in, what you get out

What goes in: the recipe

A short, human-readable file. This is the entire input for a real 96-cup dilution experiment:

Input
The scientist's recipe (plain text)
make: serial_dilution
compounds: [DrugA]
copies: 8
steps: 12
strength: 100
dilution_factor: 3

The tool also accepts a real industry file called an "Echo picklist": a spreadsheet of "move this much from cup A to cup B" rows that many labs already produce. No new format to learn.

What comes out

  • Ready-to-run robot instructions: the exact program the OT-2 executes.
  • A cost report: how many tips, how much liquid, and an estimated run time.
  • A picture of the robot's workbench (below), so a human can sanity-check the setup at a glance.
  • A pass/fail stamp from the referee, proof the instructions are valid.
Exhibit A
Auto-drawn robot workbench ("deck") for the example experiment
dose_response slot 1 plate corning_96_wellplate_360ul_flat slot 2 reagents nest_12_reservoir_15ml slot 3 tips opentrons_96_tiprack_300ul slot 4 slot 5 slot 6 tips2 opentrons_96_tiprack_300ul slot 7 slot 8 slot 9 slot 10 slot 11 slot 12 Fixed Trash

Each square is a slot on the robot's workbench. Green = trays of cups; blue = the reservoir of liquid; yellow = racks of fresh tips; red = the trash. The tool draws this from the recipe so a person can eyeball it before pressing "go."

Generated by the tool: pipettec render examples/dose_response.yaml --deck.

Section 06How we prove it works, and how you can tell it's good

A tool that saves money is worthless if it quietly breaks the experiment. So this is the section that matters most: the three independent ways we prove the output is trustworthy.

Proof 1: an official referee checks every result

The maker of the robot (Opentrons) publishes an official simulator: a program that "dry-runs" any set of instructions and flags anything impossible or invalid, without needing the physical robot. We run every single set of instructions the tool produces through this referee. It is never faked or skipped.

Everyday analogy Like a flight simulator that must complete the whole flight without crashing before a new route is approved, except we require a clean run every time, automatically.

Proof 2: a mathematical guarantee that the science is unchanged

When the tool reuses tips to save money, it must never change what liquid ends up where. We check this with a strict rule: the optimized instructions must deliver the exact same amount of every liquid to every cup as the plain, un-optimized version. We tested this on 550 randomly generated experiments and found zero cases where it differed.

Proof 3: it refuses to run unsafe or impossible recipes

Before anything runs, a built-in safety checker rejects recipes that ask for the impossible (too much liquid for a cup, drawing from an empty cup, mixing things that must not touch), giving a clear, readable explanation instead of a silent failure.

Exhibit B
The evidence, at a glance
500/500
generated instruction-sets passed the official referee (zero failures)
0
cases where optimization changed the experiment, across 550 random tests
94%
of the tool's own code is exercised by 56 automated tests

Every number here is produced by the project's own automated checks, which run again on every code change.

Sources: the official opentrons_simulate (v8.8.2), the project's automated test suite, and benchmarks/simulate_corpus.py (500-experiment run).

Section 07The results, in plain numbers

The payoff, measured rather than estimated. "Tips" are the throwaway plastic nozzles; fewer is cheaper and greener. The comparison is fair by construction: both columns come from the same tool, once with the money-saving smarts off, once with them on.

Exhibit C
Before (hand-style) vs. after (optimized), across six real experiments
ExperimentTips beforeTips afterSavedEst. time before → after
Dose–response dilution (flagship)18413−92.9%49 → 16 min
Plate normalization81−87.5%2.1 → 1.2 min
PCR setup (24 reactions)4825−47.9%12.8 → 9.7 min
Echo picklist import107−30.0%2.7 → 2.3 min
Cherry-pick transfers54−20.0%1.3 → 1.2 min
96→384 plate reformat1921920%51 → 51 min
We show the case where we save nothing, on purpose. The last experiment already can't be improved: the safety rules require a fresh tip for each source, so there is nothing to save. An honest report shows the "0%" next to the wins rather than hiding it. That willingness to show the null result is itself a signal you can trust the other numbers.
Tip and step counts are exact (counted directly). Time is a transparent model estimate, clearly labelled, and not a measurement from physical hardware. Source: benchmarks/bench.py, run on opentrons 8.8.2.
Exhibit D
The flagship result: 184 → 13 tips (93% fewer)
Hand-style (no optimization) 184 tips PipetteC (optimized) 13 tips Bars drawn to scale · one tip = one disposable plastic nozzle thrown away
Source: pipettec compile examples/dose_response.yaml.

Section 08Honesty: the limits, and what's genuinely new

A credible report states its boundaries plainly.

What is new here

The clever tip-saving math is published prior research that we apply and credit; we do not claim to have invented it. The contribution is the packaged, end-to-end tool: an easy recipe in, a verified robot program out, with the official referee wired in as an automatic gate.

What it does not do (yet)

It targets one specific robot (the Opentrons OT-2) and validates in the official simulator, not on physical hardware. The time figures are transparent estimates, clearly labelled and never presented as hardware measurements.

How a skeptical stakeholder can verify all of this in minutes

Section 09The bottom line

A scientist writes a short recipe. PipetteC turns it into correct, cheaper, self-checked robot instructions, cutting disposable-plastic use by up to 93% on the flagship experiment, with a proven guarantee that the science is unchanged and an independent referee signing off on every result.

The value lies in trustworthy execution rather than a novel formula: less waste, fewer errors, and results you can verify yourself rather than take on faith.

Recipe Translate Optimize (save tips) Safety check Robot instructions Referee: ✓ passed