Skip to main content

Deep probabilistic analysis of single-cell omics data.

Project description

scvi-tools

Stars PyPI PyPIDownloads CondaDownloads Docs Build Coverage

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

Analysis of single-cell omics data

scvi-tools is composed of models that perform many analysis tasks across single-cell, multi, and spatial omics data:

  • Dimensionality reduction
  • Data integration
  • Automated annotation
  • Factor analysis
  • Doublet detection
  • Spatial deconvolution
  • and more!

In the user guide, we provide an overview of each model. All model implementations have a high-level API that interacts with Scanpy and includes standard save/load functions, GPU acceleration, etc.

Rapid development of novel probabilistic models

scvi-tools contains the building blocks to develop and deploy novel probabilistic models. These building blocks are powered by popular probabilistic and machine learning frameworks such as PyTorch Lightning and Pyro. For an overview of how the scvi-tools package is structured, you may refer to the codebase overview page.

We recommend checking out the skeleton repository as a starting point for developing and deploying new models with scvi-tools.

Basic installation

For conda,

conda install scvi-tools -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).

Resources

  • Tutorials, API reference, and installation guides are available in the documentation.
  • For discussion of usage, check out our forum.
  • Please use the issues 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.

Reference

If you use scvi-tools in your work, please cite

A Python library for probabilistic analysis of single-cell omics data

Adam Gayoso, Romain Lopez, Galen Xing, Pierre Boyeau, Valeh Valiollah Pour Amiri, Justin Hong, Katherine Wu, Michael Jayasuriya, Edouard Mehlman, Maxime Langevin, Yining Liu, Jules Samaran, Gabriel Misrachi, Achille Nazaret, Oscar Clivio, Chenling Xu, Tal Ashuach, Mariano Gabitto, Mohammad Lotfollahi, Valentine Svensson, Eduardo da Veiga Beltrame, Vitalii Kleshchevnikov, Carlos Talavera-López, Lior Pachter, Fabian J. Theis, Aaron Streets, Michael I. Jordan, Jeffrey Regier & Nir Yosef

Nature Biotechnology 2022 Feb 07. doi: 10.1038/s41587-021-01206-w.

along with the publication describing the model used.

You can cite the scverse publication as follows:

The scverse project provides a computational ecosystem for single-cell omics data analysis

Isaac Virshup, Danila Bredikhin, Lukas Heumos, Giovanni Palla, Gregor Sturm, Adam Gayoso, Ilia Kats, Mikaela Koutrouli, Scverse Community, Bonnie Berger, Dana Pe’er, Aviv Regev, Sarah A. Teichmann, Francesca Finotello, F. Alexander Wolf, Nir Yosef, Oliver Stegle & Fabian J. Theis

Nature Biotechnology 2023 Apr 10. doi: 10.1038/s41587-023-01733-8.

scvi-tools is part of the scverse® project (website, governance) and is fiscally sponsored by NumFOCUS.

If you like scverse® and want to support our mission, please consider making a tax-deductible donation to help the project pay for developer time, professional services, travel, workshops, and a variety of other needs.

Copyright (c) 2025, Yosef Lab, Weizmann Institute of Science

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

scvi_tools-1.4.1.tar.gz (18.3 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

scvi_tools-1.4.1-py3-none-any.whl (641.1 kB view details)

Uploaded Python 3

File details

Details for the file scvi_tools-1.4.1.tar.gz.

File metadata

  • Download URL: scvi_tools-1.4.1.tar.gz
  • Upload date:
  • Size: 18.3 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for scvi_tools-1.4.1.tar.gz
Algorithm Hash digest
SHA256 ee75eaac665618b9ee6fa466f6353ef68eb33cd3d7e2c77069e743471ca2103a
MD5 0c49338c1e42e05c2bcf1ce57e4e816e
BLAKE2b-256 ed57c5f3c7974f68f9f36d06ebbdcdb93626f9d4541c380bb6e0395395b4d7c8

See more details on using hashes here.

Provenance

The following attestation bundles were made for scvi_tools-1.4.1.tar.gz:

Publisher: release.yml on scverse/scvi-tools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file scvi_tools-1.4.1-py3-none-any.whl.

File metadata

  • Download URL: scvi_tools-1.4.1-py3-none-any.whl
  • Upload date:
  • Size: 641.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for scvi_tools-1.4.1-py3-none-any.whl
Algorithm Hash digest
SHA256 96a8325c3f56f7528fd1201c41a2fdfdcaa135ad6ffd73cce4fb61a6c2301d30
MD5 f434ba7553d90a6362fe5cf0b4dea487
BLAKE2b-256 4a8b37ee827c0cd629f85d3473577d90cd032f70d1de8bb0e5e3b222d87bb19f

See more details on using hashes here.

Provenance

The following attestation bundles were made for scvi_tools-1.4.1-py3-none-any.whl:

Publisher: release.yml on scverse/scvi-tools

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page