fastccc 0.1.4

A permutation-free framework for scalable, robust, and reference-based cell-cell communication analysis in single cell transcriptomics studies.

FastCCC: A permutation-free framework for scalable, robust, and reference-based cell-cell communication analysis in single cell transcriptomics studies.

   

[2026.05.09] New: FastCCC now provides an automated HTML report generation feature (fastccc.report.generate_report). After running FastCCC, a single function call produces a self-contained interactive report with 24 publication-quality figures covering global CCC overview, ligand–receptor analysis, pathway enrichment, cell-type profiles, network analyses, and — when two conditions are provided — a differential comparison tab. See the Report Tutorial for details.

[2025.02.01] Update: To minimize the size of transmitted panel data, we leverage FastCCC’s speed to compute essential reference data during first-time usage. This process incurs only an additional 1–2 minutes during initial activation. Meanwhile, the storage requirement for uploading the panel data has been significantly reduced (from 3GB to 5MB per tissue panel).

[2025.01.23] We have provided a comprehensive tutorial on the usage of FastCCC, which includes detailed instructions on installation, usage, and more. We highly recommend referring to this tutorial for a step-by-step guide.

Overview

Detecting cell-cell communications (CCCs) in single-cell transcriptomics studies is fundamental for understanding the function of multicellular organisms. Here, we introduce FastCCC, a permutation-free framework that enables scalable, robust, and reference-based analysis for identifying critical CCCs and uncovering biological insights. FastCCC relies on fast Fourier transformation-based convolution to compute $p$-values analytically without permutations, introduces a modular algebraic operation framework to capture a broad spectrum of CCC patterns, and can leverage atlas-scale single cell references to enhance CCC analysis on user-collected datasets. To support routine reference-based CCC analysis, we constructed the first human CCC reference panel, encompassing 19 distinct tissue types, over 450 unique cell types, and approximately 16 million cells. We demonstrate the advantages of FastCCC across multiple datasets, most of which exceed the analytical capabilities of existing CCC methods. In real datasets, FastCCC reliably captures biologically meaningful CCCs, even in highly complex tissue environments, including differential interactions between endothelial and immune cells linked to COVID-19 severity, dynamic communications in thymic tissue during T-cell development, as well as distinct interactions in reference-based CCC analysis.

Installation

Method 1: Installing via conda

You can install the environment using Conda by following the steps:

conda create -n FastCCC python=3.11
conda activate FastCCC

Get FastCCC from github:

git clone https://github.com/Svvord/FastCCC.git

Go to the folder FastCCC and install:

cd ./FastCCC
pip install -e .

Method 2: Installing via pip

pip install fastccc

Method 3: Installing developing version via Poetry

For developing, we are using the Poetry package manager. To install Poetry, follow the instructions here.

git clone https://github.com/Svvord/FastCCC.git
cd ./FastCCC
poetry install

Method 4: Installing developing version via uv

Alternatively, you can use uv for a faster setup. To install uv, follow the instructions here.

git clone https://github.com/Svvord/FastCCC.git
cd ./FastCCC
uv sync

To also install development dependencies:

uv sync --group dev

How to use FastCCC

Check our vignettes.

Citing the work

If you find the FastCCC package or any of the source code in this repository useful for your work, please cite:

Hou, S., Ma, W. & Zhou, X. FastCCC: a permutation-free framework for scalable, robust, and reference-based cell-cell communication analysis in single cell transcriptomics studies. Nat Commun 16, 11428 (2025). https://doi.org/10.1038/s41467-025-66272-z

@article{hou_fastccc_2025,
	title = {{FastCCC}: a permutation-free framework for scalable, robust, and reference-based cell-cell communication analysis in single cell transcriptomics studies},
	author = {Hou, Siyu and Ma, Wenjing and Zhou, Xiang},
	journal = {Nature Communications},
	volume = {16},
	year = {2025},
	eid = {11428},
	doi = {10.1038/s41467-025-66272-z},
	url = {https://www.nature.com/articles/s41467-025-66272-z}
}

Visit our group website for more statistical tools on analyzing genetics, genomics and transcriptomics data.