Installation

Quick install

dynamo can be installed via conda or pip. We recommend installing into a virtual environment to avoid conflicts with other packages.

conda install -c conda-forge dynamo-release

or

pip install dynamo-release

To install the newest version of dynamo, you can git clone our repo and then pip install:

git clone https://github.com/aristoteleo/dynamo-release.git
pip install dynamo-release/ --user

Don’t know how to get started with virtual environments or conda/pip? Check out the prerequisites section.

Prerequisites

Virtual environment

A virtual environment can be created with either conda or venv. We recommend using conda. We currently support Python 3.10 - 3.12.

For conda, we recommend using the Miniforge distribution, which is generally faster than the official distribution and comes with conda-forge as the default channel (where dynamo is hosted).

conda create -n dynamo-env python=3.10  # any python 3.10 to 3.12
conda activate dynamo-env

For venv, we recommend using uv.

pip install -U uv
uv venv .dynamo-env
source .dynamo-env/bin/activate  # for macOS and Linux
.scvi-env\Scripts\activate  # for Windows