Skip to main content

Deep probabilistic analysis of single-cell omics data.

Project description


Stars PyPI Documentation Status Build Status Coverage Code Style Downloads Join the chat at

scvi-tools (single-cell variational inference tools) is a package for probabilistic modeling of single-cell omics data, built on top of PyTorch and AnnData.

Available implementations of single-cell omics models

scvi-tools contains scalable implementations of several models that facilitate a broad number of tasks across many omics, including:

  • scVI for analysis of single-cell RNA-seq data, as well as its improved differential expression framework.
  • scANVI for cell annotation of scRNA-seq data using semi-labeled examples.
  • totalVI for analysis of CITE-seq data.
  • gimVI for imputation of missing genes in spatial transcriptomics from scRNA-seq data.
  • AutoZI for assessing gene-specific levels of zero-inflation in scRNA-seq data.
  • LDVAE for an interpretable linear factor model version of scVI.
  • Stereoscope for deconvolution of spatial transcriptomics data.
  • peakVI for analysis of ATAC-seq data.
  • scArches for transfer learning from one single-cell atlas to a query dataset (currently supports scVI, scANVI and TotalVI).
  • CellAssign for reference-based annotation of scRNA-seq data.
  • Solo for doublet detection in scRNA-seq data.

All these implementations have a high-level API that interacts with scanpy, standard save/load functions, and support GPU acceleration.

Fast prototyping of novel probabilistic models

scvi-tools contains the building blocks to prototype novel probablistic models. These building blocks are powered by popular probabilistic and machine learning frameworks such as PyTorch Lightning, and Pyro.

We recommend checking out the skeleton repository, as a starting point for developing new models into scvi-tools.

Basic installation

For conda,

conda install scvi-tools -c bioconda -c conda-forge

and for pip,

pip install scvi-tools

Please be sure to install a version of PyTorch that is compatible with your GPU (if applicable).


  • Tutorials, API reference, and installation guides are available in the documentation.
  • For discussion of usage, checkout out our forum.
  • Please use the issues here to submit bug reports.
  • If you'd like to contribute, check out our contributing guide.
  • If you find a model useful for your research, please consider citing the corresponding publication (linked above).

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for scvi-tools, version 0.9.0
Filename, size File type Python version Upload date Hashes
Filename, size scvi_tools-0.9.0-py3-none-any.whl (183.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size scvi-tools-0.9.0.tar.gz (140.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page