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
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.