AnnZarro

AnnZarro is a read-only, browser-based viewer for AnnData stored as zarr. It is built around the matrices that other viewers leave out: cell-by-cell kernels and distances (obsp) and gene-by-gene similarities (varp), explored one focused cell or gene at a time and linked to the cell-by-gene layers.

pip install annzarro

This installs AnnZarro on your own computer or on a server. Or download the desktop app, or set up a shared server:

Desktop app

One person, data on your computer

macOS: Apple silicon, Intel, or brew install --cask settylab/annzarro/annzarro. Linux: AppImage, .deb. All files and checksums

  • Standalone on your laptop, no Python needed

  • Works offline

  • Your data stay on your computer

  • No login, no set-up

  • Opens local .zarr stores

Server

One server, many users in the browser

  • Multi-user access in the browser, with login

  • Panel sets shared and exchanged between users

  • Large datasets stay on the server; only the slices a view needs travel to the browser

  • Per-user dataset access control and an admin page

  • Less memory on each user’s computer

The desktop app is for one person with data on their own computer; a server shares datasets, panel sets and access.

Four linked AnnZarro panels on the demonstration data

Four linked panels on the demonstration data: a diffusion walk from the focused cell, a differential expression volcano coloured by correlation with the focused gene, the gene’s fold change on the UMAP, and a filtered cell table.

Getting started

Install from PyPI or the desktop app and open your first dataset.

Getting started
User guide

Focus, lock, panels, tables, panel sets, share links and export.

User guide
Preparing data

Which slot drives which view, chunking, Kompot outputs and the demonstration data.

Preparing data
Tutorials

Cell similarity beyond the UMAP, gene programmes beyond clusters, and where a gene changes.

Tutorials
Deployment

Desktop, personal server over SSH, and read-only lab servers.

Deployment
Reference

CLI, configuration, HTTP API, deep links, wire format and architecture.

Reference