Skip to content

OpenReactor

Supervise benchtop lab reactors from a Raspberry Pi: temperature, mixing, dosing and water chemistry, with recorded runs.

License: AGPL-3.0-or-later Contributions welcome

openreactor runs batch and semi-batch reactors on the bench, for biology, wet chemistry and thermal work such as melting and curing. The heater and motor boards run their own control loops, and a heater board with a command watchdog stops its outputs if it loses contact with the Pi. openreactor supervises them over I2C: it applies setpoints, reads water-chemistry sensors, records each run, and stops every output on request.

Version 2.0.0a1 is an alpha, and a rewrite that is not compatible with 1.x. It reads and calibrates EZO sensors, drives RLHT heater slices and DCMT motor slices (open loop) with their command watchdogs and stop-all, records and exports runs, runs setpoint profiles, and serves an HTTP API and a browser UI. It does not yet ship a systemd unit (#29). #17 tracks 2.0.

For a stable install, use v1.2.1; the 1.x branch has its setup and usage instructions. It takes fixes for reported bugs only. Until 2.0.0 is released, pip install openreactor without a version installs the alpha, because 2.0.0a1 is the only version on PyPI.

openreactor 2.0 supervises one bench-top vessel per instance, with every device listed in the configuration file. It does not include:

  • plugins or user scripts that drive the hardware (#78 collects ideas for experiment logic after 2.0);
  • device discovery;
  • a simulator;
  • shredding or other mechanical processing;
  • migrating 1.x data.

Host control loops fed by EZO readings, such as dosing, are planned for 2.1.

openreactor runs on a Raspberry Pi with 64-bit Raspberry Pi OS. It drives RLHT heater slices running Slice_RLHT firmware, each with an onboard PID on two outputs and two thermocouples (a gen1 board has a heater relay on output 1 only), and DCMT motor slices running Slice_DCMT firmware, each with two motors that openreactor drives open loop, at a duty from -100 to 100 %. It reads Atlas Scientific EZO pH, ORP, RTD, EC, DO and HUM circuits. Every device is listed in the configuration file.

docs/install.md covers preparing the Pi and installing openreactor. Then copy examples/openreactor.toml, keep the devices you have, check it, read the sensors once, and start the server:

Terminal window
uv run openreactor check-config ~/openreactor.toml
uv run openreactor read -c ~/openreactor.toml
uv run openreactor serve -c ~/openreactor.toml

Open http://127.0.0.1:8080/ in a browser on the Pi. Ctrl-C stops the server, which sends stop-all first. serve starts every RLHT slice in the configuration, so read docs/safety.md before you connect a heater.

docs/development.md covers setting up, testing and releasing.

Contributions are welcome. See the organization contribution guide.

If you use openreactor in your work, please cite it with the “Cite this repository” button on GitHub, or from CITATION.cff.

openreactor was originally written by Etienne Michels, Wilson J. Holmes and Finn Hafting in the MOST Research Group.

Copyright (c) 2021-2026 the openreactor contributors. openreactor is licensed under the GNU Affero General Public License, version 3 or any later version; see LICENSE. The MOST Research Group first released it in 2021 under GPL-2.0-only. In January 2025 the FAST Research Group reworked it and relicensed it under the AGPL-3.0, so that improvements stay available to everyone who uses it.

The FAST research group maintains openreactor. For research collaboration, contact Dr. Joshua Pearce (joshua.pearce@uwo.ca).