> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synthesize.bio/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install pysynthbio from PyPI, source, or a GitHub release.

## Prerequisites

To use `pysynthbio`, first create an account at [app.synthesize.bio](https://app.synthesize.bio/).

If you want to store your API token in the system keyring, you'll also need the optional `keyring` package. It's installed by default in `pysynthbio` 2.2.1 and later.

## Standard installation

Install the latest stable version from PyPI:

```bash theme={null}
pip install pysynthbio
```

Verify the install:

```bash theme={null}
pip show pysynthbio
```

## Development installation

Install the latest development version directly from GitHub:

```bash theme={null}
git clone https://github.com/synthesizebio/pysynthbio.git
cd pysynthbio
pip install -e .
```

## Installing from a GitHub release

You can also install a specific tagged version directly from a GitHub release. This is useful for testing pre-releases or pinning to a specific tag.

<Steps>
  <Step title="Find the release">
    Go to the [releases page](https://github.com/synthesizebio/pysynthbio/releases) and find the tag you want, such as `v3.0.2`.
  </Step>

  <Step title="Download the asset">
    Expand the release's **Assets** section and download the `.whl` (preferred) or `.tar.gz`.
  </Step>

  <Step title="Install with pip">
    ```bash theme={null}
    # Wheel
    pip install /path/to/pysynthbio-3.0.2-py3-none-any.whl

    # Source distribution
    pip install /path/to/pysynthbio-3.0.2.tar.gz
    ```
  </Step>
</Steps>

<Card title="Next: Get started" icon="arrow-right" href="/pysynthbio/getting-started">
  Authenticate and make your first prediction.
</Card>