Metadata-Version: 2.4
Name: modulector-sdk
Version: 2.3.0
Summary: Typed Python SDK for the Modulector API.
Author: omicsdatascience
License-Expression: MIT
Project-URL: API, https://modulector.multiomix.org/
Project-URL: Homepage, https://modulector.multiomix.org/
Project-URL: Issues, https://github.com/omics-datascience/modulector/issues
Project-URL: Repository, https://github.com/omics-datascience/modulector
Keywords: api-client,bioinformatics,methylation,mirna,sdk
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests==2.31.0
Dynamic: license-file

# Modulector SDK

Typed Python SDK for the Modulector API. The package contains client helpers for
querying miRNA target interactions, miRNA aliases, methylation sites, disease
associations, drug associations, and PubMed subscriptions without installing the
Django backend dependencies.

## Installation

```bash
pip install modulector-sdk
```

## Usage

```python
from modulector_sdk import get_mirna_details, get_mirna_target_interactions

details = get_mirna_details("hsa-miR-21-5p")
interactions = get_mirna_target_interactions(
    mirna="hsa-miR-21-5p",
    gene="PTEN",
    include_pubmeds=True,
)
```

Set `MODULECTOR_API_BASE_URL` to target a different Modulector deployment:

```bash
MODULECTOR_API_BASE_URL=https://your-modulector.example.org python script.py
```

Every service function also accepts a `base_url` keyword argument for
per-request overrides.

## Development

Build this SDK from the `sdk/` directory:

```bash
uv build
```

The generated source distribution and wheel are written to `sdk/dist/`.
