scvi-tools

Train probabilistic generative models on AnnData counts for single-cell omics analysis.

783|65|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/LeonChaoX/qinyan-academic-skills --skill scvi-tools-leonchaox
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: scvi-tools
Source: https://github.com/LeonChaoX/qinyan-academic-skills/tree/main/skills/05-%E7%94%9F%E7%89%A9%E4%BF%A1%E6%81%AF%E4%B8%8E%E5%9F%BA%E5%9B%A0%E7%BB%84%E5%AD%A6/scvi-tools
Command: npx skills add https://github.com/LeonChaoX/qinyan-academic-skills --skill scvi-tools-leonchaox

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

scvi-tools helps you analyze single-cell omics data with probabilistic deep generative models, solving batch effects and enabling statistically principled downstream tasks like differential expression with uncertainty.

Core Features & Use Cases

  • Probabilistic batch correction & integration: Learn latent, batch-corrected embeddings for clustering and analysis across studies and donors.
  • Modality-specific modeling: Use appropriate models for RNA (scVI/scANVI), ATAC/accessibility (PeakVI/PoissonVI/scBasset), multimodal RNA+protein (totalVI), multimodal RNA+ATAC (MultiVI), and spatial transcriptomics (DestVI, Stereoscope, etc.).
  • Uncertainty-aware differential expression: Perform Bayesian differential expression (e.g., with FDR control) that accounts for dropout/zero inflation and batch structure.

Use case example: You have multiple batches of single-cell RNA-seq data and want an integrated low-dimensional representation plus batch-aware differential expression between two cell types, without relying on ad-hoc normalization or pseudocount heuristics.

Quick Start

Run scvi-tools on your AnnData counts to train a scVI model, extract the latent embedding, and then perform differential expression between two groups.

Frequently Asked Questions about scvi-tools

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I perform batch correction on single-cell RNA-seq data across multiple donors?

To perform batch correction on single-cell RNA-seq data, this tool learns probabilistic generative models to produce latent, batch-corrected embeddings. You need to provide AnnData inputs with raw count layers, configure the model setup, and run variational inference training to get the integrated low-dimensional representation.

Can I do differential expression analysis with uncertainty and FDR control for scRNA-seq?

Yes, you can perform Bayesian differential expression for scRNA-seq with FDR control. This approach accounts for dropout and zero inflation while respecting batch structure, providing statistically principled differential expression results without relying on ad-hoc normalization or pseudocount heuristics.

What is the best way to integrate multimodal single-cell RNA and ATAC data?

The best way to integrate multimodal RNA and ATAC data is using modality-specific probabilistic models like MultiVI. By training variational inference models on AnnData objects with raw counts, you achieve a unified latent representation that captures both gene expression and chromatin accessibility.

Does single-cell probabilistic modeling work with spatial transcriptomics deconvolution?

Yes, probabilistic modeling works for spatial transcriptomics deconvolution using models like DestVI and Stereoscope. These approaches learn latent representations from raw count data to estimate cell type proportions and abundance within spatial spots.

Do I need raw counts in my AnnData object to use probabilistic single-cell models?

Yes, you need raw counts in your AnnData object to use these probabilistic single-cell models. The models require modality-appropriate likelihood handling and use the setup_anndata function to configure raw count layers before initiating variational inference training.

When should I not use deep generative models for single-cell integration?

You should not use deep generative models for single-cell integration if your dataset lacks raw count layers or if your environment cannot support variational inference training. Additionally, if your analysis does not require uncertainty-aware downstream tasks, simpler normalization methods may be more appropriate.