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. The container image 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.0

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.0
File Size Uploaded Provenance Actions
pyadata_cli-0.17.0.tar.gz 207.3 kB With provenance Details for pyadata_cli-0.17.0.tar.gz

Built distribution (wheel)

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

Total release size: 455.0 kB

Release files / pyadata_cli-0.17.0.tar.gz

Download URL pyadata_cli-0.17.0.tar.gz
Size 207.3 kB
Tags Source
SHA-256 checksum
How to use checksums
c6fbcf88ffe51e596c3e0dd5e39741fff1e7f47f856dc12df1cced963e20bf64
BLAKE2b-256 checksum
How to use checksums
111544ceb9efd68a2de67c8113f7dcedbeb3d742621edcd6a23f53eb03568022
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 Oct 26, 2026.

Transparency log

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

Download URL pyadata_cli-0.17.0-py3-none-any.whl
Size 247.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fe2f74a123df8ddcef73edfd676538c94ff822e73cca810072daae9da8a05d60
BLAKE2b-256 checksum
How to use checksums
36994f3347b9afbe4fcee1314d42553440664bf4e57c394b57a514abc873e822
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 Oct 26, 2026.

Transparency log

Security for pyadata-cli 0.17.0

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.0.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 Oct 26, 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