Skip to content

Open Source Bioreactor

License: GPL-3.0-or-later

A parametric OpenSCAD bioreactor built on glass jars from 1.5 L to 6.5 gal. It is stirred by a shaft or magnetic drive, or run as an airlift, and a printed lid carries the drive, sparger, probes and ports.

Under development, not yet ready for use.

  • scad/ - the OpenSCAD source, built around registered parameter sets for purchased parts and composable modules for printed ones.

A printer whose bed takes a 257.6 mm disc in both X and Y (the lid and the frame’s two bases, see Building it); the bought parts in purchased-parts.csv, which just cost totals; and the OpenSCAD libraries just setup installs.

Run just setup, then just export-parts to write every printed part as an STL with a print list, then follow docs/build.md.

To cite this project, use the metadata in CITATION.cff. GitHub’s “Cite this repository” button reads the same file.

Copyright (c) 2024-2026 Cameron Brooks.

This project is free software: you may redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. That covers the hardware design too: its source includes GPL-licensed libraries, so it cannot also carry CERN-OHL-S. The measurement data under analysis/, and its plots, are licensed instead under CC-BY-4.0. See LICENSING.md for what applies where, and the organization licensing policy for why.

Run just setup first, after cloning and whenever scadman.lock changes. It installs the libraries below into .scadman/env/ with scadman, each at the revision scadman.lock pins and checked against its content hash, and every recipe puts that directory first on OPENSCADPATH. Without it most of scad/ does not build, and just check and just test fail. Run it even with these libraries installed globally: a global copy at another revision is what the pins exist to rule out.

just setup fetches the scadman release it needs into .cache/ on Linux x86_64 and macOS. Elsewhere it uses a scadman on PATH. Without scadman, install each library below into a folder with the name shown, at the pin shown, and put that folder on OPENSCADPATH. scadman.toml says why each one is at its pin.

Name Repository Pin
NopSCADlib nophead/NopSCADlib v21.41.1
bayonet-lock-scad CameronBrooks11/bayonet-lock-scad v0.12.0
FunctionalOpenSCAD thehans/FunctionalOpenSCAD 51588ff
threads-scad rcolyer/threads-scad 4ae9aeb
din168-thread-scad CameronBrooks11/din168-thread-scad v0.1.0
turbidity-sensor uwo-fast/turbidity-sensor 4be431f
syringe-actuator uwo-fast/syringe-actuator ea8b221