pysynthbio
pysynthbio is an Python package that provides a convenient interface to the Synthesize Bio API, allowing users to generate realistic gene expression data based on specified biological conditions. This package enables researchers to easily access AI-generated transcriptomic data for various modalities including bulk RNA-seq and single-cell RNA-seq.
If you'd prefer 1-click dataset generation and analysis, try our web platform.
Prerequisites
Create a Synthesize Bio account and generate an API Key.
Installation
pip install pysynthbio
Quickstart
import pysynthbio
# Set your API token (or use environment variable SYNTHESIZE_API_KEY)
pysynthbio.set_synthesize_token(use_keyring=True)
# Get an example query for the bulk RNA-seq baseline model
query = pysynthbio.get_example_query(model_id="gem-1-bulk")["example_query"]
# Generate synthetic expression data
result = pysynthbio.predict_query(query, model_id="gem-1-bulk")
# Access the results
metadata = result["metadata"]
expression = result["expression"]
Documentation
The canonical pysynthbio docs live at docs.synthesize.bio/pysynthbio.
The legacy GitHub Pages site at synthesizebio.github.io/pysynthbio redirects to the new URLs and is no longer updated. The MDX source for the customer-facing docs lives in docs-external/ and is aggregated into docs-external by the Mintlify multirepo workflow.
Questions? Suggestions? Support?
Email us at support@synthesize.bio. We'd love to hear from you!
Hosted GEM-2 operations
Use predict_query(..., model_id="gem-2") for a release that supports the requested
operation. GEM-2 uses operation to select predict-expression,
predict-expression-from-reference, predict-metadata, or autoencode.
The server checks support for the selected release and modality.
import pysynthbio
query = {
"operation": "predict-expression",
"inputs": {
"modality": "bulk",
"items": [{
"metadata": {
"sample_type": "primary tissue",
"library_layout": "PAIRED",
"library_selection": "cDNA",
"tissue": "liver",
"bioactive_entity_perturbations": [{"smiles": "CCO"}],
"gene_perturbations": [],
"infection_perturbations": [],
},
"num_samples": 1,
"output_total": {"type": "custom", "value": 8478},
}],
},
"options": {"seed": 42, "sampling_strategy": "mean estimation"},
}
result = pysynthbio.predict_query(query, model_id="gem-2")
SMILES and direct ChEMBL IDs require an enabled molecule release. For a ChEMBL ID,
replace {"smiles": "CCO"} with {"entity_ontology_id": "CHEMBL3261331"}.
Supply exactly one of entity, entity_ontology_id, or smiles per molecule;
entity retains the supported-name lookup. Pin a release with the optional
request field release when testing a candidate.
Expression results contain expression, metadata, and latents DataFrames.
Metadata prediction contains predicted metadata, classifier_probs, and
latents with the encoded column; its expression has one row per result and
no columns because this operation does not generate counts. Reconstruction
(autoencode) retains counts and returns a provenance DataFrame with each
row's model_release_id and vae_run_id. Its latents has no columns.
Existing GEM-2 compatibility model names also use these operation-aware formats.
raw_response=True continues to return the original response unchanged.
Metadata
Release files for pysynthbio 4.2.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| pysynthbio-4.2.4.tar.gz | 29.0 kB | With provenance | Details for pysynthbio-4.2.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| pysynthbio-4.2.4-py3-none-any.whl | Python 3 | none | any | Details for pysynthbio-4.2.4-py3-none-any.whl |
Total release size: 49.1 kB
Release files / pysynthbio-4.2.4.tar.gz
| Download URL | pysynthbio-4.2.4.tar.gz |
|---|---|
| Size | 29.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c5b210d696e4e9b5b260af5f4137cbe742c293428656bdf5385e976f57d28bfe
|
|
BLAKE2b-256 checksum How to use checksums |
4a32c7642f2fe51bb7035bcaa2464131f62429e96f09a2892b70343d79f600fa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Oct 16, 2026.
Transparency logRelease files / pysynthbio-4.2.4-py3-none-any.whl
| Download URL | pysynthbio-4.2.4-py3-none-any.whl |
|---|---|
| Size | 20.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
09939d7d97a124f93b4212c5b6b69cc7b0d036939920e4d771e4634cf349b9fe
|
|
BLAKE2b-256 checksum How to use checksums |
39bd1fadbd70d7ebc6ce0ae385669be84e1a4a473644b1005b60dbc37d813a24
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Oct 16, 2026.
Transparency logSecurity for pysynthbio 4.2.4
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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for pysynthbio-4.2.4.tar.gz
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 Oct 16, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.