Metadata-Version: 2.4
Name: hydra-atlas
Version: 0.1.0
Summary: Authenticated Greater Manchester water intelligence client for hydra. Atlas
Project-URL: Homepage, https://www.hydracompute.io
Project-URL: Documentation, https://www.hydracompute.io/#observatory
Project-URL: Repository, https://github.com/Aerthor/hyrda.
Project-URL: Issues, https://github.com/Aerthor/hyrda./issues
Author-email: "hydra." <hydra@hydracompute.io>
Maintainer: Aerthor
License-Expression: MIT
License-File: LICENSE
Keywords: agents,environment,greater-manchester,hydrology,infrastructure,water
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Scientific/Engineering :: GIS
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# hydra-atlas

The Python client for the authenticated hydra. Atlas developer app. It gives an agent a small, explicit interface to the Greater Manchester water intelligence APIs while carrying the source, timestamp, quality, uncertainty and review state returned by Atlas.

## Install

```bash
pip install hydra-atlas
```

Set the authenticated token issued by the Hydra app:

```bash
export HYDRA_ATLAS_TOKEN="<your Supabase access token>"
```

## Agent use

```python
from hydra_atlas import HydraAtlasClient

client = HydraAtlasClient()
stations = client.stations()
signals = client.signals("level")
```

The client defaults to `https://www.hydracompute.io` and routes through the authenticated `/api/agent` gateway. Set `HYDRA_ATLAS_URL` for a development or private deployment. The token is sent as a bearer credential and is never written to disk by the client.

The client does not infer model readiness. Every response is returned as received, including `sourceState`, `qualityState`, `uncertainty`, `missingFields`, and `reviewState`.

## Command line

```bash
hydra-atlas stations
hydra-atlas signals --parameter level
hydra-atlas waterways
```

Use `hydra-atlas --help` for the complete resource list.
