This release is a pre-release and may not be stable for production use.
Scarf
Single Cell Analysis on Remote Filesystems
Scarf is a Python framework for analysing single-cell RNA, ATAC, protein, and multi-omic data, from a few thousand cells to tens of millions.
| Problem | How Scarf solves it | What you get |
|---|---|---|
| Your dataset is larger than RAM | Out-of-core algorithms, and neighbour search streams from cell-major and gene-major layouts, inside a memory budget you set | No subsampling, so rare populations survive, benchmarked to 10M cells |
| The data is stored remotely and requires downloading | Fetches only the chunks an operation touches, and writes results to a store you own | Start analysing immediately, with one authoritative copy |
| A single parameter change costs hours of computation | Each step is fingerprinted by its settings and inputs, so reuse is by content, not by layer name | Only what changed recomputes, and the old version stays for comparison |
| Sub-population analysis leaves scattered copies that nobody can trace back | Subsets are masks in one file, and every result carries the cells and parameters behind it | A year later, a result still explains itself |
Install
Python 3.12+.
uv venv --python 3.12
uv pip install --python .venv "scarf[extra]"
Detailed installation instructions here
Quick start
import scarf
ds = scarf.DataStore(
"s3://bucket/10M_cells.zarr", # also gs://, hf://, or a local path
)
run = ds.pipeline.run() # durable QC → graph → UMAP → clustering → marker run
ds.plots.embedding(
run=run,
layout="umap",
color_by="clusters",
)
Read the scRNA-seq tutorial for a granular workflow, or remote stores for cloud setups.
Documentation
Read workflow vignettes and API references on Read The Docs 📖
AI-assisted and autonomous workflows should start with Analysis with AI agents.
Scarf's capabilities
| Area | Methods |
|---|---|
| Modalities | scRNA-seq, scATAC-seq, CITE-seq, matched multi-omics |
| Core workflow | Quality control, feature selection, normalization, PCA and LSI, KNN graph, UMAP, densMAP, t-SNE, Leiden, Paris, marker search |
| Integration | Harmony, partial PCA, shared and weighted nearest neighbours, integration metrics |
| Mapping | Symphony-style reference mapping, label transfer, projection diagnostics |
| Trajectory | Population Balance Analysis pseudotime, expression dynamics and modules, multi-sink fate probabilities |
| Also included | Cell-cycle scoring, gene-set activity, graph-diffusion imputation, doublet scores, HTO demultiplexing, TopACeDo downsampling, pseudobulk export |
Citation
Dhapola et al. Scarf enables a highly memory-efficient analysis of large-scale single-cell genomics data. Nature Communications 13, 4616 (2022).
Support
Scarf is open source software released under the BSD 3-Clause License and maintained by Nygen.
1 maintainer
Metadata
1 maintainer
Release files for scarf 1.0.0rc16
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| scarf-1.0.0rc16.tar.gz | 1.6 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| scarf-1.0.0rc16-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.0 MB
Release files / scarf-1.0.0rc16.tar.gz
| Download URL | scarf-1.0.0rc16.tar.gz |
|---|---|
| Size | 1.6 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2ebdedb6996abff66a92a99cf76df85bc0d13df0c285341c410970a70c4b5447
|
|
BLAKE2b-256 checksum How to use checksums |
e4fbc9c6972f5aca9301de919e6eb9cb451e50da55792fe71ae2a41fbdd57160
|
| 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 29, 2026.
Transparency logRelease files / scarf-1.0.0rc16-py3-none-any.whl
| Download URL | scarf-1.0.0rc16-py3-none-any.whl |
|---|---|
| Size | 1.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
763c0da7a50ea6e1b147c6a3a6b715552417d3920536f9192292d9e733961905
|
|
BLAKE2b-256 checksum How to use checksums |
a98ff1082624e38aff5a55964c12863b40ba0ed2c1b46e6179c4f2cefe37a2e1
|
| 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 29, 2026.
Transparency log
