Skip to main content

adata-cli

Explore and edit huge AnnData stores (.h5ad and .zarr) from the command line, without loading them into memory and without a Python session. adata inspects, subsets, splits, concatenates, recasts and converts stores, and moves elements in and out as CSV, JSON, .npy, .mtx or images. It implements the AnnData on-disk spec directly against h5py and zarr, so it streams stores larger than RAM. It reads 10x, STARsolo, Visium, Xenium, CellBender, Parse, loom, MuData and more, and writes 10x, loom and MuData.

Documentation: https://cellgeni.github.io/adata-cli/

Quick start

pip install pyadata-cli

adata view data.h5ad
adata subset data.h5ad -o cortex.h5ad --obs-query "cluster == Cortex_2"
adata convert filtered_feature_bc_matrix.h5 -o counts.h5ad

The command is adata; the distribution is pyadata-cli, because adata-cli was taken on PyPI. pip install 'pyadata-cli[pickle]' adds pycisTopic pickles, and 'pyadata-cli[spatial]' Visium HD. The container image, with both, is quay.io/cellgeni/adata-cli:

docker run --rm -v "$PWD":/data quay.io/cellgeni/adata-cli:latest adata view /data/data.h5ad

Documentation

Page
Getting started Install, then a first session: inspect, export, subset, import, convert
Guides Inspect and export, subset and split, concatenate, recast, convert formats, pipelines and containers
Reference Every command and flag, each format, query expressions, the on-disk spec, benchmarks
Troubleshooting Error messages and their fixes
Developers Layout, layers, the rules the code relies on, tests, releases

The pages are also readable on GitHub in docs/.

Repository

Path Contents
src/adata/cli.py, commands/ The command-line app, and one module per command
src/adata/core/ The streaming algorithms: subset, concat, recast, the out-of-core transpose, queries
src/adata/elements/, storage/ The AnnData on-disk spec, over h5py and zarr alike
src/adata/conversion/, formats/ convert's formats, and the file types of export and import
tests/ The test suite, including anndata compatibility and complexity guards
benchmarks/ The comparison against anndata and scanpy, rerun on every release
docs/ Documentation site
Dockerfile The quay.io/cellgeni/adata-cli image
.github/workflows/ Tests, PyPI and image publishing, benchmarks

Changes

See the changelog.

Licence

MIT

Metadata

Release files for pyadata-cli 0.17.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for pyadata-cli 0.17.6
File Size Uploaded Provenance Actions
pyadata_cli-0.17.6.tar.gz 295.7 kB With provenance Details for pyadata_cli-0.17.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for pyadata-cli 0.17.6
File Interpreter ABI Platform Actions
pyadata_cli-0.17.6-py3-none-any.whl Python 3 none any Details for pyadata_cli-0.17.6-py3-none-any.whl

Total release size: 635.4 kB

Release files / pyadata_cli-0.17.6.tar.gz

Download URL pyadata_cli-0.17.6.tar.gz
Size 295.7 kB
Tags Source
SHA-256 checksum
How to use checksums
83f99bcc856d44cf260429d28f864fb96f475837c4b7a877550146c1a9ba96e2
BLAKE2b-256 checksum
How to use checksums
25af7dd477c2967c4c6fd931f358bc8d4e9c23658ed08f58b6ed995de659c665
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 4, 2026.

Transparency log

Release files / pyadata_cli-0.17.6-py3-none-any.whl

Download URL pyadata_cli-0.17.6-py3-none-any.whl
Size 339.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b668b559499ffc248eaa5af2f63e76255a255c5389202f25756c6ed0e0b78e44
BLAKE2b-256 checksum
How to use checksums
11377dcd3ae28624d65ef87fa22092c71f8a7485251612006dacf2011d998712
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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 Nov 4, 2026.

Transparency log

Security for pyadata-cli 0.17.6

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for pyadata_cli-0.17.6.tar.gz

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 Nov 4, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page