{
  "generator": {
    "matra": "0.3.0",
    "udpipe_model": {
      "name": "english-ewt-ud-2.5-191206",
      "sha256": "784bd0fa85e3d831fd02a55290d0acfd05c953159dc38cc33d52e1b28add9957"
    }
  },
  "page": "reference/platforms.md",
  "paragraphs": [
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.6552,
      "readability_grade": 7.5616,
      "sentences": 2,
      "text": "What each of matra's install routes needs and installs, and the models matra downloads. Install matra has the steps; One core, three install routes explains the choices behind them.",
      "words": 30
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.4643,
      "readability_grade": 13.4514,
      "sentences": 1,
      "text": "The Python package installs the library and the matra command, which is the Rust CLI reached through the extension module, and has no runtime dependencies of its own.",
      "words": 28
    },
    {
      "compression_ratio": 0.569,
      "kind": "paragraph",
      "lexical_density": 0.6429,
      "readability_grade": 4.6614,
      "sentences": 4,
      "text": "The wheels are built against the CPython stable ABI and tagged abi3, so one wheel per platform serves 3.12 and every later 3.x on GIL-enabled CPython. A free-threaded interpreter (python3.14t, for one) accepts a different tag, abi3t, so it gets no wheel on any platform and builds the sdist; pyo3 gains the free-threaded stable ABI at 3.15. Wherever no wheel fits, pip builds the sdist, which needs the toolchains above.",
      "words": 75
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.5882,
      "readability_grade": 6.7494,
      "sentences": 1,
      "text": "Every release file from 0.2.1 on carries a build provenance attestation; Verifying a release has the commands.",
      "words": 17
    },
    {
      "compression_ratio": 0.5955,
      "kind": "paragraph",
      "lexical_density": 0.4528,
      "readability_grade": 4.518,
      "sentences": 3,
      "text": "An install line with no version takes the newest release on the registry. 0.1.0 is still published, and its matra command is a separate Python implementation with its own --json shape and a model directory fixed at ~/.matra/models. 0.2 is published too, with the surface Migrate from 0.2 to 0.3 moves you off.",
      "words": 54
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.5385,
      "readability_grade": 7.6338,
      "sentences": 1,
      "text": "matra --version prints the version, then the features the build was compiled with:",
      "words": 13
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.6735,
      "readability_grade": 11.4902,
      "sentences": 3,
      "text": "That is the CLI binary from cargo install. The Python package prints features: udpipe model2vec python cli. Every analysis command behaves the same in both builds except matra clusters, which needs model2vec and refuses, naming it, in a build without; cargo install matra --features cli,model2vec builds one with it.",
      "words": 49
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.6111,
      "readability_grade": 9.13,
      "sentences": 1,
      "text": "The library, the CLI and the Python package resolve the model directory the same way, first match wins:",
      "words": 18
    },
    {
      "compression_ratio": null,
      "kind": "list_item",
      "lexical_density": 0.56,
      "readability_grade": 19.176,
      "sentences": 1,
      "text": "A directory passed explicitly: --model-dir on the command line, Config::with_model_dir in Rust, or the directory argument of the constructors that take one, such as Model2Vec::potion_base_8m.",
      "words": 28
    },
    {
      "compression_ratio": null,
      "kind": "list_item",
      "lexical_density": 1,
      "readability_grade": null,
      "sentences": 1,
      "text": "MATRA_MODEL_DIR.",
      "words": 1
    },
    {
      "compression_ratio": null,
      "kind": "list_item",
      "lexical_density": 0.6429,
      "readability_grade": 14.9543,
      "sentences": 1,
      "text": "The models directory of the data root, which is MATRA_DATA_DIR, else $XDG_DATA_HOME/matra, else ~/.local/share/matra.",
      "words": 16
    },
    {
      "compression_ratio": null,
      "kind": "list_item",
      "lexical_density": 0.6061,
      "readability_grade": 9.082,
      "sentences": 2,
      "text": "A pre-existing, non-empty ~/.matra/models from an older install, when the location in 3 does not exist yet. matra never creates ~/.matra; a selected legacy cache is used as the model directory, downloads included.",
      "words": 35
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.625,
      "readability_grade": 8.52,
      "sentences": 1,
      "text": "Where matra keeps things has the config file and data root beside it, and matra config show prints which rung each value came from.",
      "words": 24
    },
    {
      "compression_ratio": 0.4973,
      "kind": "paragraph",
      "lexical_density": 0.5376,
      "readability_grade": 13.1442,
      "sentences": 4,
      "text": "The download is held in memory, checked against the pinned hash, and written only if it matches, so nothing unverified reaches the model directory and an interrupted transfer leaves nothing behind. A mismatch downloads once more; a second mismatch is an error, and nothing is loaded. A cached parsing model that fails the check is replaced only when new bytes verify, so a re-download that cannot reach the network leaves the file that was there. The embedding model is never written over files already in its directory; Provisioning has what it does instead.",
      "words": 94
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.575,
      "readability_grade": 6.72,
      "sentences": 3,
      "text": "The library prints nothing while it downloads. The command line prints two lines on stderr before either model's download, naming the model, its size, where it is going and its license; --quiet silences them. Errors has what each failure returns.",
      "words": 41
    },
    {
      "compression_ratio": null,
      "kind": "paragraph",
      "lexical_density": 0.5,
      "readability_grade": 7.19,
      "sentences": 2,
      "text": "matra's code is MIT. The models it downloads are separate files, published by other people under licenses of their own.",
      "words": 21
    },
    {
      "compression_ratio": 0.6068,
      "kind": "paragraph",
      "lexical_density": 0.5625,
      "readability_grade": 9.5792,
      "sentences": 3,
      "text": "The parsing model's license does not permit commercial use. The UDPipe models page states that the UDPipe 1 models it publishes for Universal Dependencies are distributed under CC BY-NC-SA. This page reports what the licenses say and does not interpret them; read the license text for the terms.",
      "words": 51
    },
    {
      "compression_ratio": 0.587,
      "kind": "paragraph",
      "lexical_density": 0.5469,
      "readability_grade": 7.7969,
      "sentences": 3,
      "text": "The command line and the config file always use this parsing model: --model-dir, MATRA_MODEL_DIR and the other settings change where it is stored, not which model it is. models.udpipe, which earlier releases wrote into the config file, is gone, and a file that still sets it fails to load, saying so. No surface loads a different UDPipe model file: the model is a pin.",
      "words": 65
    }
  ]
}
