A toolkit for single-cell immune profiling


Single-cell sequencing is an emerging technology in the field of immunology and oncology that allows researchers to couple RNA quantification and other modalities, like immune cell receptor profiling at the level of an individual cell. A number of workflows and software packages have been created to process and analyze single-cell transcriptomic data. These packages allow users to take the vast dimensionality of the data generated in single-cell-based experiments and distill the data into novel insights. Unlike the transcriptomic field, there is a lack of options for software that allow for single-cell immune receptor profiling. Enabling users to easily combine RNA and immune profiling, scRepertoire was built to process data derived from the 10x Genomics Chromium Immune Profiling for both T-cell receptor (TCR) and immunoglobulin (Ig) enrichment workflows and subsequently interacts with the popular Seurat R package.

R Packages Imported

scRepertoire v0.99.9 added the functionality of the powerTCR approach to comparing clone size distribution, please cite the manuscript if using the clonesizeDistribution() function.



Note Users with R versions < 4.0 or should use the dev version.


Getting Data

Unfortunately, Github limits the size of individual files. In order to access the seurat object paired with scRepetoire please download the .rda from here.

Learning To Use scRepertoire

Vignette available here, includes almost 13,000 T cells across 3 patients with renal clear cell carcinoma.

Please Cite

Feel free to use, edit, modify scRepertoire, but if you do, please cite the manuscript.


Questions, comments, suggestions, please feel free to contact Nick Borcherding via this repository, email, or using twitter.

More Information On VDJ Biology

Our publication is limited in scope and size and we were unable to review VDJ biology and issues relevant to high-throuhput immune receptor profiling. If you are interested in the biology of the process, please refer to the excellent reviews from Jahong Ji and Frederick Alt. Additionally, the complexities of sequencing and quantifications of VDJs are discussed here.

Try the scRepertoire package in your browser

Any scripts or data that you put into this service are public.

scRepertoire documentation built on Nov. 8, 2020, 7 p.m.