mostlyrightmd-core

The public-data SDK core for quants, ML pipelines, and AI agents.

mostlyrightmd-core is the Python core distribution: types, schemas, validators, temporal-safety primitives, align() / spine(), and snapshot helpers. Weather, markets, economy, and finance adapters ship as separate distributions; credentialed and hosted options belong to their domain packages rather than the core-only install.

The core also carries the manifest resolver every domain package uses: source addresses resolve through the hosted manifest catalog, which requires an API key supplied by mostlyright.configure(api_key=...) or the MOSTLYRIGHT_API_KEY environment variable (subscriptions at https://app.mostlyright.md). Without a key, resolution raises ApiKeyRequiredError before making any request. Both routes, and the notebook pattern, are in docs/api-key.md.

Want the whole SDK in one command? Install the meta-distribution mostlyrightmd, which pulls the core plus every domain. Individual domains are mostlyrightmd-weather, mostlyrightmd-markets, mostlyrightmd-economy, and mostlyrightmd-finance.

Install

pip install mostlyrightmd-core           # core only (helpers + snapshot primitives)
pip install mostlyrightmd                # the FULL SDK (core + weather/markets/economy/finance)
pip install mostlyrightmd-weather        # weather data sources only (brings core transitively)

mostlyrightmd-core 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. weather.training_table() lazy-imports mostlyright.weather and raises a clear error if the weather package is not installed.

Point-in-time composition

The core package provides the lower-level align() and spine() helpers used to compose targets and sources against per-row cutoffs. They live under mostlyright.experimental: they are documented and usable, but semver-exempt until they graduate.

Use the domain packages for source reads such as weather.observations() and economy.series(). See docs/dataset.md for a complete composition example.

Training-table example

If you install the weather package, training_table() provides one small, predefined supervised-learning recipe:

from datetime import date
from mostlyright import weather

table = weather.training_table("KNYC", date(2025, 1, 6), date(2025, 1, 12))
print(table.columns.tolist())

Use it when that recipe matches your target. For your own target or sources, use the composition helpers above. See docs/reference/migration-2.0.md for the 2.0 naming changes.

Documentation

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mostlyrightmd_core-5.0.1.tar.gz (754.6 kB view details)

Uploaded Aug 25, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mostlyrightmd_core-5.0.1-py3-none-any.whl (564.9 kB view details)

Uploaded Aug 25, 2026 Python 3

File details

Details for the file mostlyrightmd_core-5.0.1.tar.gz.

File metadata

Download URL: mostlyrightmd_core-5.0.1.tar.gz
Upload date: Aug 25, 2026
Size: 754.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mostlyrightmd_core-5.0.1.tar.gz
Algorithm	Hash digest
SHA256	`5740598ae95c22e694d20a0c4ada8c94da6986530ce0cccc8a09b26d48bb498e`
MD5	`bdcf0a046d4d517c40a3e101008ebbae`
BLAKE2b-256	`6601e355b542c1cfbd2439d7f0f6643aa2ccf6a0f0c76095fb8ae30a9c66c524`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mostlyrightmd_core-5.0.1.tar.gz:

Publisher: release.yml on mostlyrightmd/mostlyright-sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mostlyrightmd_core-5.0.1.tar.gz
- Subject digest: 5740598ae95c22e694d20a0c4ada8c94da6986530ce0cccc8a09b26d48bb498e
- Sigstore transparency entry: 2583033912
- Sigstore integration time: Aug 25, 2026
Source repository:
- Permalink: mostlyrightmd/mostlyright-sdk@525c6f8e62a6692c7571317bf9662eb5a4c3cbc1
- Branch / Tag: refs/tags/v5.0.1
- Owner: https://github.com/mostlyrightmd
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@525c6f8e62a6692c7571317bf9662eb5a4c3cbc1
- Trigger Event: push