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, and converts to and from 10x, STARsolo, Visium, Xenium, CellBender, Parse, loom, MuData and more.

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.5

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.5
File Size Uploaded Provenance Actions
pyadata_cli-0.17.5.tar.gz 268.6 kB With provenance Details for pyadata_cli-0.17.5.tar.gz

Built distribution (wheel)

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

Total release size: 580.6 kB

Release files / pyadata_cli-0.17.5.tar.gz

Download URL pyadata_cli-0.17.5.tar.gz
Size 268.6 kB
Tags Source
SHA-256 checksum
How to use checksums
8c343ddf92672933887f02d98abca7770ce24b9344e684877af98cda7fc716c4
BLAKE2b-256 checksum
How to use checksums
36a96c2ad3397f3286e49fc8ef14e8257518412aea89f4ad4baeb8f0e8b4437b
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 2, 2026.

Transparency log

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

Download URL pyadata_cli-0.17.5-py3-none-any.whl
Size 312.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b312b7a1141ef0de5139358e478b064ffbb607bc0fbe1982bb0f71389a4e7a3a
BLAKE2b-256 checksum
How to use checksums
02cd6524ea0675ec9431f8d58d6814ae7973e86228f666ee9c0d546a6faf7ba8
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 2, 2026.

Transparency log

Security for pyadata-cli 0.17.5

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.5.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 2, 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