Skip to main content

Logomark 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)

Source distribution for pysynthbio 4.2.4
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)

Table of built distributions (wheels) for pysynthbio 4.2.4
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

4.2.4 This release

2 release files Full provenance

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