Metadata-Version: 2.4
Name: mostlyrightmd
Version: 1.1.2
Summary: Local-first Python SDK for prediction-market weather research. Calls AWC, IEM, GHCNh, and NWS CLI directly; no hosted backend. Exposes research(station, from_date, to_date) for joined observation + climate rows. Imports as `mostlyright`.
Author-email: Robert Tarabcak <tarabcakr@gmail.com>
License-Expression: MIT
Keywords: kalshi,metar,polymarket,quantitative-finance,weather
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: httpx>=0.27
Requires-Dist: jsonschema>=4.21
Requires-Dist: tzdata; sys_platform == 'win32'
Provides-Extra: parquet
Requires-Dist: pandas<4.0,>=2.2; extra == 'parquet'
Requires-Dist: pyarrow<24.0,>=17.0; extra == 'parquet'
Provides-Extra: polars
Requires-Dist: narwhals<2.0,>=1.20; extra == 'polars'
Requires-Dist: pandas<4.0,>=2.2; extra == 'polars'
Requires-Dist: polars<2.0,>=1.0; extra == 'polars'
Requires-Dist: pyarrow<24.0,>=17.0; extra == 'polars'
Provides-Extra: research
Requires-Dist: mostlyrightmd-weather<2.0,>=1.0.0; extra == 'research'
Requires-Dist: pandas<4.0,>=2.2; extra == 'research'
Requires-Dist: pyarrow<24.0,>=17.0; extra == 'research'
Description-Content-Type: text/markdown

# mostlyrightmd

**The public data SDK for quants and AI agents.**

`mostlyrightmd` is the Python entry point: core types, schemas, validators, temporal-safety primitives, and the `research()` join that ties observations × climate into one row per settlement date. Direct calls to public APIs (NOAA, NWS, IEM, GHCNh, Kalshi, Polymarket). No hosted backend, no API key.

Weather + prediction-markets data are live today. SEC filings (EDGAR) and Federal Reserve economic data (FRED) are next.

## Install

```bash
pip install mostlyrightmd                # core only (helpers + snapshot primitives)
pip install 'mostlyrightmd[research]'    # core + weather; enables research()
pip install mostlyrightmd-weather        # weather data sources only (brings core transitively)
```

`mostlyrightmd` and `mostlyrightmd-weather` share the `mostlyright.*` Python namespace but ship as separate PyPI distributions, so users who only need the helpers can skip the heavier weather deps. `research()` lazy-imports `mostlyright.weather` and raises a clear error if the weather package is not installed.

## Quickstart

```python
import mostlyright

df = mostlyright.research("KNYC", "2025-01-06", "2025-01-12")
print(df.head())
```

## Documentation

Quickstart, concepts, and the full API reference live at <https://mostlyright.md/docs/sdk/>.
