Scirpy is a scalable python-toolkit to analyse T cell receptor (TCR) or B cell receptor (BCR) repertoires from single-cell RNA sequencing (scRNA-seq) data. It seamlessly integrates with the popular scanpy library and provides various modules for data import, analysis and visualization.

Getting started

Please refer to the documentation. In particular, the

In the documentation, you can also learn more about our immune-cell receptor model.


The case study from our preprint is available here.


You need to have Python 3.7 or newer installed on your system. If you don't have Python installed, we recommend installing Miniconda.

There are several alternative options to install scirpy:

  1. Install the latest release of scirpy from PyPI:
    pip install scirpy
  1. Get it from Bioconda:
    conda install -c conda-forge -c bioconda scirpy
  1. Install the latest development version:
    pip install git+[email protected]
  1. Run it in a container using Docker or Podman:
    docker pull<tag>

where tag is one of these tags.