mostlyright-data
Browse datasets built by our community or create your own with agents that find the sources and configure the pipeline. Mostly Right keeps the dataset live.
mostlyright-data is the command-line client. It probes sources, registers one recipe document,
starts and follows hosted dataset runs, reads what they delivered, and downloads the datasets after
they finish.
Requirements
Use CPython 3.13.
Install
python -m pip install mostlyright-data
The default install is the hosted client. It works on Linux, macOS, and Windows.
It also carries the mr-data-build agent skill, which Claude Code and Codex read to author a
recipe without rediscovering the contract a run at a time. The first mr-data command you run
places it in your agent's skill directory; there is nothing to install by hand. A skill you have
edited yourself is never replaced, and MOSTLYRIGHT_SKILL_AUTOINSTALL=0 switches the placement
off.
Sign in
mr-data login
mr-data whoami
login stores a device key on the current machine. whoami checks that key.
Check the installation
mr-data --version
mr-data --help
Build a dataset
mr-data probe SOURCE_ID "does this feed carry city grain before 2021"
mr-data recipe RECIPE.json
mr-data run RECIPE_ID --sample --window 2025-03-01..2025-04-01 --max-rows 50000
mr-data checks RUN
mr-data download RUN --output ./out
probe asks one registered source one question; the session behind it is opened, reused and closed
for you. recipe registers one document and prints the identifiers the server derived from it.
run starts a run and mr-data status RUN, mr-data runs, and mr-data watch RUN report on it.
mr-data promote TABLE_ID makes a table live, and it is the one step that asks a person first.
Local execution
The local execution lane runs only on Linux:
python -m pip install "mostlyright-data[local]"
It is not required for the hosted client, and it is off by default: mr-data sends that work to
the backend. What still runs on this computer is catalog authoring, the search index, and the
commands that check a document or a run folder. A command with no backend lane refuses by name and
says why.
Documentation
Use mr-data --help for the full command list and options. Commands that support
--json write one JSON object.
--input-root and --output may use relative paths.
Behavior and limits
mr-data review RUN_DIR --localruns the deterministic checks and writes no review decision. It exits 1 when a check fails. Write the flag after the command name; before it,--localis the lane selector.mr-data review RUN_DIR --report REPORTseals a review decision from signed reviewer reports.- Weather Reader versions 1 and 2 accept one extracted GRIB2 record and refuse a multi-record GFS or HRRR file. Version 3 reads a bounded collection and selects exactly one sealed record.
- Hosted credential-free acquisition supports one single-address public HTTPS object. Bounded collections require both local attestations.
- A keyed stream venue is named by a credential reference the backend holds, never by a value. No command flag takes a secret as an argument; the local recorder lane reads one from a
0600file named by--credential-file. Venues reached over an actual WebSocket are covered; a venue whose credential comes from an interactive human login, or that is not WebSocket at all, is not.
Verification
make test-fast
make test-fast is non-authoritative and is useful while editing. make verify is required
before review or merge.
Development
uv sync --locked --extra dev
The local test suite requires Linux for worker-boundary tests. The hosted client is tested on Linux, macOS, and Windows.
1 maintainer
Release files for mostlyright-data 0.10.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mostlyright_data-0.10.1.tar.gz | 32.7 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mostlyright_data-0.10.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 65.8 MB
Release files / mostlyright_data-0.10.1.tar.gz
| Download URL | mostlyright_data-0.10.1.tar.gz |
|---|---|
| Size | 32.7 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f9b243495f949dda5278dafdf99c280bc78cb96c2a9271937b737a9fb2751488
|
|
BLAKE2b-256 checksum How to use checksums |
926dc12104722fca92f9d2e6baff7530ab19db2fa2e66055b846b6a75a6b6317
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 30, 2026.
Transparency logRelease files / mostlyright_data-0.10.1-py3-none-any.whl
| Download URL | mostlyright_data-0.10.1-py3-none-any.whl |
|---|---|
| Size | 33.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
df90b45fe4605211674b5f11123eb90db788269f5e6422724fdd2e27f6caee36
|
|
BLAKE2b-256 checksum How to use checksums |
77d47d6b90f22080293ac91227ba13b98ded40f278f08104175d52901ee60335
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 30, 2026.
Transparency log
