Skip to main content

Open reference implementation of self-driving perfusion bioprocess development (Gadiyar et al., 2026)

Project description

perfusio

perfusio is an open, peer-reviewable reference implementation of the self-driving perfusion methodology of Gadiyar et al. (2026) and Hutter et al. (2021), providing stepwise Gaussian Process hybrid models, entity-embedding transfer learning, 11 Bayesian experimental design acquisitions, and a fully-instrumented online digital twin for CHO cell perfusion bioprocesses.

CI Docs PyPI License: Apache-2.0 Python


Quick-start

pip install perfusio
python -c "from perfusio.simulator.cho_perfusion import CHOSimulator; print('OK')"

Reproduce all paper figures

pip install perfusio
python examples/reproduce_paper_figures.py
# → paper_figures/{fig4,fig7,fig8}.{pdf,png,svg}

CLI

# Generates 27 runs (4-factor Box-Behnken design, 3 centre points)
perfusio simulate --clone CloneX --n-days 28 --out runs/
perfusio train   --runs runs/ --model-out model.pt
perfusio run     --model model.pt --connector ambr250 --dashboard
perfusio reproduce-figures --out paper_figures/

What's inside

Module Description
perfusio.mechanistic CHO kinetics ODEs (dual-Monod, Pirt, Warburg, Luedeking–Piret)
perfusio.gp PerfusionKernel, JackknifeEnsemble, StepwiseGP
perfusio.embedding Entity-embedding transfer (Hutter 2021)
perfusio.hybrid Hybrid state-space model + online retraining
perfusio.bed 11 BED acquisitions + Pareto / HV utilities
perfusio.simulator CHOSimulator, Box-Behnken / LHC DoE, noise model
perfusio.twin DigitalTwin, audit, notifications, scheduler
perfusio.connectors OPC UA, SQL, filesystem, ambr®250 emulator
perfusio.metrics rRMSE, PI coverage, CRPS, IGD+, ε-indicator
perfusio.viz Static figures (Matplotlib) + interactive (Plotly/Dash)
perfusio.cli Typer CLI

Installation

CPU (default)

pip install perfusio

GPU

pip install perfusio[gpu]

Dashboard

pip install perfusio[dash]
perfusio run --dashboard

Development

git clone https://github.com/lynchaos/perfusio.git
cd perfusio
pip install -e ".[dev]"
pre-commit install
pytest

Citation

If you use perfusio, please cite:

@article{gadiyar2026,
  author  = {Gadiyar, Chiraag J. and others},
  title   = {Self-Driving Development of Perfusion Processes
             for Monoclonal Antibody Production},
  journal = {Biotechnology and Bioengineering},
  year    = {2026},
  volume  = {123},
  number  = {2},
  pages   = {391--405},
  doi     = {10.1002/bit.28631},
}

@article{hutter2021,
  author  = {Hutter, Clemens and von Stosch, Moritz and Cruz Bournazou, Mariano N. and Butt{\'e}, Alessandro},
  title   = {Knowledge transfer across cell lines using hybrid Gaussian
             process models with entity embedding vectors},
  journal = {Biotechnology and Bioengineering},
  year    = {2021},
  volume  = {118},
  number  = {12},
  pages   = {4710--4725},
  doi     = {10.1002/bit.27907},
}

Limitations

See LIMITATIONS.md for a full list of out-of-scope items, including CQA modelling, GMP validation, and proprietary media formulations.

Contributing

See CONTRIBUTING.md.

Code of Conduct

See CODE_OF_CONDUCT.md.

Maintainer

Kemal Yaylalikemal.yaylali.uk

Licence

Apache-2.0 — see LICENSE.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

perfusio-0.1.1.tar.gz (119.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

perfusio-0.1.1-py3-none-any.whl (118.6 kB view details)

Uploaded Python 3

File details

Details for the file perfusio-0.1.1.tar.gz.

File metadata

  • Download URL: perfusio-0.1.1.tar.gz
  • Upload date:
  • Size: 119.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for perfusio-0.1.1.tar.gz
Algorithm Hash digest
SHA256 3fd0b75bdce846648d3b012f940e33d9fc40c4f35d6233b8796cdafb4636aa0c
MD5 8e4bb583c907bab18c4d0c3a6ae9db08
BLAKE2b-256 135d07be08426f82d7749386a944b716eacb037fe1a0cd15f0a28333c0039570

See more details on using hashes here.

Provenance

The following attestation bundles were made for perfusio-0.1.1.tar.gz:

Publisher: release.yml on lynchaos/perfusio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file perfusio-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: perfusio-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 118.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for perfusio-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ac65b99f11c8539f8b98df6f76ca9e126d3b31755c7135bfdeacc00368958b43
MD5 dc509c74b26bfe9de764f963bedfe8aa
BLAKE2b-256 f65f3fb1deca88e25fbc0803bfe7287ddea2b926a09763b3d588694f95bdf55e

See more details on using hashes here.

Provenance

The following attestation bundles were made for perfusio-0.1.1-py3-none-any.whl:

Publisher: release.yml on lynchaos/perfusio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page