# Mostly Right

> Mostly Right is a Python and TypeScript SDK for public data with clear sources and timestamps. Historical and live methods use the same parser and core fields. Every row names its source.

## Install

- Python 3.11+: `pip install mostlyrightmd`
- TypeScript / Node 20+: `pnpm add mostlyright`
- Most methods need no account or API key.
- Local cache: Python `~/.mostlyright/cache/`; Node `~/.mostlyright/cache-ts/`; browser IndexedDB.

## Quickstart methods

- Python: `weather.training_table(station, from_date, to_date)`
- TypeScript: `trainingTable(station, fromDate, toDate)`
- Raw weather archive: `weather.observations(...)`
- Python live: `await weather.live.latest(station)`
- TypeScript live: `await weather.latest(station)`
- Removed 1.x names: `research()`, `pairs()`, `dataset()`, `obs()`

## Domains

- Weather: live METAR, observations, forecasts, climate, daily outcomes, satellite covariates
- Markets: Kalshi and Polymarket contract research, reference data, discovery, and venue history
- Economy: CPI, PPI, payrolls, GDP, jobless claims, Fed decisions, first-print vintages
- Finance: earnings-call transcripts and earnings-mention resolution

## Data contracts

- Temporal controls: sources with reliable availability timestamps can be filtered or checked against a research cutoff.
- Source identity: every frame names the feed that served it.
- Archive/live consistency: shared parser semantics and core measurements, with runtime-specific fields kept explicit.
- When a live source returns no rows, the call raises `NoLiveDataError` instead of substituting archive data.

## Docs

- Overview: https://mostlyright.md/docs/
- Quickstart: https://mostlyright.md/docs/quickstart/
- Packages: https://mostlyright.md/docs/sdk/
- Temporal safety: https://mostlyright.md/docs/concepts/temporal-safety/
- Data sources: https://mostlyright.md/docs/concepts/data-sources/
- Markets: https://mostlyright.md/docs/guides/markets/
- Full details: https://mostlyright.md/llms-full.txt