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, Simone and others},
  title   = {Clone selection in cell culture development using
             multi-objective Bayesian optimisation with
             entity-embedding transfer learning},
  journal = {Computers \& Chemical Engineering},
  year    = {2021},
  volume  = {151},
  pages   = {107373},
}

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.0.tar.gz (119.0 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.0-py3-none-any.whl (118.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: perfusio-0.1.0.tar.gz
  • Upload date:
  • Size: 119.0 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.0.tar.gz
Algorithm Hash digest
SHA256 16c7a755441fc5f0e797faf208e8c87820c58afee62699448ffc01f66e8c53aa
MD5 d59945441d31336f65115562affe460d
BLAKE2b-256 a51b86d143bb849bf02374ae60abcfb7272e5cd7b3fd758ba0c7d0529586659a

See more details on using hashes here.

Provenance

The following attestation bundles were made for perfusio-0.1.0.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.0-py3-none-any.whl.

File metadata

  • Download URL: perfusio-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 118.5 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 712af3931179d6b335bac4e2acf2fb65034f1e63cf8fc086f31a8c6763021375
MD5 17135555938ea6202a8e259c889ce8b4
BLAKE2b-256 1ca681e375a02b6fc0fdf080bd518200dec7136527d829170eaceefd34371cbc

See more details on using hashes here.

Provenance

The following attestation bundles were made for perfusio-0.1.0-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