modelo

modelo is a Rust multi-model validation library and a Python bindings extension intended as a drop-in replacement for python-ort.

Namespaces

Each model family lives in its own namespace, so families can be added without disturbing the others. Currently there is one: ort, the OSS Review Toolkit model.

	ORT model	Shared validation engine
Rust	`modelo::models::ort::*` (`src/models/ort/`)	`modelo::models::{Model, ValidationError}`
Python	`modelo.ort`	—

Adding a family means a new src/models/<name>/ directory whose types implement models::Model, plus a modelo.<name> submodule in src/python/mod.rs. The engine and the bindings' plumbing stay as they are.

Workspace layout

This repository is a Cargo workspace with two crates, so the library stays free of CLI/TUI dependencies (clap, ratatui, crossterm):

Crate	Contents	Dependencies
`modelo`	The validation engine and models (`src/`), plus the optional Python bindings	`serde`, `serde_yaml`, `thiserror`, `purl`, `pyo3` (feature-gated)
`modelo-cli`	The `modelo` binary: CLI subcommands and the TUI	`modelo`, `clap`, `ratatui`, `crossterm`, `anyhow`

Build

cargo build --release --workspace  # library + `modelo` binary
cargo test --workspace              # unit + integration tests (203 tests)
cargo clippy --workspace --all-targets # lints
cargo doc --workspace --open        # API documentation

The Python extension module lives in its own modelo-python crate, so the modelo library and the modelo binary never link against libpython:

cargo build --release -p modelo-python

Validating files: the `modelo` CLI

The modelo binary lives in the modelo-cli crate:

cargo install modelo-cli

modelo license-classifications  tests/data/license-classifications.yml
modelo repository-configuration tests/data/repo_config/curations.yml
modelo ort-result               tests/data/evaluation-result.yml

The subcommands are still flat rather than grouped per family (modelo ort ort-result ...); that regrouping is worth doing when a second family lands, not before.

Each subcommand prints valid <kind> file. and exits 0, or reports the first parse/validation error and exits non-zero. --debug additionally pretty-prints the parsed model. This is the equivalent of python-ort's ort-validate (src/tools/ort_validate.py).

Interactive TUI

modelo tui [FILE] (or modelo with no arguments) opens a ratatui interface: pick the model kind, type a file path, see the validation result. ↑/↓ (or k/j) move and scroll, Enter confirms, b goes back from the result screen, q/Esc quits.

Using it from Python

pip install modelo

or, from a checkout:

pip install maturin
maturin develop     # into the active virtualenv
# or: pip install .                   # maturin is the build backend

The modelo.ort submodule exposes the three top-level ORT models, each parsed from YAML and navigated with plain attribute access, the way python-ort's pydantic models are:

from pprint import pprint

from modelo.ort import LicenseClassifications, OrtResult, RepositoryConfiguration

result = OrtResult.from_yaml_file("tests/data/evaluation-result.yml")
config = RepositoryConfiguration.from_yaml_str(open(".ort.yml").read())

pprint(result.analyzer)                                 # AnalyzerRun(start_time=..., ...)
result.analyzer.environment.ort_version
result.analyzer.result.projects[0].id
result.repository.vcs.url

Invalid input raises ValueError (with the failing field path, as pydantic's ValidationError does); an unreadable path raises OSError.

Every nested model is an instance of a class named after it (type(result.analyzer).__name__ == "AnalyzerRun"), all of them subclasses of modelo.ort.Object. Besides attribute access they support keys(), values(), items(), obj["field"], "field" in obj, len(obj), == and to_dict():

import json

result.to_dict()                                        # nested plain dicts and lists
json.loads(result.to_json()) == result.to_dict()        # True — one source of truth

Fields that ORT itself serializes as scalars stay scalars: Identifier is a string ("PIP::requirements.txt:1.0"), enums are their member names, and free-form maps such as labels are dicts.

Type checking

The wheel is a PEP 561 typed package: modelo/py.typed ships alongside modelo/ort.pyi, so mypy, pyright and ty resolve import modelo.ort and the model classes without falling back to Any. The compiled extension lives at modelo._modelo; modelo.ort is a thin Python re-export of it, which is what makes the module statically resolvable.

Examples

Runnable counterparts of python-ort's examples/, using only the standard library:

python examples/license_classifications.py tests/data/license-classifications.yml
python examples/repo_config.py             tests/data/repo_config/curations.yml
python examples/ort_result.py              tests/data/evaluation-result.yml --analyzer

Checking parity against python-ort

examples/parity_check.py parses every fixture in tests/data/ with both libraries and diffs the serialized result, ignoring set-backed field ordering (arbitrary in both):

pip install . python-ort
python examples/parity_check.py

All 9 fixtures agree; analyzer-result.yml is rejected by both libraries for the same unknown field. The behaviours this covers:

Int-backed enums (Severity, *Reason, …) accept the numeric value or the case-sensitive member name, and serialize as the member name — python-ort's ValidatedIntEnum.
Unknown fields are rejected wherever python-ort sets extra="forbid", and accepted where it sets extra="allow"/"ignore".
Loose scalars are coerced as python-ort's mode="before" validators do (an integer start_lines, non-string options values).

Continuous integration

.github/workflows/ci.yml runs on every push and pull request: format (rustfmt), lint (clippy, warnings denied), test (Linux/macOS/Windows), python (bindings built and smoke-tested on 3.10 and 3.13) and parity (the diff above against python-ort).

Every third-party action is pinned to a full commit SHA with the released tag in a trailing comment (uses: actions/checkout@3d3c42e... # v7.0.1), so a moving tag cannot change what runs. To bump one, resolve the new tag's SHA (gh api repos/<owner>/<repo>/commits/<tag> --jq .sha) and update both the SHA and the comment. actionlint .github/workflows/*.yml validates the files.

Deployment

Both registries publish from a v* tag (git tag -s v0.1.0 && git push origin v0.1.0) or a manual Run workflow dispatch. Bump the version in Cargo.toml and pyproject.toml first — they are separate files and must agree.

PyPI — `.github/workflows/release-pypi.yml`

Builds wheels with maturin-action for Linux (x86_64, aarch64), macOS (x86_64, aarch64) and Windows (x64), plus an sdist, then uploads everything in one publish job via pypa/gh-action-pypi-publish (maturin upload only authenticates with an API token, so it cannot do the OIDC exchange trusted publishing needs).

One-time setup: on PyPI, add a trusted publisher for the modelo project pointing at this repository and the workflow file release-pypi.yml with environment pypi; then create a GitHub environment named pypi. No API token is stored — the job authenticates with the OIDC token from id-token: write.

crates.io — `.github/workflows/release-crates.yml`

Runs the test suite and cargo package first, then cargo publish.

One-time setup: create a crates.io API token scoped to publish-update for this crate, and store it as the secret CARGO_REGISTRY_TOKEN in a GitHub environment named crates-io.

Local dry runs

cargo publish --dry-run
maturin build --release   # wheel lands in target/wheels/

License

Download files

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

Source Distribution

python_modelo-0.8.0.tar.gz (148.8 kB view details)

Uploaded Aug 14, 2026 Source

Built Distributions

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.

python_modelo-0.8.0-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (992.7 kB view details)

Uploaded Aug 14, 2026 PyPymanylinux: glibc 2.17+ x86-64

python_modelo-0.8.0-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (984.8 kB view details)

Uploaded Aug 14, 2026 PyPymanylinux: glibc 2.17+ ARM64

python_modelo-0.8.0-cp315-cp315t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (993.3 kB view details)

Uploaded Aug 14, 2026 CPython 3.15tmanylinux: glibc 2.17+ x86-64

python_modelo-0.8.0-cp315-cp315-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (989.3 kB view details)

Uploaded Aug 14, 2026 CPython 3.15manylinux: glibc 2.17+ x86-64

python_modelo-0.8.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (993.7 kB view details)

Uploaded Aug 14, 2026 CPython 3.14tmanylinux: glibc 2.17+ x86-64

python_modelo-0.8.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (978.8 kB view details)

Uploaded Aug 14, 2026 CPython 3.14tmanylinux: glibc 2.17+ ARM64

python_modelo-0.8.0-cp314-cp314-win_amd64.whl (804.7 kB view details)

Uploaded Aug 14, 2026 CPython 3.14Windows x86-64

python_modelo-0.8.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (987.7 kB view details)

Uploaded Aug 14, 2026 CPython 3.14manylinux: glibc 2.17+ x86-64

python_modelo-0.8.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (977.0 kB view details)

Uploaded Aug 14, 2026 CPython 3.14manylinux: glibc 2.17+ ARM64

python_modelo-0.8.0-cp314-cp314-macosx_11_0_arm64.whl (885.1 kB view details)

Uploaded Aug 14, 2026 CPython 3.14macOS 11.0+ ARM64

python_modelo-0.8.0-cp313-cp313-win_amd64.whl (803.1 kB view details)

Uploaded Aug 14, 2026 CPython 3.13Windows x86-64

python_modelo-0.8.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (986.5 kB view details)

Uploaded Aug 14, 2026 CPython 3.13manylinux: glibc 2.17+ x86-64

python_modelo-0.8.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (976.3 kB view details)

Uploaded Aug 14, 2026 CPython 3.13manylinux: glibc 2.17+ ARM64

python_modelo-0.8.0-cp313-cp313-macosx_11_0_arm64.whl (883.4 kB view details)

Uploaded Aug 14, 2026 CPython 3.13macOS 11.0+ ARM64

python_modelo-0.8.0-cp312-cp312-win_amd64.whl (803.4 kB view details)

Uploaded Aug 14, 2026 CPython 3.12Windows x86-64

python_modelo-0.8.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (987.2 kB view details)

Uploaded Aug 14, 2026 CPython 3.12manylinux: glibc 2.17+ x86-64

python_modelo-0.8.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (975.5 kB view details)

Uploaded Aug 14, 2026 CPython 3.12manylinux: glibc 2.17+ ARM64

python_modelo-0.8.0-cp312-cp312-macosx_11_0_arm64.whl (883.7 kB view details)

Uploaded Aug 14, 2026 CPython 3.12macOS 11.0+ ARM64

python_modelo-0.8.0-cp311-cp311-win_amd64.whl (807.1 kB view details)

Uploaded Aug 14, 2026 CPython 3.11Windows x86-64

python_modelo-0.8.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl (991.0 kB view details)

Uploaded Aug 14, 2026 CPython 3.11manylinux: glibc 2.17+ x86-64

python_modelo-0.8.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl (980.6 kB view details)

Uploaded Aug 14, 2026 CPython 3.11manylinux: glibc 2.17+ ARM64

python_modelo-0.8.0-cp311-cp311-macosx_11_0_arm64.whl (890.9 kB view details)

Uploaded Aug 14, 2026 CPython 3.11macOS 11.0+ ARM64

File details

Details for the file python_modelo-0.8.0.tar.gz.

File metadata

Download URL: python_modelo-0.8.0.tar.gz
Upload date: Aug 14, 2026
Size: 148.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.4 {"installer":{"name":"uv","version":"0.12.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for python_modelo-0.8.0.tar.gz
Algorithm	Hash digest
SHA256	`270d9e989505c2e86b4d6a4b628d834e5429fa1edcb16d336ebc46f67ce3ac1c`
MD5	`c0947c48f9ab716088abb9b070b7a995`
BLAKE2b-256	`ac7bf4ed67b0160f53af9171002e776add1b5d6d00662161bfca8acbebcef424`

Algorithm	Hash digest
SHA256	`dd5fe8477f066986fb68e43b980480128ea6b0be056523cbb8021cdfb6afe3df`
MD5	`da7bb1d6692bbec1b10a890bfe4c5fa1`
BLAKE2b-256	`21980e7b82b16697ef40bbb31f57b6b4e28952460ac8b283a5e01301e2d721c8`

Algorithm	Hash digest
SHA256	`0ed02759eca53d4336688e7ba034a1cbb2c642f08bcdae5cc7d636709e2135f6`
MD5	`a372f9776716627f665162893206a5a1`
BLAKE2b-256	`22f0c83fbb1544450ba9351739b358316871b6055bc921284aeef02fa9501543`

Algorithm	Hash digest
SHA256	`934fb528a5b4a53cb5b26b589e11f8d263692c9a8383e18ead88baa986c54062`
MD5	`a49085e28768ed4737cc9086c8802cd3`
BLAKE2b-256	`3db820dd3990c65ae25359fa2be7d3183dd7872082800caac1c5ea84e540e953`

Algorithm	Hash digest
SHA256	`13241c52d5299c860cf4e59364e66c4d7890ad5d60b09d0a63e492431521bb8b`
MD5	`bd070a788afb866d9a086110e39423c7`
BLAKE2b-256	`09873b63609fcd0f22472d6805ed13b3f68ec72e1698764c6b7832c46a588a2f`

Algorithm	Hash digest
SHA256	`5fea63caa0e0431e5748481fdf9ac05325d0667354bfc66271c601fa0ee39cbd`
MD5	`14f941bc36c646aebaedd721cdeb4f9b`
BLAKE2b-256	`ef86561bd81db0c43f2c197833193295e835da840db966c4af425d418321845a`

Algorithm	Hash digest
SHA256	`55bb0800bb3a5ab50a4deb7ad18682017b764bedaf22b68677edcd972dbb3bec`
MD5	`605de81207539894db562a92cd2bc331`
BLAKE2b-256	`3b9af8eb4ae924c7d47702cc41ace36e8e9eafbb9fe8f814a846e95665ff694b`

Algorithm	Hash digest
SHA256	`b1e48463a6c23a4f0a80327186c0813fa5b2bdfc0e64e9e372b2f3aab658a608`
MD5	`7bb61e98795a6550995b7e004983d44d`
BLAKE2b-256	`416dd7c61b02ec59081c1e1f398f69bded050dd199e6e23c5315ba375a75234d`

Algorithm	Hash digest
SHA256	`3930c5a89b1b683136085bcef8d4966836d49790312ceec58e85d263ebefd270`
MD5	`015fc4d713a58bd4548dd7756adbc3c7`
BLAKE2b-256	`773b32b5491fb1ebdd520ff39858a00b558431d0a065a9ed73a8dfdd8bf4202a`

Algorithm	Hash digest
SHA256	`41486b5cf33a40a6c68d7d0f4e8348894f308f4420f3948db0edc6ab5783ab2e`
MD5	`4eb122922a2cd547d6de5e56227ad825`
BLAKE2b-256	`ce056a7097c1b50be80821a44808224b5725212e31ac2fab964ff86e3771d7ab`

Algorithm	Hash digest
SHA256	`6df2df09581aaf87a876db21176f1bd58351b3dd8a37cee5c17b797994fe2452`
MD5	`3d70bbe2af39163d569811eccc923dfa`
BLAKE2b-256	`71ce5b17afa2718d3c940052a94f546beab400a3f10821b9886478be70768b50`

Algorithm	Hash digest
SHA256	`9d09a2b633ea28a5ed520b7355e920ea71d01c707ecae2ebdb7b4b2821334081`
MD5	`8702c1f3c7704569145eaa2c5d3dc68b`
BLAKE2b-256	`7bcd781c832b7503f6625dd0e59f507cf73b6541ecdb274c57d283df1a3da5f7`

Algorithm	Hash digest
SHA256	`7c8837e89a016191e6157b72aa342d58e9db5c1001fc047c25794c4fdfa71ed4`
MD5	`ff6c49c7526134ade38b128c7604f71a`
BLAKE2b-256	`bb2b3a65ba9300a50aff63ed7a571cd1c37de5a5707a559933b9c9246bf5483a`

Algorithm	Hash digest
SHA256	`139c5c82d6b8ecc9b50b5054f1bc341ebf6abe8b44fe243532cd568006c76d47`
MD5	`ea71a17239a5e0e7b50542fe2e5f5853`
BLAKE2b-256	`d886892efa3ef9db8f84703f2ccc93314d661ff38d79cf253a94642cca1d8fed`

Algorithm	Hash digest
SHA256	`8506f69a594b7cd051b51f8b16d0c2a2c8cc94b852dc51d06028b88c6ca81e64`
MD5	`06679fe3f7501c44c5db224cdc484740`
BLAKE2b-256	`4d31272eeae60f53b0d1b0dbb397b20bcedbaacb1952a9624c8757c1f55ae1ab`

Algorithm	Hash digest
SHA256	`080befee29406585baaadc17457fca16ed69204e9941108efb4ee660772d8372`
MD5	`5ca9108c615c9ca2381e13f1c0049e6a`
BLAKE2b-256	`67684d4a63fb85f08ad3d29a387386a6a5679ad049866941a1a4f879c9210077`

Algorithm	Hash digest
SHA256	`1361036c61513689a3d9da81bddef05367ee83ce378f6e54d3d0efd5179a02c7`
MD5	`e92bf6886e1002855f76f129fe487e30`
BLAKE2b-256	`47d8d1feefeeb5626c8606f6e0a23cc930a025e818e09138e2d0ac4518e4b2a5`

Algorithm	Hash digest
SHA256	`bd2b7b7964af7a66a06442019fa04d8bfe6b1c0546bb73d089f061f08919c9ec`
MD5	`0295e90d8cd5591ec8abc92dcc28e59c`
BLAKE2b-256	`a0c5c8be5fd6f8a902e05c497bcfaf16b35b1d32a5c031c8af5868db270a378b`

Algorithm	Hash digest
SHA256	`34d7756307125b540da02bd0a4fc5e7cde13b402de6e1b570b6f61f9237b6210`
MD5	`921a29e02b955822e49c84b23f94e9cf`
BLAKE2b-256	`c10d8adb83515238ad671e99ef714d7900d4c9c0506effdf9f2531ef0923a9de`

Algorithm	Hash digest
SHA256	`283b671be73aeaf1f4f5e37d7bfaa6b1287fe255041ef918251e20e2082e9957`
MD5	`30dc2444a74632a9219fbb07612cc89d`
BLAKE2b-256	`4f281ab3b74b7f5efb0b475a20b34d6c0be315830547be6e6eeb7f6579d18a7c`

Algorithm	Hash digest
SHA256	`5d1759a6378ce8d8d4c56ae95669d12e3f3ea71ec142cdf47151bb33c58aca83`
MD5	`e45cfcbd9b38a6cd813ad90a4f2384a6`
BLAKE2b-256	`870c1da547ae1dd342c83d89f1735e865d610cd6752ade2bd6fedd964e90e304`

python-modelo 0.8.0

modelo

Namespaces

Workspace layout

Build

Validating files: the modelo CLI

Interactive TUI

Using it from Python

Type checking

Examples

Checking parity against python-ort

Continuous integration

Deployment

PyPI — .github/workflows/release-pypi.yml

crates.io — .github/workflows/release-crates.yml

Local dry runs

License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License expression

Requires

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

File metadata

File hashes

File details

Validating files: the `modelo` CLI

PyPI — `.github/workflows/release-pypi.yml`

crates.io — `.github/workflows/release-crates.yml`

Algorithm	Hash digest
SHA256	`79740732b276abd8528808266f86f6d1ee01e6d3aeec15b0a9c36ca37ca294c0`
MD5	`f91ab3a4315e634baf5d91147c271c72`
BLAKE2b-256	`addfa31e6f018e233969a6838193ae207f4bb0c27baa4ed4647f30391d0504f5`

Algorithm	Hash digest
SHA256	`cbeb4328cd632255ac45d6c7676fceeed21c56d965a804ce2f2a1f56274c1c48`
MD5	`40130b1b55b47de43d7c09bfd56ee842`
BLAKE2b-256	`35008d0c33b80f1927275b0ccf821bf2193d6ca5cc7c6f831669047ee323d1fd`