Skip to content

cxg

A command-line tool for browsing and downloading public single-cell datasets from the CELLxGene Discover portal without leaving the terminal.

cxg wraps the public dataset-level REST API, complementing the official cellxgene-census SDK (which queries cells, not datasets).

Installation

Requires Python 3.11+.

Install from source with uv:

git clone https://github.com/aaronwolen/cellxgene-discover-cli.git
cd cellxgene-discover-cli
uv sync

How it works

All datasets are fetched in a single API call and cached locally as JSON. Filtering is done entirely client-side against this cache, which makes repeated queries fast and avoids unnecessary API calls.

Learn more