Skip to main content
GitHub CI build status https://coveralls.io/repos/github/Edinburgh-Genome-Foundry/bioprinter/badge.svg?branch=master

Bioprinter (webpage here) is a Python package for producing living art. It transforms an image into files that a liquid dispenser can use to print the image to a plate using pigmented yeast or bacteria.

Here are two examples of bio-art:

https://raw.githubusercontent.com/Edinburgh-Genome-Foundry/bioprinter/master/docs/_static/images/bioprint_dolly.jpeg

Dolly drawn with baker yeast (white), violacein-producing yeast (black), and carotene-producing yeast (orange).

https://raw.githubusercontent.com/Edinburgh-Genome-Foundry/bioprinter/master/docs/_static/images/bioprint_england.jpeg

British flag drawn with 3 different strains of the bacterium E. coli.

These bio-prints (and many others!) were presented at the University of Edinburgh’s SynthSys Open days 2016 (strain selection and acoustic printing by Paulina Kanigowska).

Bioprinter is released on Github under the MIT license (Copyright 2015 Edinburgh Genome Foundry, University of Edinburgh), everyone is welcome to contribute!

Bioprinter was written at the Edinburgh Genome Foundry by Zulko after an original idea and Matlab code by Mike Shen (project on Github).

Installation

If you have PIP installed:

pip install bioprinter

Usage

The image file to be printed can have any resolution, but note that the width/height ratio of the plate the image is printed on is 1.5. Ensure that a specific color is used to mark the un-pigmented background of the image, here we use blue:

https://raw.githubusercontent.com/Edinburgh-Genome-Foundry/bioprinter/master/docs/_static/images/dolly.jpeg

Run the following code in Python or save in dolly.py:

from bioprinter import bioprint

bioprint(
    image_filename="/path/to/image/dolly.jpeg",
    output_filename="dolly.csv",
    bg_color=[0, 0, 255],  # blue background represents empty wells
    pigments_wells={"A1": [0, 0, 0],        # black yeast in source well A1
                    "A2": [250, 120, 10],   # orange yeast in well A2
                    "A3": [255, 255, 255]}, # white yeast in well A3
    quantified_image_filename="dolly_preview.jpeg"
)

The saved script can be executed in a terminal with python dolly.py. This will produce a dolly.csv file as well as a preview image of the final printing (so that you can check if the image looks good at this low resolution).

Prepare a source plate with the right pigmented yeasts in wells A1, A2, A3, use an agar plate as the destination plate, and feed dolly.csv to the Labcyte Echo Acoustic Liquid Handler (tested with Labcyte Echo 555 Series). Once the printing is finished, incubate 2 days at 30C (it would be one day at 37C for bacteria). Enjoy the result!

Metadata

Release files for bioprinter 0.1.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bioprinter 0.1.6
File Size Uploaded
bioprinter-0.1.6.tar.gz 6.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for bioprinter 0.1.6
File Interpreter ABI Platform
bioprinter-0.1.6-py3-none-any.whl Python 3 none any Details

Total release size: 14.8 kB

Release files / bioprinter-0.1.6.tar.gz

Download URL bioprinter-0.1.6.tar.gz
Size 6.8 kB
Tags Source
SHA-256 checksum
How to use checksums
33bb717a87a7541eff7a767f515e6691dd7b5128f5837c594ac4ffe1c62f04e0
BLAKE2b-256 checksum
How to use checksums
12b0848c0f6376007570466df35ebdcf0fe9ff05a9f0b95c28742d00f0d25684
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 9, 2025.

Transparency log

Release files / bioprinter-0.1.6-py3-none-any.whl

Download URL bioprinter-0.1.6-py3-none-any.whl
Size 8.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ed9d2bf963324573053093f6821d76a69787e2e7fe8e6eecf3012b11f258e1d9
BLAKE2b-256 checksum
How to use checksums
a0cebfb4476c60a6fd932590d3d25c6e935b65ce774e072bc3b586b59ad0c21d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.12.9

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Apr 9, 2025.

Transparency log

Release history Release notifications | RSS feed

This release

0.1.6 This release

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

1 release file

0.1.1

1 release file

0.1.0

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page