scArches requires scvi-tools as the backbone, to be on the safe side please install scvi-tools-0.8.1. Newer versions might produce errors on compatibility with scArches


From version 0.3.0 we moved to PyTorch, however you can still install latest Tensoflow version by installing 0.2.4.

scArches requires Python 3.6 or 3.7. We recommend to use Miniconda.


The easiest way to get scArches is through pip using the following command:

sudo pip install -U scarches


You can also get the latest development version of scArches from Github using the following steps: First, clone scArches using git:

git clone

Then, cd to the scArches folder and run the install command:

cd scarches
python3 install

On Windows machines you may need to download a C++ compiler if you wish to build from source yourself.


The list of dependencies for scArches can be found in the requirements.txt file in the repository.

If you run into issues, do not hesitate to approach us or raise a GitHub issue.