Skip to content

Get started

Quickstart

Mostly Right ships as two local-first SDKs that share the same surface, currently in private beta. Pick your runtime and call dataset().

import mostlyright
df = mostlyright.dataset(
station="KNYC",
from_date="2025-01-06",
to_date="2025-01-12",
label="cli", # pin the settlement label for byte-stable output
)
print(df.head())

dataset() is the primary composer; research() is a fully working alias for existing code. Pinning label="cli" keeps the NWS CLI settlement columns and silences the D-22 default-label warning — see Choosing the label. Full walkthrough — install, first call, cache layout, station codes, live streaming — in the Python quickstart.

import { dataset } from 'mostlyright';
const rows = await dataset('KNYC', '2025-01-06', '2025-01-12', { label: 'cli' });
console.log(rows[0]);

Full walkthrough in the TypeScript quickstart.

  • SDK overview — local-first design, package layout, where the cache lives, links to source.
  • Temporal safetyKnowledgeView and LeakageDetector.
  • Source identity — fused vs source-pinned and SourceMismatchError.
  • Data sources — why the dedup tiebreak matters for reproducibility.