Metadata-Version: 2.4
Name: strand-sdk
Version: 0.14.0
Summary: Official Python client for the Strand Platform API — H&E → multiplex protein inference.
Project-URL: Homepage, https://strandai.com
Project-URL: Documentation, https://docs.strandai.com
Project-URL: Repository, https://github.com/Strand-AI/strand-sdk-python
Project-URL: Source, https://github.com/Strand-AI/strand-sdk-python
Project-URL: Issues, https://github.com/Strand-AI/strand-sdk-python/issues
Project-URL: Changelog, https://github.com/Strand-AI/strand-sdk-python/blob/main/CHANGELOG.md
Author-email: Strand AI <support@strandai.com>
License: Apache-2.0
License-File: LICENSE
Keywords: anndata,bioinformatics,h&e,imputation,pathology,spatial-omics,strand
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: httpx-sse>=0.4
Requires-Dist: httpx>=0.27
Requires-Dist: typer>=0.12
Requires-Dist: typing-extensions>=4.10
Provides-Extra: anndata
Requires-Dist: anndata>=0.10; extra == 'anndata'
Requires-Dist: numpy>=1.24; extra == 'anndata'
Requires-Dist: zstandard>=0.22; (python_version < '3.14') and extra == 'anndata'
Provides-Extra: dev
Requires-Dist: anndata>=0.10; extra == 'dev'
Requires-Dist: mypy>=1.11; extra == 'dev'
Requires-Dist: numpy>=1.24; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: respx>=0.21; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Requires-Dist: zstandard>=0.22; (python_version < '3.14') and extra == 'dev'
Description-Content-Type: text/markdown

# strand-sdk

Python client for the [Strand Platform](https://strandai.com): upload H&E
whole-slide images, run virtual multiplex-immunofluorescence inference
(H&E → spatial proteomics), and download per-marker predictions as AnnData
or OME-Zarr/OME-TIFF.

📚 **Full documentation: <https://docs.strandai.com/sdks/python>**

Agent-readable API reference: <https://app.strandai.com/docs/api.md> · LLM
index: <https://app.strandai.com/llms.txt>

Requires Python 3.12+.

## Install

```bash
pip install strand-sdk
# or with bioinformatics extras (AnnData / zarr):
pip install "strand-sdk[anndata]"
```

## Quickstart

One blocking call runs the full pipeline — upload, submit, wait, download:

```python
from strand import Client

client = Client()  # reads STRAND_API_KEY; mint one at https://app.strandai.com/settings/api-keys
result = client.predict(
    "biopsy.ome.tiff",
    markers=["HER2", "CD8", "PD1"],
    output_dir="./outputs/",
)
print(f"Used {result.credits_used} credits; wrote {len(result.marker_outputs)} markers")
```

Everything else — uploads, model selection, async jobs, OME-TIFF export,
error handling — is covered in the
[hosted docs](https://docs.strandai.com/sdks/python).

## Issues & support

File bug reports and feature requests at
[Strand-AI/strand-sdk-python/issues](https://github.com/Strand-AI/strand-sdk-python/issues),
or email [support@strandai.com](mailto:support@strandai.com). This repository
is a generated, read-only mirror of Strand's monorepo — pull requests opened
here are overwritten by the next sync.

## License

Apache 2.0
