plexora 0.0.22__tar.gz → 0.0.26__tar.gz

plexora-0.0.26/MANIFEST.in

@@ -0,0 +1,25 @@
+recursive-include plexora/client/templates *.html
+recursive-include plexora/client/dist *
+recursive-include plexora/client/src/css *.css
+recursive-include plexora/client/src/img *
+recursive-include plexora/client/src/js *.js
+recursive-include plexora/client/src/shaders *.glsl
+recursive-include plexora/client/external *
+recursive-include plexora/plugins *.html
+# Per plugin rather than a plugins/*/static glob: MANIFEST.in has no such glob,
+# so every bundled plugin's assets need a line of their own here or they are
+# simply absent from an sdist -- which builds and installs fine, then serves a
+# tool with no client.
+recursive-include plexora/plugins/cell_explorer/static *
+recursive-include plexora/plugins/figure_builder/static *
+recursive-include plexora/plugins/gating/static *
+recursive-include plexora/plugins/roi/static *
+# The telemetry Worker (Cloudflare) is deployed separately, never shipped.
+prune backend
+# The licence service Worker likewise: deployed separately, never shipped --
+# and its tools/ must never ride along in an sdist.
+prune licensing
+# The documentation site and its generator are built from the repository and
+# published to GitHub Pages; neither is part of the package.
+prune website
+prune tools

plexora-0.0.26/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.4
+Name: plexora
+Version: 0.0.26
+Summary: OpenSeadragon-based cellular image viewing and analysis tool.
+License-Expression: LicenseRef-Plexora-Academic-1.0
+Requires-Python: <3.14,>=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.9
+Requires-Dist: anndata>=0.10
+Requires-Dist: cryptography>=42
+Requires-Dist: Flask>=3.1
+Requires-Dist: fsspec>=2024.12
+Requires-Dist: h5py>=3.16.0
+Requires-Dist: imagecodecs
+Requires-Dist: itsdangerous>=2.2
+Requires-Dist: Jinja2>=3.1
+Requires-Dist: numba>=0.61
+Requires-Dist: numpy>=2.0
+Requires-Dist: ome-types>=0.6.3
+Requires-Dist: opencv-python-headless>=5.0.0.93
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: orjson>=3.11
+Requires-Dist: pandas>=3.0.5
+Requires-Dist: Pillow>=10.4
+Requires-Dist: platformdirs>=4
+Requires-Dist: polars>=1.43
+Requires-Dist: pydantic<2.14,>=2.13
+Requires-Dist: reportlab>=5.0.1
+Requires-Dist: s3fs>=2024.12
+Requires-Dist: scikit-image
+Requires-Dist: scikit-learn>=1.9
+Requires-Dist: scipy
+Requires-Dist: shapely>=2.1.2
+Requires-Dist: spatialdata>=0.8.0
+Requires-Dist: threadpoolctl>=3.6.0
+Requires-Dist: tifffile>=2026.7.31
+Requires-Dist: urllib3>=2.0
+Requires-Dist: waitress
+Requires-Dist: Werkzeug>=3.1
+Requires-Dist: zarr>=3
+Provides-Extra: jupyter
+Requires-Dist: ipython; extra == "jupyter"
+Requires-Dist: jupyter-server-proxy; extra == "jupyter"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-randomly>=4.1.0; extra == "dev"
+Provides-Extra: spatial
+Requires-Dist: pyarrow>=14; extra == "spatial"
+Provides-Extra: remote
+Requires-Dist: gcsfs>=2024.12; extra == "remote"
+Requires-Dist: adlfs>=2024.12; extra == "remote"
+Provides-Extra: wsi
+Requires-Dist: openslide-python>=1.3; extra == "wsi"
+Requires-Dist: openslide-bin>=4.0; extra == "wsi"
+Requires-Dist: wsidicom>=0.22; extra == "wsi"
+Requires-Dist: pydicom>=3; extra == "wsi"
+Provides-Extra: ai
+Requires-Dist: mcp<3,>=2.2; extra == "ai"
+Requires-Dist: pyyaml>=6; extra == "ai"
+Dynamic: license-file
+
+# Plexora
+
+![](./plexora/client/src/img/logo_with_text.svg)
+
+Plexora is a viewer for multiplexed imaging and spatial transcriptomics. It
+opens large images where they are, without converting or copying them, draws
+segmentation masks and cell tables over them, and runs on a laptop, in a
+notebook, on a remote workstation or on an HPC cluster.
+
+**Documentation: https://nirmallab.github.io/plexora/**
+
+![The Plexora viewer showing a multiplexed tissue image](./website/public/screenshots/home/viewer.webp)
+
+## Install
+
+```bash
+pip install plexora
+plexora
+```
+
+`plexora` starts the viewer and opens it in your browser. Python 3.12 or 3.13
+is required. A desktop app for macOS, Windows and Linux is on the
+[releases page](https://github.com/nirmallab/plexora/releases). See
+[Installation](https://nirmallab.github.io/plexora/docs/getting-started/installation/).
+
+## Quick start
+
+In the app, choose **File → Import Sample…** and pick an image, a folder of
+files, or a Xenium or Visium run. From Python:
+
+```python
+import plexora
+
+name = plexora.import_sample("slide.ome.tif", "slide_mask.tif", "cells.csv", wait=True)
+plexora.view(name)   # in a notebook, shows the viewer inline
+```
+
+More in the [quick start](https://nirmallab.github.io/plexora/docs/getting-started/quick-start/).
+
+## What it reads
+
+- Multiplexed images: OME-TIFF, TIFF, QPTIFF, OME-Zarr (local, `https://` or `s3://`)
+- Brightfield whole-slide images: SVS, NDPI, SCN, BIF, MRXS, DICOM
+- 10x Genomics Xenium, Visium and Visium HD output folders
+- SpatialData stores and AnnData tables; CSV, TSV and Parquet cell tables
+- Segmentation masks (label images) and cell boundary polygons
+
+The full list is in [Supported formats](https://nirmallab.github.io/plexora/docs/reference/supported-formats/).
+
+## Where to go next
+
+| I want to | Read |
+| --- | --- |
+| Use the viewer and its tools | [Viewer](https://nirmallab.github.io/plexora/docs/viewer/navigation/), [Tools](https://nirmallab.github.io/plexora/docs/plugins/) |
+| Script it from Python or a notebook | [Python](https://nirmallab.github.io/plexora/docs/python/), [Notebooks](https://nirmallab.github.io/plexora/docs/notebooks/) |
+| Look at data on a remote machine or cluster | [Remote and HPC](https://nirmallab.github.io/plexora/docs/remote/) |
+| Write a plugin | [Plugin development](https://nirmallab.github.io/plexora/docs/plugin-development/) |
+| Look up a function or command | [Python API](https://nirmallab.github.io/plexora/docs/python-api/), [Command line](https://nirmallab.github.io/plexora/docs/cli/) |
+
+## Developing Plexora
+
+```bash
+git clone https://github.com/nirmallab/plexora.git
+cd plexora
+pip install -e ".[dev]"
+python -m pytest -q -p no:randomly
+```
+
+See [Development setup](https://nirmallab.github.io/plexora/docs/contributing/development-setup/)
+and, for the documentation site in `website/`, [CONTRIBUTING_DOCS.md](./CONTRIBUTING_DOCS.md).
+Engineering notes live in [docs/internal/](./docs/internal/).
+
+## Usage data
+
+Plexora can send **anonymous usage counts** -- which features and plugins are
+used, how long tiles take to draw, which kinds of errors occur -- so we know
+what to improve. It never sends file, project, marker or gene names, cell
+data, coordinates, usernames, machine names, paths, prompts or anything typed
+into a tool; every field it may send is on an allowlist
+(`plexora/telemetry/schema.py`). Everything is queued on this machine first,
+nothing in Plexora waits for it, and it works air-gapped exactly as before.
+
+It is on by default and a notice says so the first time. Any one of these turns
+it off:
+
+```bash
+plexora telemetry off        # or: Settings > Usage data
+export DO_NOT_TRACK=1        # honoured everywhere
+export PLEXORA_TELEMETRY=off
+```
+
+`plexora telemetry preview` prints exactly what the next upload would contain,
+and `plexora telemetry status` says which of the above is in force.
+[docs/TELEMETRY.md](./docs/TELEMETRY.md) has the details.
+
+## Free and Paid
+
+**Free** is everything described above: every image, table and modality, every
+tool's manual features, remote, HPC and notebook viewing, and export. It needs no
+account, no activation and no network, and it never asks.
+
+**Paid** adds AI features: guided gating sessions an agent runs with you, and
+the evidence and analysis tools it uses. Activate a seat key or install an
+offline licence file in Settings > License, or from a terminal:
+
+```bash
+plexora license status
+plexora license activate PLEX-XXXX-XXXX-XXXX-XXXX              # this computer
+plexora license activate PLEX-XXXX-XXXX-XXXX-XXXX --cluster    # a whole HPC cluster, once, from a login node
+plexora license install lab.plexora                            # an offline licence file
+plexora license trial                                          # 30 days of Paid
+```
+
+A licence check sends the licence certificate and a hash that identifies the
+environment. It never sends your data, file names, machine names or anything
+about what you are looking at. When a licence ends, everything Free keeps
+working, and every gate, ROI, figure and export you made, with or without AI,
+stays yours and editable. AI model providers your agent uses bill you
+separately. [docs/LICENSING.md](./docs/LICENSING.md) has the details.
+
+## License
+
+Plexora is released under the **Plexora Academic License 1.0** (see [LICENSE](./LICENSE)).
+It is **not** an open source license. In short:
+
+| | |
+|---|---|
+| Academic research, teaching, personal study | ✅ Free |
+| Use by a nonprofit or government research institution | ✅ Free (whatever the funding source) |
+| Redistributing Plexora unmodified, with the license attached | ✅ Allowed |
+| Patching your own copy to fix a bug or a compatibility problem | ✅ Allowed |
+| Publishing a fork, a patched build, or a renamed version | ❌ Not allowed |
+| Commercial use of any kind | ❌ Requires a paid license |
+
+**Plugins are a deliberate exception.** Anything you build against the documented
+extension interfaces — the `plexora.plugins` entry point group and the `plexora.api`
+package — is yours. You may distribute and sell your plugin under whatever license
+you like, and you do not need our permission. Extending Plexora through the plugin
+API is the supported way to change what it does; editing its source is not.
+
+For a commercial license, contact Ajit Johnson Nirmal <ajitjohnson.n@gmail.com>.
+
+Some bundled components carry their own licenses, which are unaffected by the above —
+see section 8 of [LICENSE](./LICENSE).

plexora-0.0.26/README.md

@@ -0,0 +1,144 @@
+# Plexora
+
+![](./plexora/client/src/img/logo_with_text.svg)
+
+Plexora is a viewer for multiplexed imaging and spatial transcriptomics. It
+opens large images where they are, without converting or copying them, draws
+segmentation masks and cell tables over them, and runs on a laptop, in a
+notebook, on a remote workstation or on an HPC cluster.
+
+**Documentation: https://nirmallab.github.io/plexora/**
+
+![The Plexora viewer showing a multiplexed tissue image](./website/public/screenshots/home/viewer.webp)
+
+## Install
+
+```bash
+pip install plexora
+plexora
+```
+
+`plexora` starts the viewer and opens it in your browser. Python 3.12 or 3.13
+is required. A desktop app for macOS, Windows and Linux is on the
+[releases page](https://github.com/nirmallab/plexora/releases). See
+[Installation](https://nirmallab.github.io/plexora/docs/getting-started/installation/).
+
+## Quick start
+
+In the app, choose **File → Import Sample…** and pick an image, a folder of
+files, or a Xenium or Visium run. From Python:
+
+```python
+import plexora
+
+name = plexora.import_sample("slide.ome.tif", "slide_mask.tif", "cells.csv", wait=True)
+plexora.view(name)   # in a notebook, shows the viewer inline
+```
+
+More in the [quick start](https://nirmallab.github.io/plexora/docs/getting-started/quick-start/).
+
+## What it reads
+
+- Multiplexed images: OME-TIFF, TIFF, QPTIFF, OME-Zarr (local, `https://` or `s3://`)
+- Brightfield whole-slide images: SVS, NDPI, SCN, BIF, MRXS, DICOM
+- 10x Genomics Xenium, Visium and Visium HD output folders
+- SpatialData stores and AnnData tables; CSV, TSV and Parquet cell tables
+- Segmentation masks (label images) and cell boundary polygons
+
+The full list is in [Supported formats](https://nirmallab.github.io/plexora/docs/reference/supported-formats/).
+
+## Where to go next
+
+| I want to | Read |
+| --- | --- |
+| Use the viewer and its tools | [Viewer](https://nirmallab.github.io/plexora/docs/viewer/navigation/), [Tools](https://nirmallab.github.io/plexora/docs/plugins/) |
+| Script it from Python or a notebook | [Python](https://nirmallab.github.io/plexora/docs/python/), [Notebooks](https://nirmallab.github.io/plexora/docs/notebooks/) |
+| Look at data on a remote machine or cluster | [Remote and HPC](https://nirmallab.github.io/plexora/docs/remote/) |
+| Write a plugin | [Plugin development](https://nirmallab.github.io/plexora/docs/plugin-development/) |
+| Look up a function or command | [Python API](https://nirmallab.github.io/plexora/docs/python-api/), [Command line](https://nirmallab.github.io/plexora/docs/cli/) |
+
+## Developing Plexora
+
+```bash
+git clone https://github.com/nirmallab/plexora.git
+cd plexora
+pip install -e ".[dev]"
+python -m pytest -q -p no:randomly
+```
+
+See [Development setup](https://nirmallab.github.io/plexora/docs/contributing/development-setup/)
+and, for the documentation site in `website/`, [CONTRIBUTING_DOCS.md](./CONTRIBUTING_DOCS.md).
+Engineering notes live in [docs/internal/](./docs/internal/).
+
+## Usage data
+
+Plexora can send **anonymous usage counts** -- which features and plugins are
+used, how long tiles take to draw, which kinds of errors occur -- so we know
+what to improve. It never sends file, project, marker or gene names, cell
+data, coordinates, usernames, machine names, paths, prompts or anything typed
+into a tool; every field it may send is on an allowlist
+(`plexora/telemetry/schema.py`). Everything is queued on this machine first,
+nothing in Plexora waits for it, and it works air-gapped exactly as before.
+
+It is on by default and a notice says so the first time. Any one of these turns
+it off:
+
+```bash
+plexora telemetry off        # or: Settings > Usage data
+export DO_NOT_TRACK=1        # honoured everywhere
+export PLEXORA_TELEMETRY=off
+```
+
+`plexora telemetry preview` prints exactly what the next upload would contain,
+and `plexora telemetry status` says which of the above is in force.
+[docs/TELEMETRY.md](./docs/TELEMETRY.md) has the details.
+
+## Free and Paid
+
+**Free** is everything described above: every image, table and modality, every
+tool's manual features, remote, HPC and notebook viewing, and export. It needs no
+account, no activation and no network, and it never asks.
+
+**Paid** adds AI features: guided gating sessions an agent runs with you, and
+the evidence and analysis tools it uses. Activate a seat key or install an
+offline licence file in Settings > License, or from a terminal:
+
+```bash
+plexora license status
+plexora license activate PLEX-XXXX-XXXX-XXXX-XXXX              # this computer
+plexora license activate PLEX-XXXX-XXXX-XXXX-XXXX --cluster    # a whole HPC cluster, once, from a login node
+plexora license install lab.plexora                            # an offline licence file
+plexora license trial                                          # 30 days of Paid
+```
+
+A licence check sends the licence certificate and a hash that identifies the
+environment. It never sends your data, file names, machine names or anything
+about what you are looking at. When a licence ends, everything Free keeps
+working, and every gate, ROI, figure and export you made, with or without AI,
+stays yours and editable. AI model providers your agent uses bill you
+separately. [docs/LICENSING.md](./docs/LICENSING.md) has the details.
+
+## License
+
+Plexora is released under the **Plexora Academic License 1.0** (see [LICENSE](./LICENSE)).
+It is **not** an open source license. In short:
+
+| | |
+|---|---|
+| Academic research, teaching, personal study | ✅ Free |
+| Use by a nonprofit or government research institution | ✅ Free (whatever the funding source) |
+| Redistributing Plexora unmodified, with the license attached | ✅ Allowed |
+| Patching your own copy to fix a bug or a compatibility problem | ✅ Allowed |
+| Publishing a fork, a patched build, or a renamed version | ❌ Not allowed |
+| Commercial use of any kind | ❌ Requires a paid license |
+
+**Plugins are a deliberate exception.** Anything you build against the documented
+extension interfaces — the `plexora.plugins` entry point group and the `plexora.api`
+package — is yours. You may distribute and sell your plugin under whatever license
+you like, and you do not need our permission. Extending Plexora through the plugin
+API is the supported way to change what it does; editing its source is not.
+
+For a commercial license, contact Ajit Johnson Nirmal <ajitjohnson.n@gmail.com>.
+
+Some bundled components carry their own licenses, which are unaffected by the above —
+see section 8 of [LICENSE](./LICENSE).