Build
Cookbook
Worked examples, one experiment per page: what you say to the agent, which instruments it needs, the plan it shows you before anything moves, and what comes back. Every example runs against simulated twins, so you can try it in five minutes with nothing plugged in.
Each entry uses a bundled recipe. Run the setup once, add the twins, and follow along in your own agent:
npx @sinkush/openmhp setup
npx @sinkush/openmhp demo # the simulated thermocycler and plate arm
Examples
Run a PCR with a plate transferAn arm moves the plate, the thermocycler cycles, the plate comes back. Two instruments, one sentence.
Monitor an incubator overnightA background run logs readings to CSV and flags anything outside a band. Ask in the morning what happened.
Calibrate with a setpoint sweepStep a setting through values, settle, measure, get a table and a CSV. For lasers, stages, ovens, anything with a setpoint.
Reflux on a stirrer hotplateReach a temperature, hold it for an hour, cool down safely. A hand-operated or serial hotplate, no code.
What every example shows
- The sentence. What a scientist actually says. No tool names.
- The plan. The agent rehearses the recipe in plan mode and shows the steps, the points where it will ask, and anything the driver would refuse.
- The confirmation. Where a human has to say yes, and how that looks in the harness.
- The result. What the agent reports, and where the data landed.
- Variations. How to point the same recipe at your real instrument.
New examples are added regularly. Want one for your workflow? Open an issue with the instruments and the procedure.