PolyStore

Framework-agnostic storage primitives for scientific applications.

PolyStore owns backend interfaces, execution-local backend registries, FileManager routing, storage formats, ROI values, virtual-workspace source references, and viewer-streaming payload mechanics. Applications retain ownership of domain artifact names and materialization policy.

Quick start

Pass an explicit mapping of backend names to instances. FileManager has no global fallback and does not infer a backend from a path.

from pathlib import Path
import numpy as np

from polystore import DiskBackend, FileManager, MemoryBackend

registry = {
    "disk": DiskBackend(),
    "memory": MemoryBackend(),
}
files = FileManager(registry)

data = np.arange(6).reshape(2, 3)
files.save(data, Path("output.npy"), backend="disk")
loaded = files.load(Path("output.npy"), backend="disk")

For application startup where every discoverable context-free backend is wanted, use the package-owned lazy registry:

from polystore import FileManager, ensure_storage_registry, storage_registry

ensure_storage_registry()
files = FileManager(dict(storage_registry))

Backends requiring context-specific construction, including virtual workspaces and OMERO, must be instantiated by the application and added to its registry.

Nominal backend extension

Concrete backends inherit DataSource, DataSink, StorageBackend, or ReadOnlyBackend and declare their backend key. The authoritative class catalog is BackendBase.__registry__ (also exported as STORAGE_BACKENDS). Do not build a second backend class table.

Installation

python -m pip install polystore

The core install includes NumPy, ArrayBridge, metaclass-registry, file locking, platform-aware cache paths, image I/O, Zarr/OME-Zarr support, and ZMQRuntime. Framework and streaming extras add their corresponding optional runtimes. Install polystore[bioformats] for the package-owned PyImageJ and Bio-Formats bridge. Its first use materializes a checksummed Fiji, JDK, and PyImageJ bridge runtime; later processes reuse that complete local cache without Maven resolution.

Full documentation: polystore.readthedocs.io

Metadata

Release files for polystore 0.2.19

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for polystore 0.2.19
File	Size	Uploaded
polystore-0.2.19.tar.gz	182.6 kB	Sep 24, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for polystore 0.2.19
File	Interpreter	ABI	Platform	Reset
polystore-0.2.19-py3-none-any.whl 154.7 kB Sep 24, 2026	Python 3	none	any	Details

Total release size: 337.3 kB

Release files / polystore-0.2.19.tar.gz

Download URL	polystore-0.2.19.tar.gz
Size	182.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`3f927136aac545a8c52d45bbe5d5a5210a4f052afc18e74f57b74617ab209cab`
BLAKE2b-256 checksum How to use checksums	`ec9f52e88b0032471e4f02e605a671a06613b1fd8429ffc1abd71d28972a0d3e`
Upload date	Sep 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/OpenHCSDev/PolyStore
Publishing commit: github.com/OpenHCSDev/PolyStore/tree/0efe67fdd14985bf90cee6e0f0c4735d41d265d1

Workflow

Publishing configuration: github.com/OpenHCSDev/PolyStore/blob/0efe67fdd14985bf90cee6e0f0c4735d41d265d1/.github/workflows/publish.yml
Publishing logs: github.com/OpenHCSDev/PolyStore/actions/runs/35966811082/attempts/1

Artifact

Subject: polystore-0.2.19.tar.gz
SHA-256 checksum: 3f927136aac545a8c52d45bbe5d5a5210a4f052afc18e74f57b74617ab209cab Verifying attestations

Release files / polystore-0.2.19-py3-none-any.whl

Download URL	polystore-0.2.19-py3-none-any.whl
Size	154.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b2cf6c1eb4a3cad8d41ca4c4e228cec74302e63bd65c99a9c0781871c3331453`
BLAKE2b-256 checksum How to use checksums	`9429b3bb64fcc9af3806f8b84d5f1acc11212cc4efcd8341eb067f06ee8a900a`
Upload date	Sep 24, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/OpenHCSDev/PolyStore
Publishing commit: github.com/OpenHCSDev/PolyStore/tree/0efe67fdd14985bf90cee6e0f0c4735d41d265d1

Workflow

Publishing configuration: github.com/OpenHCSDev/PolyStore/blob/0efe67fdd14985bf90cee6e0f0c4735d41d265d1/.github/workflows/publish.yml
Publishing logs: github.com/OpenHCSDev/PolyStore/actions/runs/35966811082/attempts/1

Artifact

Subject: polystore-0.2.19-py3-none-any.whl
SHA-256 checksum: b2cf6c1eb4a3cad8d41ca4c4e228cec74302e63bd65c99a9c0781871c3331453 Verifying attestations