OmicVerse is the fundamental package for multi omics included bulk ,single cell and spatial RNA-seq analysis with Python. For more information, please read our paper: OmicVerse: a framework for bridging and deepening insights across bulk and single-cell sequencing
Star History
1 Introduction
OmicVerse v2 is a unified Python project for modern transcriptomics and multi-omics analysis. It brings together bulk RNA-seq, single-cell, spatial transcriptomics, downstream visualization, model-based analysis, and AI-assisted workflows in one package and documentation system.
2 Directory structure
.
├── omicverse # Main Python package
├── omicverse_guide # Documentation files
├── omicverse_web # Web Analysis Platform
├── sample # Some test data
├── LICENSE
└── README.md
3 General Getting Started
OmicVerse can be installed via conda or pypi and you need to install pytorch at first. Please refer to the installation tutorial for more detailed installation steps and adaptations for different platforms (Windows, Linux or Mac OS).
You can use conda install omicverse -c conda-forge or pip install -U omicverse for installation.
Please checkout the documentations and tutorials at omicverse page or omicverse.readthedocs.io.
4 J.A.R.V.I.S Getting Started
4.1 OpenClaw
OmicVerse provide an directly interact analysis with OpenClaw project. You can use
omicverse claw 'help me annotate the lung scrna-seq'
This module supported by ov.Agent function. And i think that will be convinent for you to analysis the anndata using OpenClaw.
The full tutorial could be found at here
4.2 MCP Server (Model Context Protocol)
OmicVerse provide an MCP server that exposes registered analysis tools to AI assistants (Claude Code, etc.) via the standard Model Context Protocol.
# Install with MCP dependencies
pip install -e "omicverse[mcp]"
# Start the server (stdio transport)
python -m omicverse.mcp # or: omicverse-mcp
python -m omicverse.mcp --phase P0 # core pipeline tools only
The full tutorial could be found at here
4.3 J.A.R.V.I.S Msg system
If you want to analysis the AnnData using Mobile Phone, maybe you can try
# Install with jarvis dependencies
pip install "omicverse[jarvis]"
# Start to chat with JARVIS using telegram
omicverse jarvis --channel telegram --token "$TELEGRAM_BOT_TOKEN"
The full tutorial could be found at here
4 Data Framework and Reference
The omicverse is implemented as an infrastructure based on the following four data structures.
The table contains the published tools included in OmicVerse.
| Scanpy 📦 📖 |
dynamicTreeCut 📦 📖 |
scDrug 📦 📖 |
MOFA 📦 📖 |
COSG 📦 📖 |
CellPhoneDB 📦 📖 |
| AUCell 📦 📖 |
Bulk2Space 📦 📖 |
SCSA 📦 📖 |
WGCNA 📦 📖 |
StaVIA 📦 📖 |
PyDESeq2 📦 📖 |
| NOCD 📦 📖 |
SIMBA 📦 📖 |
GLUE 📦 📖 |
MetaTiME 📦 📖 |
TOSICA 📦 📖 |
Harmony 📦 📖 |
| Scanorama 📦 📖 |
Combat 📦 📖 |
TAPE 📦 📖 |
SEACells 📦 📖 |
Palantir 📦 📖 |
STAGATE 📦 📖 |
| scVI 📦 📖 |
MIRA 📦 📖 |
Tangram 📦 📖 |
STAligner 📦 📖 |
CEFCON 📦 📖 |
PyComplexHeatmap 📦 📖 |
| STT 📦 📖 |
SLAT 📦 📖 |
GPTCelltype 📦 📖 |
PROST 📦 📖 |
GraphST 📦 📖 |
|
| COMPOSITE 📦 📖 |
mellon 📦 📖 |
starfysh 📦 📖 |
COMMOT 📦 📖 |
flowsig 📦 📖 |
pyWGCNA 📦 📖 |
| CAST 📦 📖 |
scMulan 📦 📖 |
cellANOVA 📦 📖 |
BINARY 📦 📖 |
GASTON 📦 📖 |
pertpy 📦 📖 |
| inmoose 📦 📖 |
memento 📦 📖 |
GSEApy 📦 📖 |
marsilea 📦 📖 |
scICE 📦 📖 |
sude 📦 📖 |
| Geneformer 📦 📖 |
scGPT 📦 📖 |
scFoundation 📦 📖 |
UCE 📦 📖 |
CellPLM 📦 📖 |
kb-python 📦 📖 |
| Scaden 📦 📖 |
BayesPrism 📦 📦 📖 |
InstaPrism 📦 📖 |
CellTypist 📦 📖 |
latentvelo 📦 📖 |
graphvelo 📦 📖 |
| scvelo 📦 📖 |
Dynamo 📦 📖 |
CONCORD 📦 📖 |
FlashDeconv 📦 📖 |
Hotspot 📦 📖 |
Banksy 📦 📖 |
| STAR 📦 📖 |
fastp 📦 📖 |
featureCounts 📦 📖 |
edgeR 📦 📖 |
spaco 📦 📖 |
gsMap 📦 📖 |
| Monocle 2 📦 📖 |
cell2location 📦 📖 |
bin2cell 📦 📖 |
CellCharter 📦 📖 |
SpaceFlow 📦 📖 |
SpatialDE 📦 📖 |
| DoubletFinder 📦 📖 |
scTenifoldKnk 📦 📖 |
scFEA 📦 📖 |
scMetabolism 📦 📖 |
MEBOCOST 📦 📖 |
Compass 📦 📖 |
Included Package not published or preprint
- [1] Cellula is to provide a toolkit for the exploration of scRNA-seq. These tools perform common single-cell analysis tasks
- [2] pegasus is a tool for analyzing transcriptomes of millions of single cells. It is a command line tool, a python package and a base for Cloud-based analysis workflows.
- [3] cNMF is an analysis pipeline for inferring gene expression programs from single-cell RNA-Seq (scRNA-Seq) data.
5 Contact
- Zehua Zeng (starlitnightly@gmail.com or zehuazeng@xs.ustb.edu.cn)
- Lei Hu (hulei@westlake.edu.cn)
6 Developer Guild and Contributing
If you would like to contribute to omicverse, please refer to our developer documentation.
Running tests locally
Install the test dependencies and execute the suite with pytest:
pip install -e .[tests]
# or install the pinned latest requirements
pip install -r requirements-latest.txt
pytest
The optional tests extra and the requirements-latest.txt file now include pytest-asyncio>=0.23, which is required for the asynchronous streaming tests under tests/utils/.
 |
|---|
7 Citation
If you use omicverse in your work, please cite the omicverse publication as follows:
OmicVerse: a framework for bridging and deepening insights across bulk and single-cell sequencing
Zeng, Z., Ma, Y., Hu, L. et al.
Nature Communication 2024 Jul 16. doi: 10.1038/s41467-024-50194-3.
Here are some other related packages, feel free to reference them if you use them!
OmicOS: A Comprehensive Omics Ecosystem Infrastructure and Agent System for the AI Era
Zeng, Z., Meng, X., Hu, L. et al.
Biorxiv 2026 Jun 16. doi: 10.64898/2026.06.11.731775.
CellOntologyMapper: Consensus mapping of cell type annotation
Zeng, Z., Wang, X., Du, H. et al.
imetaomics 2025 Nov 06. doi: 10.1002/imo2.70064.
8 Other
If you would like to sponsor the development of our project, you can go to the afdian website (https://ifdian.net/a/starlitnightly) and sponsor us.
1 maintainer
Release files for omicverse 2.3.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| omicverse-2.3.2.tar.gz | 13.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| omicverse-2.3.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 28.6 MB
Release files / omicverse-2.3.2.tar.gz
| Download URL | omicverse-2.3.2.tar.gz |
|---|---|
| Size | 13.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5e8aa9cf514512cc5554160a767c036fa916eb6d58697c9f1198eb0195c76ca8
|
|
BLAKE2b-256 checksum How to use checksums |
307ec327581f9df56e615f24cb2d2349afb0ee5e40006ed474bd862ef29ac1be
|
| 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 23, 2026.
Transparency logRelease files / omicverse-2.3.2-py3-none-any.whl
| Download URL | omicverse-2.3.2-py3-none-any.whl |
|---|---|
| Size | 14.9 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
722d47deb79e52aa871c6c025c4b0641810a34a119107ff07817b3eb068f4406
|
|
BLAKE2b-256 checksum How to use checksums |
28c7cbc0876e1b60b9fd252d02823d1fa384befff33912b8e7458648804f415f
|
| 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 23, 2026.
Transparency log
