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) 2026, Yosef Lab, Weizmann Institute of Science
3 maintainers
Release files for scvi-tools 1.5.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| scvi_tools-1.5.1.tar.gz | 13.4 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| scvi_tools-1.5.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size:14.1 MB
Release files / scvi_tools-1.5.1.tar.gz
| Download URL | scvi_tools-1.5.1.tar.gz |
|---|---|
| Size | 13.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
413cab3a8b8865bb42712c1239ab3b1e78960e0739df844128d3577c1556fb18
|
|
BLAKE2b-256 checksum How to use checksums |
be63fd51ab922d3f7a0363e0104babcc7ad0925947e716c75c717506eee3ddc6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 10, 2026.
Transparency logRelease files / scvi_tools-1.5.1-py3-none-any.whl
| Download URL | scvi_tools-1.5.1-py3-none-any.whl |
|---|---|
| Size | 731.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
89fcd8f1a8e19f1a1fbe1c409e1969a838f6b57b3dc032934836a31d5ef8b837
|
|
BLAKE2b-256 checksum How to use checksums |
5bc1e08e12a980981bac331883cd0c31a78a5b17edf6be5b0b15b4a27e8b0630
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 10, 2026.
Transparency log
