decision-toolkit 0.4.0__tar.gz → 0.4.1__tar.gz

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/CHANGELOG.md

@@ -1,8 +1,15 @@
 # Changelog
 
-All notable changes to this project are documented here. Version `0.4.0` is
+All notable changes to this project are documented here. Version `0.4.1` is
 published on PyPI.
 
+## [0.4.1] — 2026-10-21
+
+Catalog presentation patch: every variant now carries its REST alias
+(`id@variant`) in `dtk models list`, `--json` and `dtk models variants`. Model
+cards include copy-paste loading examples for library, CLI and REST for every
+variant. No model or runtime changes.
+
 ## [0.4.0] — 2026-10-21
 
 REST variant-selection correction. Quantizations are selected through standard
@@ -209,6 +216,7 @@ README correction. No code or model behavior changed.
 - Typed `DecisionModel` API with lifecycle, batching, async, usage, warnings,
   normalized confidence, capabilities, structured events and atomic model store.
 
+[0.4.1]: https://pypi.org/project/decision-toolkit/0.4.1/
 [0.4.0]: https://pypi.org/project/decision-toolkit/0.4.0/
 [0.3.1]: https://pypi.org/project/decision-toolkit/0.3.1/
 [0.3.0]: https://pypi.org/project/decision-toolkit/0.3.0/

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: decision-toolkit
-Version: 0.4.0
+Version: 0.4.1
 Summary: Local-first toolkit for open-weights decision models: one ONNX engine, one adapter per model contract, typed choice/yes-no/score decisions with probabilities on CPU.
 Project-URL: Homepage, https://github.com/gia-uh/decision-toolkit
 Project-URL: Repository, https://github.com/gia-uh/decision-toolkit
@@ -59,7 +59,7 @@ and CLI. `dtk --help` and every subcommand help also include runnable examples.
 ## Installation
 
 ```bash
-uv pip install decision-toolkit              # library + CLI (0.4.0 on PyPI)
+uv pip install decision-toolkit              # library + CLI (0.4.1 on PyPI)
 uv pip install "decision-toolkit[onnx]"      # + onnxruntime, tokenizers (the model runtime)
 uv pip install "decision-toolkit[server]"    # + REST server (FastAPI)
 ```
@@ -67,7 +67,7 @@ uv pip install "decision-toolkit[server]"    # + REST server (FastAPI)
 The project is managed with [uv](https://docs.astral.sh/uv/) and ships a committed `uv.lock`. Published
 wheels remain compatible with `pip` for environments that do not use uv.
 
-PyPI: <https://pypi.org/project/decision-toolkit/0.4.0/>. See
+PyPI: <https://pypi.org/project/decision-toolkit/0.4.1/>. See
 [docs/RELEASE.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/RELEASE.md)
 for the Trusted Publishing flow and clean-install checks.
 
@@ -211,6 +211,9 @@ adapters (there is no generic "any ONNX" adapter).
 | `open-jev-deberta-v3-large` | `open-jev` | **m0** — Open-Jev DeBERTa v3 large repro; 0.854 in-domain (241 ms) | `fp16`* (884 MB); `fp32` (1758 MB); `q4` (487 MB); `q4f16` (357 MB) |
 | `strands-decider-2b` | `strands-decider` | **m0** — reference fixture match (719 ms) | `q4f16`* (1114 MB); `q8` (1821 MB) |
 
+Each variant has a REST alias in the form `id@variant`; `dtk models list` prints
+the alias next to every variant.
+
 **Only `m0` models are in the catalog.** Researched-but-unavailable models
 (planned, conversion pending, broken exports) are listed in
 [docs/ROADMAP.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/ROADMAP.md) and are not downloadable through the toolkit.

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/README.md

@@ -21,7 +21,7 @@ and CLI. `dtk --help` and every subcommand help also include runnable examples.
 ## Installation
 
 ```bash
-uv pip install decision-toolkit              # library + CLI (0.4.0 on PyPI)
+uv pip install decision-toolkit              # library + CLI (0.4.1 on PyPI)
 uv pip install "decision-toolkit[onnx]"      # + onnxruntime, tokenizers (the model runtime)
 uv pip install "decision-toolkit[server]"    # + REST server (FastAPI)
 ```
@@ -29,7 +29,7 @@ uv pip install "decision-toolkit[server]"    # + REST server (FastAPI)
 The project is managed with [uv](https://docs.astral.sh/uv/) and ships a committed `uv.lock`. Published
 wheels remain compatible with `pip` for environments that do not use uv.
 
-PyPI: <https://pypi.org/project/decision-toolkit/0.4.0/>. See
+PyPI: <https://pypi.org/project/decision-toolkit/0.4.1/>. See
 [docs/RELEASE.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/RELEASE.md)
 for the Trusted Publishing flow and clean-install checks.
 
@@ -173,6 +173,9 @@ adapters (there is no generic "any ONNX" adapter).
 | `open-jev-deberta-v3-large` | `open-jev` | **m0** — Open-Jev DeBERTa v3 large repro; 0.854 in-domain (241 ms) | `fp16`* (884 MB); `fp32` (1758 MB); `q4` (487 MB); `q4f16` (357 MB) |
 | `strands-decider-2b` | `strands-decider` | **m0** — reference fixture match (719 ms) | `q4f16`* (1114 MB); `q8` (1821 MB) |
 
+Each variant has a REST alias in the form `id@variant`; `dtk models list` prints
+the alias next to every variant.
+
 **Only `m0` models are in the catalog.** Researched-but-unavailable models
 (planned, conversion pending, broken exports) are listed in
 [docs/ROADMAP.md](https://github.com/gia-uh/decision-toolkit/blob/main/docs/ROADMAP.md) and are not downloadable through the toolkit.

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/docs/CLI.md

@@ -151,6 +151,9 @@ are already downloaded.
 | `open-jev-deberta-v3-large` | `fp16`*, `fp32`, `q4`, `q4f16` | fp16 / fp32 / q4 / q4-fp16 | 883.5 / 1757.9 / 486.7 / 357.0 MB |
 | `strands-decider-2b` | `q4f16`*, `q8` | q4-fp16 / int8 | 1113.6 / 1821.4 MB |
 
+Each row is also addressable over REST as `model = "<id>@<variant>"`; the alias
+is printed by `dtk models list` and by `dtk models variants <id>`.
+
 ```bash
 # inspect, including the exact download command for each variant
 dtk models list --quant

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/docs/RELEASE.md

@@ -39,7 +39,7 @@ Clean install test (no `PYTHONPATH`):
 ```bash
 uv venv --python 3.12 /tmp/dtk-wheel
 uv pip install --python /tmp/dtk-wheel/bin/python \
-  dist/decision_toolkit-0.4.0-py3-none-any.whl
+  dist/decision_toolkit-0.4.1-py3-none-any.whl
 uv pip check --python /tmp/dtk-wheel/bin/python
 /tmp/dtk-wheel/bin/dtk --version
 /tmp/dtk-wheel/bin/dtk models list --json
@@ -50,7 +50,7 @@ With inference and server extras:
 
 ```bash
 uv pip install --python /tmp/dtk-wheel/bin/python \
-  "dist/decision_toolkit-0.4.0-py3-none-any.whl[onnx,server,tracing]"
+  "dist/decision_toolkit-0.4.1-py3-none-any.whl[onnx,server,tracing]"
 /tmp/dtk-wheel/bin/dtk decide --model gliner2.5-decide ...
 /tmp/dtk-wheel/bin/dtk serve --model gliner2.5-decide --warmup --port 8016
 curl -s http://127.0.0.1:8016/health
@@ -84,8 +84,8 @@ No long-lived PyPI token is needed; the workflow uses GitHub OIDC
 4. Create and push an annotated tag:
 
    ```bash
-   git tag -a v0.4.0 -m "decision-toolkit 0.4.0"
-   git push origin v0.4.0
+   git tag -a v0.4.1 -m "decision-toolkit 0.4.1"
+   git push origin v0.4.1
    ```
 
 5. `.github/workflows/release.yml` builds once, publishes to **TestPyPI**, then
@@ -134,9 +134,9 @@ to TestPyPI without publishing to PyPI or creating a GitHub release.
 
 ## Published release
 
-`0.4.0` is published through Trusted Publishing on 2026-10-21:
+`0.4.1` is published through Trusted Publishing on 2026-10-21:
 
-<https://pypi.org/project/decision-toolkit/0.4.0/>
+<https://pypi.org/project/decision-toolkit/0.4.1/>
 
 `0.1.0` was the first release; `0.1.1` refreshed the PyPI description; `0.1.2`
 validated the OIDC TestPyPI → PyPI flow; `0.1.3` added post-publish install
@@ -147,7 +147,8 @@ complete variant/quantization visibility and CLI selection; `0.1.7` aligned
 selection across library, CLI and REST; `0.2.0` corrected the REST conformance
 claims and wire shapes; `0.2.1` changed the public documentation URLs; `0.3.0`
 added the three new ONNX decision models; `0.3.1` made the catalog list one row per variant; `0.4.0` moved REST variant
-selection to standard model aliases.
+selection to standard model aliases; `0.4.1` exposed aliases in the catalog and
+per-variant loading examples in every model card.
 
 The tag-triggered workflow remains the preferred path for future releases once
 the TestPyPI/PyPI trusted publishers and protected environments are configured.

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/docs/VARIANTS.md

@@ -18,23 +18,23 @@ have not passed the catalog gates are not exposed as variants.
 A `*` marks the default variant. It is used when `--variant` is omitted and no
 other variant was selected with `dtk models use`.
 
-| Model | Variant | Quantization | Size | Role | Download |
-| --- | --- | --- | ---: | --- | --- |
-| `gliner2.5-multi` | `fp16` * | fp16 encoder + fp32 classifier | 577.1 MB | default | `dtk models download gliner2.5-multi --variant fp16` |
-| `gliner2.5-multi` | `fp32` | fp32 encoder + fp32 classifier | 1131.9 MB | quality | `dtk models download gliner2.5-multi --variant fp32` |
-| `gliner2.5-decide` | `q4f16` * | q4/fp16 | 523.5 MB | default | `dtk models download gliner2.5-decide --variant q4f16` |
-| `laya` | `q8` * | int8 | 527.9 MB | default | `dtk models download laya --variant q8` |
-| `julia-1` | `fp32` * | fp32 | 618.2 MB | default | `dtk models download julia-1 --variant fp32` |
-| `opendecider-nano` | `q8f16` * | int8/fp16 | 468.8 MB | default | `dtk models download opendecider-nano --variant q8f16` |
-| `opendecider-nano` | `fp16` | fp16 | 791.9 MB | quality | `dtk models download opendecider-nano --variant fp16` |
-| `laya-multilingual` | `fp16` * | fp16 | 681.8 MB | default | `dtk models download laya-multilingual --variant fp16` |
-| `laya-multilingual` | `fp32` | fp32 | 1325.6 MB | quality | `dtk models download laya-multilingual --variant fp32` |
-| `open-jev-deberta-v3-large` | `fp16` * | fp16 | 883.5 MB | default | `dtk models download open-jev-deberta-v3-large --variant fp16` |
-| `open-jev-deberta-v3-large` | `fp32` | fp32 | 1757.9 MB | quality | `dtk models download open-jev-deberta-v3-large --variant fp32` |
-| `open-jev-deberta-v3-large` | `q4` | q4 | 486.7 MB | edge | `dtk models download open-jev-deberta-v3-large --variant q4` |
-| `open-jev-deberta-v3-large` | `q4f16` | q4/fp16 | 357.0 MB | edge | `dtk models download open-jev-deberta-v3-large --variant q4f16` |
-| `strands-decider-2b` | `q4f16` * | q4/fp16 | 1113.6 MB | default | `dtk models download strands-decider-2b --variant q4f16` |
-| `strands-decider-2b` | `q8` | int8 | 1821.4 MB | quality | `dtk models download strands-decider-2b --variant q8` |
+| Model | Variant | REST alias | Quantization | Size | Role | Download |
+| --- | --- | --- | --- | ---: | --- | --- |
+| `gliner2.5-multi` | `fp16` * | `gliner2.5-multi@fp16` | fp16 | 577.1 MB | default | `dtk models download gliner2.5-multi --variant fp16` |
+| `gliner2.5-multi` | `fp32` | `gliner2.5-multi@fp32` | fp32 | 1131.9 MB | quality | `dtk models download gliner2.5-multi --variant fp32` |
+| `gliner2.5-decide` | `q4f16` * | `gliner2.5-decide@q4f16` | q4/fp16 | 523.5 MB | default | `dtk models download gliner2.5-decide --variant q4f16` |
+| `laya` | `q8` * | `laya@q8` | int8 | 527.9 MB | default | `dtk models download laya --variant q8` |
+| `julia-1` | `fp32` * | `julia-1@fp32` | fp32 | 618.2 MB | default | `dtk models download julia-1 --variant fp32` |
+| `opendecider-nano` | `q8f16` * | `opendecider-nano@q8f16` | int8/fp16 | 468.8 MB | default | `dtk models download opendecider-nano --variant q8f16` |
+| `opendecider-nano` | `fp16` | `opendecider-nano@fp16` | fp16 | 791.9 MB | quality | `dtk models download opendecider-nano --variant fp16` |
+| `laya-multilingual` | `fp16` * | `laya-multilingual@fp16` | fp16 | 681.8 MB | default | `dtk models download laya-multilingual --variant fp16` |
+| `laya-multilingual` | `fp32` | `laya-multilingual@fp32` | fp32 | 1325.6 MB | quality | `dtk models download laya-multilingual --variant fp32` |
+| `open-jev-deberta-v3-large` | `q4f16` | `open-jev-deberta-v3-large@q4f16` | q4/fp16 | 357.0 MB | edge | `dtk models download open-jev-deberta-v3-large --variant q4f16` |
+| `open-jev-deberta-v3-large` | `fp16` * | `open-jev-deberta-v3-large@fp16` | fp16 | 883.5 MB | default | `dtk models download open-jev-deberta-v3-large --variant fp16` |
+| `open-jev-deberta-v3-large` | `q4` | `open-jev-deberta-v3-large@q4` | q4 | 486.7 MB | edge | `dtk models download open-jev-deberta-v3-large --variant q4` |
+| `open-jev-deberta-v3-large` | `fp32` | `open-jev-deberta-v3-large@fp32` | fp32 | 1757.9 MB | quality | `dtk models download open-jev-deberta-v3-large --variant fp32` |
+| `strands-decider-2b` | `q4f16` * | `strands-decider-2b@q4f16` | q4/fp16 | 1113.6 MB | default | `dtk models download strands-decider-2b --variant q4f16` |
+| `strands-decider-2b` | `q8` | `strands-decider-2b@q8` | int8 | 1821.4 MB | quality | `dtk models download strands-decider-2b --variant q8` |
 
 Models with a single row have only one catalogued, verified build. That does
 not mean other conversions do not exist upstream; it means they have not passed

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/docs/models/gliner2.5-decide.md

@@ -54,6 +54,40 @@ in the toolkit; see [Variants and quantization](../VARIANTS.md).
 - Quantized q4f16; the fp16/fp32 builds may resolve the sentiment example differently.
 - The model card's examples are "potential outputs", not guarantees; validate on your data.
 
+## Loading each variant
+
+REST selects the quantization through the standard `model` field using the
+alias `gliner2.5-decide@variant`; there is no `variant` field in the request body.
+
+### `q4f16` (q4/fp16, default)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("gliner2.5-decide", variant="q4f16")
+```
+
+**CLI**
+
+```bash
+dtk models download gliner2.5-decide --variant q4f16
+dtk models use gliner2.5-decide --variant q4f16
+dtk decide --model gliner2.5-decide --variant q4f16 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "gliner2.5-decide@q4f16", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
 ## Usage
 
 ```bash

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/docs/models/gliner2.5-multi.md

@@ -55,6 +55,69 @@ makes it persistent. See [Variants and quantization](../VARIANTS.md).
 - English/multilingual tokenizer fallback: the run above used the raw `tokenizers` fallback; a `transformers` tokenizer may change scores slightly.
 - Benchmarked on a synthetic Spanish routing set; validate on your own data.
 
+## Loading each variant
+
+REST selects the quantization through the standard `model` field using the
+alias `gliner2.5-multi@variant`; there is no `variant` field in the request body.
+
+### `fp16` (fp16, default)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("gliner2.5-multi", variant="fp16")
+```
+
+**CLI**
+
+```bash
+dtk models download gliner2.5-multi --variant fp16
+dtk models use gliner2.5-multi --variant fp16
+dtk decide --model gliner2.5-multi --variant fp16 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "gliner2.5-multi@fp16", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
+### `fp32` (fp32, quality)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("gliner2.5-multi", variant="fp32")
+```
+
+**CLI**
+
+```bash
+dtk models download gliner2.5-multi --variant fp32
+dtk models use gliner2.5-multi --variant fp32
+dtk decide --model gliner2.5-multi --variant fp32 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "gliner2.5-multi@fp32", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
 ## Usage
 
 ```bash

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/docs/models/julia-1.md

@@ -55,6 +55,40 @@ exists but was not validated and is not catalogued; see
 - Historical benchmarks used 1024 tokens; accuracy at 8k is not established by the export.
 - The tokenizer uses `<mask>/<bos>/<eos>`; both conventions are handled, but this checkpoint's tokenizer is the `<...>` one.
 
+## Loading each variant
+
+REST selects the quantization through the standard `model` field using the
+alias `julia-1@variant`; there is no `variant` field in the request body.
+
+### `fp32` (fp32, default)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("julia-1", variant="fp32")
+```
+
+**CLI**
+
+```bash
+dtk models download julia-1 --variant fp32
+dtk models use julia-1 --variant fp32
+dtk decide --model julia-1 --variant fp32 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "julia-1@fp32", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
 ## Usage
 
 ```bash

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/docs/models/laya-multilingual.md

@@ -68,6 +68,69 @@ the full-precision build. Select one with
 - The adapter uses the fused graph path; the English split checkpoint remains a
   separate catalog entry (`laya`).
 
+## Loading each variant
+
+REST selects the quantization through the standard `model` field using the
+alias `laya-multilingual@variant`; there is no `variant` field in the request body.
+
+### `fp16` (fp16, default)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("laya-multilingual", variant="fp16")
+```
+
+**CLI**
+
+```bash
+dtk models download laya-multilingual --variant fp16
+dtk models use laya-multilingual --variant fp16
+dtk decide --model laya-multilingual --variant fp16 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "laya-multilingual@fp16", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
+### `fp32` (fp32, quality)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("laya-multilingual", variant="fp32")
+```
+
+**CLI**
+
+```bash
+dtk models download laya-multilingual --variant fp32
+dtk models use laya-multilingual --variant fp32
+dtk decide --model laya-multilingual --variant fp32 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "laya-multilingual@fp32", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
 ## Usage
 
 ```bash

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/docs/models/laya.md

@@ -61,6 +61,40 @@ fp32 build; see [Variants and quantization](../VARIANTS.md).
 - **English checkpoint.** The multilingual checkpoint is a different model (mmBERT-base) and has no split public export yet.
 - q8 quantization; the fp32 build was not published in this repo.
 
+## Loading each variant
+
+REST selects the quantization through the standard `model` field using the
+alias `laya@variant`; there is no `variant` field in the request body.
+
+### `q8` (int8, default)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("laya", variant="q8")
+```
+
+**CLI**
+
+```bash
+dtk models download laya --variant q8
+dtk models use laya --variant q8
+dtk decide --model laya --variant q8 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "laya@q8", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
 ## Usage
 
 ```bash

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/docs/models/open-jev-deberta-v3-large.md

@@ -67,6 +67,127 @@ and re-check thresholds. See [Variants and quantization](../VARIANTS.md).
 - It chooses among supplied options; it cannot generate explanations.
 - This is an independent Open-Jev DeBERTa v3 large reproduction, not an official TypeSafe model.
 
+## Loading each variant
+
+REST selects the quantization through the standard `model` field using the
+alias `open-jev-deberta-v3-large@variant`; there is no `variant` field in the request body.
+
+### `q4f16` (q4/fp16, edge)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("open-jev-deberta-v3-large", variant="q4f16")
+```
+
+**CLI**
+
+```bash
+dtk models download open-jev-deberta-v3-large --variant q4f16
+dtk models use open-jev-deberta-v3-large --variant q4f16
+dtk decide --model open-jev-deberta-v3-large --variant q4f16 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "open-jev-deberta-v3-large@q4f16", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
+### `fp16` (fp16, default)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("open-jev-deberta-v3-large", variant="fp16")
+```
+
+**CLI**
+
+```bash
+dtk models download open-jev-deberta-v3-large --variant fp16
+dtk models use open-jev-deberta-v3-large --variant fp16
+dtk decide --model open-jev-deberta-v3-large --variant fp16 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "open-jev-deberta-v3-large@fp16", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
+### `q4` (q4, edge)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("open-jev-deberta-v3-large", variant="q4")
+```
+
+**CLI**
+
+```bash
+dtk models download open-jev-deberta-v3-large --variant q4
+dtk models use open-jev-deberta-v3-large --variant q4
+dtk decide --model open-jev-deberta-v3-large --variant q4 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "open-jev-deberta-v3-large@q4", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
+### `fp32` (fp32, quality)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("open-jev-deberta-v3-large", variant="fp32")
+```
+
+**CLI**
+
+```bash
+dtk models download open-jev-deberta-v3-large --variant fp32
+dtk models use open-jev-deberta-v3-large --variant fp32
+dtk decide --model open-jev-deberta-v3-large --variant fp32 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "open-jev-deberta-v3-large@fp32", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
 ## Usage
 
 ```bash

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/docs/models/opendecider-nano.md

@@ -57,6 +57,69 @@ the quality build. Select one with
 - No independent parity dataset (the official benchmark inputs are hashed).
 - The export's tokenizer is a web tokenizer (`tokenizer.web.json`), loaded through the `tokenizers` fallback.
 
+## Loading each variant
+
+REST selects the quantization through the standard `model` field using the
+alias `opendecider-nano@variant`; there is no `variant` field in the request body.
+
+### `q8f16` (int8/fp16, default)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("opendecider-nano", variant="q8f16")
+```
+
+**CLI**
+
+```bash
+dtk models download opendecider-nano --variant q8f16
+dtk models use opendecider-nano --variant q8f16
+dtk decide --model opendecider-nano --variant q8f16 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "opendecider-nano@q8f16", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
+### `fp16` (fp16, quality)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("opendecider-nano", variant="fp16")
+```
+
+**CLI**
+
+```bash
+dtk models download opendecider-nano --variant fp16
+dtk models use opendecider-nano --variant fp16
+dtk decide --model opendecider-nano --variant fp16 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "opendecider-nano@fp16", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
 ## Usage
 
 ```bash

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/docs/models/strands-decider-2b.md

@@ -73,6 +73,69 @@ for 3 days!`):
   probabilities need to be closest to the reference.
 - No image/audio support in this text-only projection.
 
+## Loading each variant
+
+REST selects the quantization through the standard `model` field using the
+alias `strands-decider-2b@variant`; there is no `variant` field in the request body.
+
+### `q4f16` (q4/fp16, default)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("strands-decider-2b", variant="q4f16")
+```
+
+**CLI**
+
+```bash
+dtk models download strands-decider-2b --variant q4f16
+dtk models use strands-decider-2b --variant q4f16
+dtk decide --model strands-decider-2b --variant q4f16 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "strands-decider-2b@q4f16", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
+### `q8` (int8, quality)
+
+**Library**
+
+```python
+from decision_toolkit import DecisionModel
+
+model = DecisionModel("strands-decider-2b", variant="q8")
+```
+
+**CLI**
+
+```bash
+dtk models download strands-decider-2b --variant q8
+dtk models use strands-decider-2b --variant q8
+dtk decide --model strands-decider-2b --variant q8 \
+  --state "..." --q 'urgent=noul:Is this urgent?'
+```
+
+**REST**
+
+```bash
+curl -s http://127.0.0.1:8000/v1/systemone \
+  -H "Content-Type: application/json" \
+  -d '{"model": "strands-decider-2b@q8", "state": "...",
+       "questions": {"urgent": {"type": "noul",
+                     "instructions": "Is this urgent?"}}}}'
+```
+
 ## Usage
 
 ```bash

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "decision-toolkit"
-version = "0.4.0"
+version = "0.4.1"
 description = "Local-first toolkit for open-weights decision models: one ONNX engine, one adapter per model contract, typed choice/yes-no/score decisions with probabilities on CPU."
 readme = "README.md"
 requires-python = ">=3.12"

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/src/decision_toolkit/__init__.py

@@ -7,7 +7,7 @@ questions with a calibrated probability for every option, on CPU.
 
 from __future__ import annotations
 
-__version__ = "0.4.0"
+__version__ = "0.4.1"
 
 from .adapters import register_adapter
 from .calibration import brier_score, expected_calibration_error, threshold_sweep

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/src/decision_toolkit/catalog.py

@@ -158,6 +158,7 @@ class ModelInfo:
             "variants": [
                 {
                     "name": variant.name,
+                    "alias": f"{self.id}@{variant.name}",
                     "quant": variant.quant,
                     "size_mb": variant.size_mb,
                     "role": variant.role,

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/src/decision_toolkit/cli.py

@@ -592,6 +592,7 @@ def _catalog_payload(
 def _variant_payload(variant: catalog.Variant, cached: set[tuple[str, str]], model_id: str) -> dict[str, Any]:
     return {
         "name": variant.name,
+        "alias": f"{model_id}@{variant.name}",
         "quant": variant.quant,
         "size_mb": variant.size_mb,
         "role": variant.role,
@@ -709,7 +710,7 @@ def _cmd_models(args: argparse.Namespace) -> int:
         if as_json:
             _json_out(payloads)
             return EXIT_OK
-        headers = ["", "id", "variant", "quant", "role", "size", "cached"]
+        headers = ["", "id", "variant", "alias", "quant", "role", "size", "cached"]
         if args.show_adapter:
             headers.insert(2, "adapter")
         if args.show_license:
@@ -732,6 +733,7 @@ def _cmd_models(args: argparse.Namespace) -> int:
                     "★" if is_current else "",
                     model.id,
                     label,
+                    f"{model.id}@{variant.name}",
                     variant.quant,
                     variant.role,
                     f"{variant.size_mb:.1f} MB",
@@ -781,6 +783,7 @@ def _cmd_models(args: argparse.Namespace) -> int:
             if variant.parity:
                 summary = ", ".join(f"{key}={value}" for key, value in variant.parity.items())
                 print(f"           parity: {summary}")
+            print(f"           alias:    {model.id}@{variant.name}")
             print(
                 f"           download: dtk models download {model.id} "
                 f"--variant {variant.name}"

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/tests/test_cli.py

@@ -220,6 +220,7 @@ def test_models_list_json_and_columns(home, capsys):
     assert entry["license"] == "apache-2.0"
     assert entry["default_variant"] == "fp16"
     assert entry["current_variant"] is None
+    assert entry["variants"][0]["alias"] == "gliner2.5-multi@fp16"
     assert entry["variants"][0]["quant"] == "fp16"
 
     assert cli.main(
@@ -242,6 +243,7 @@ def test_models_variants_text_and_json(home, capsys):
     assert "577.1" in text and "1131.9" in text
     assert "latency p50" in text
     assert "parity:" in text and "baseline=" in text
+    assert "alias:    gliner2.5-multi@fp32" in text
     assert "download: dtk models download gliner2.5-multi --variant fp32" in text
     assert "selected variant: dtk models use gliner2.5-multi" in text
 
@@ -251,6 +253,7 @@ def test_models_variants_text_and_json(home, capsys):
     payload = json.loads(_out(capsys))
     assert payload["adapter"] == "gliner2"
     assert payload["default_variant"] == "fp16"
+    assert payload["variants"][0]["alias"] == "gliner2.5-multi@fp16"
     assert {variant["name"] for variant in payload["variants"]} == {"fp16", "fp32"}
     assert payload["variants"][0]["revision"]
     assert payload["variants"][0]["sha256"]

{decision_toolkit-0.4.0 → decision_toolkit-0.4.1}/uv.lock

@@ -349,7 +349,7 @@ wheels = [
 
 [[package]]
 name = "decision-toolkit"
-version = "0.4.0"
+version = "0.4.1"
 source = { editable = "." }
 dependencies = [
     { name = "huggingface-hub" },