jev-style 0.2.0__tar.gz

jev_style-0.2.0/.gitignore

@@ -0,0 +1,7 @@
+.venv/
+__pycache__/
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.DS_Store

jev_style-0.2.0/CHANGELOG.md

@@ -0,0 +1,27 @@
+# Changelog
+
+Versions follow [semantic versioning](https://semver.org/). Each release pins the model revisions it loads
+(`jev_style/models.py`), so upgrading the package is what changes the weights you get.
+
+## 0.2.0 (unreleased)
+
+- **On PyPI.** `pip install "jev-style[mlx]"` on Apple silicon, `pip install "jev-style[torch]"` elsewhere; the
+  README and the skills no longer install from a git URL.
+- **`JevStyle.from_pretrained(repo_id)`**: load a release by its Hub repo id; the repo picks the backend (main repo =
+  PyTorch, `-MLX`, `-GGUF`). The three v3 repos load at their pinned revisions. Any other repo runs the runtime file it
+  ships, so it is refused unless you pass `trust_remote_code=True`.
+- **Module-level shortcuts**: `jev_style.decide(...)`, `jev_style.classify(text, labels)` and `jev_style.configure(...)`
+  share one lazily created client (`$JEV_STYLE_URL`, else the local model).
+- **`jev-style eval --server ...` compares engines**: the local model, other builds, or any server that implements
+  `POST /v1/systemone`, on the same questions, with 95 % paired bootstrap intervals for the accuracy and Brier
+  differences. `--key NAME=ENV_VAR` and `--model NAME=MODEL` per engine.
+- MLX: the state is read once for many questions (bit-identical answers, up to 8x faster).
+- Packaging: version read from `jev_style/__init__.py`; the source distribution now holds only the package, tests
+  and examples (about 210 KB instead of 6.6 MB); README links are absolute so they work on PyPI.
+
+No change to answers: the pinned model revisions are the same as in 0.1.0.
+
+## 0.1.0 (2026-09-26)
+
+First release: `jev-style serve` (systemone-compatible API, Playground and demos; MLX, PyTorch and GGUF backends),
+the Python client, six agent skills, the Claude Code guard, the MCP server and `jev-style eval`.

jev_style-0.2.0/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Alibaba Cloud
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

jev_style-0.2.0/NOTICE

@@ -0,0 +1,16 @@
+jev-style
+Copyright 2026 chaoliangUNSW (GitHub: lawrence3699). Licensed under the Apache License, Version 2.0 (see LICENSE).
+
+The model weights are downloaded at run time from the Hugging Face Hub
+(chaoliangUNSW/Jev-Style-0.8B-Decision-v3 and its -MLX / -GGUF builds). They are a fine-tuned
+derivative of Qwen3.5-0.8B (Copyright 2026 Alibaba Cloud, Apache-2.0); see the NOTICE file of each
+model repository for the modifications.
+
+The question types (choice / score / noul) and the request shape follow the public typed-decision
+("systemone") convention so the same client code works against different servers.
+
+Not affiliated with, endorsed by or connected to TypeSafe or Jev. "Jev-Style" only describes the kind
+of model (a small typed-decision model in a similar style); no Jev weights, code or outputs are included.
+Not affiliated with or endorsed by Alibaba Cloud / the Qwen team, the Laya authors or the Kev authors.
+
+Web demos: see the LICENSES.md file inside each folder under jev_style/web/ for third-party data.

jev_style-0.2.0/PKG-INFO

@@ -0,0 +1,327 @@
+Metadata-Version: 2.5
+Name: jev-style
+Version: 0.2.0
+Summary: Small, calibrated decision models you run on your own machine, with a systemone-compatible API, a Claude Code guard, an MCP server and agent skills.
+Project-URL: Homepage, https://jevstyle.com
+Project-URL: Repository, https://github.com/lawrence3699/jev-style
+Project-URL: Changelog, https://github.com/lawrence3699/jev-style/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/lawrence3699/jev-style/issues
+Project-URL: Models, https://huggingface.co/collections/chaoliangUNSW/jev-style-08b-decision-v3-6ab58abb90ae4b7b55578b3e
+Author: chaoliangUNSW
+License-Expression: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: agent-skills,calibration,classification,claude-code,decision-model,gguf,jev,mcp,mlx
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: fastapi>=0.110
+Requires-Dist: httpx>=0.27
+Requires-Dist: huggingface-hub>=0.34
+Requires-Dist: numpy>=1.26
+Requires-Dist: tokenizers>=0.21
+Requires-Dist: uvicorn>=0.29
+Provides-Extra: all
+Requires-Dist: mcp>=2.0; extra == 'all'
+Requires-Dist: mlx-lm>=0.28; (sys_platform == 'darwin') and extra == 'all'
+Requires-Dist: mlx>=0.29; (sys_platform == 'darwin') and extra == 'all'
+Requires-Dist: torch>=2.4; extra == 'all'
+Requires-Dist: transformers>=5.0; extra == 'all'
+Provides-Extra: dev
+Requires-Dist: mcp>=2.0; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp>=2.0; extra == 'mcp'
+Provides-Extra: mlx
+Requires-Dist: mlx-lm>=0.28; (sys_platform == 'darwin') and extra == 'mlx'
+Requires-Dist: mlx>=0.29; (sys_platform == 'darwin') and extra == 'mlx'
+Provides-Extra: torch
+Requires-Dist: torch>=2.4; extra == 'torch'
+Requires-Dist: transformers>=5.0; extra == 'torch'
+Description-Content-Type: text/markdown
+
+# Jev-Style
+
+Small, calibrated decision models you run on your own machine, plus the tooling to put them to work in AI agents.
+
+<p>
+  <a href="https://pypi.org/project/jev-style/"><img alt="PyPI" src="https://img.shields.io/pypi/v/jev-style?style=for-the-badge&labelColor=000000&color=0a0a0a" height="28"></a>
+  <a href="https://github.com/lawrence3699/jev-style/actions/workflows/ci.yml"><img alt="CI" src="https://img.shields.io/github/actions/workflow/status/lawrence3699/jev-style/ci.yml?style=for-the-badge&labelColor=000000" height="28"></a>
+  <a href="https://huggingface.co/collections/chaoliangUNSW/jev-style-08b-decision-v3-6ab58abb90ae4b7b55578b3e"><img alt="Weights: 0.8B · torch · MLX · GGUF" src="https://img.shields.io/badge/WEIGHTS-0.8B%20%C2%B7%20torch%20%C2%B7%20MLX%20%C2%B7%20GGUF-0a0a0a.svg?style=for-the-badge&labelColor=000000" height="28"></a>
+  <a href="https://huggingface.co/spaces/chaoliangUNSW/jev-style-v3"><img alt="Demo on Hugging Face Spaces" src="https://img.shields.io/badge/DEMO-HF%20Spaces-0a0a0a.svg?style=for-the-badge&labelColor=000000" height="28"></a>
+  <a href="#agent-skills"><img alt="Agent skills: 6" src="https://img.shields.io/badge/AGENT%20SKILLS-6-0a0a0a.svg?style=for-the-badge&labelColor=000000" height="28"></a>
+  <a href="LICENSE"><img alt="License: Apache-2.0" src="https://img.shields.io/badge/license-Apache--2.0-0a0a0a.svg?style=for-the-badge&labelColor=000000" height="28"></a>
+</p>
+
+![The Playground answering a support-ticket request, then the agent-approval demo allowing, asking about and denying tool calls](https://raw.githubusercontent.com/lawrence3699/jev-style/main/docs/demo.gif)
+
+Jev-Style is a family of small decision models built on Qwen3.5. The current model, [Jev-Style-0.8B-Decision-v3](https://huggingface.co/chaoliangUNSW/Jev-Style-0.8B-Decision-v3), is 0.53 GB at 4-bit. You give it text or JSON and some typed questions, and it returns a calibrated probability for every option in one forward pass. The server's API follows the public systemone request shape, so clients written for Jev-compatible servers can call your laptop instead.
+
+This repository is the part that makes the model useful day to day:
+
+- **`jev-style serve`**: a local API with a Playground and demos. It picks MLX on Apple silicon and PyTorch on CUDA or CPU; llama.cpp is optional.
+- **Six agent skills**: install with one `npx skills add`. They serve the model, call it, evaluate it on your own labels, replace LLM calls that only return a label, add a guard to Claude Code, and add the MCP tools.
+- **A Claude Code guard**: a `PreToolUse` hook where the local model checks every tool call before it runs and answers allow, ask or deny.
+- **An MCP server**: tools `decide`, `noul`, `choice` and `score` for Claude Code, Cursor, Codex and any other MCP client.
+- **`jev-style eval`**: measures accuracy and calibration on your own labelled data, and reports how many decisions you can automate at a 1, 5 or 10 % error budget.
+
+No GPU, no API key and no training needed.
+
+## Highlights
+
+- **Three question types in one request.** Yes/no (`noul`), multiple choice (`choice`, up to 255 options) and ordered ratings (`score`, 2 to 10 levels). The model reads the text once and answers every question about it.
+- **Probabilities, not just labels.** Each release ships temperatures fitted on held-out data, so your code can act on confident answers and send the rest to a person or an LLM.
+- **Long inputs.** Up to 25,600 tokens per call. Nothing is truncated: an input that is too long is rejected with an error that says so.
+- **Runs locally.** About 0.15 to 0.2 s for a short request with MLX on an M1 Max, after the first call. Nothing leaves your machine.
+- **51 languages evaluated.** Training covers 19 languages. On MASSIVE intent the model beats Laya's multilingual checkpoint in all 51 evaluated languages.
+- **Built for agents.** The skills, the MCP tools and the guard all work with Claude Code, Codex, Cursor and other agents.
+
+## Model
+
+| Model | Size | Banking77 (77 intents, never trained) | MASSIVE intent, 37 held-out languages | tweet_topic, zero-shot | JevBench v1.4.1 public (231) | Context |
+|---|---|:---:|:---:|:---:|:---:|:---:|
+| [Jev-Style-0.8B-Decision-v3](https://huggingface.co/chaoliangUNSW/Jev-Style-0.8B-Decision-v3) | 0.8B · 0.53 GB (Q4_K_M) | **68.2 %** | **65.5 %** | **75.5 %** | **64.1 %** | 25,600 tokens |
+| Best official Laya checkpoint | 0.8B | 49.2 % | 36.1 % | 63.2 % | 58.4 % | 1,024 by default |
+
+All numbers are from the [model card](https://huggingface.co/chaoliangUNSW/Jev-Style-0.8B-Decision-v3#results), which gives the full protocol and confidence intervals. The Laya rows are its official checkpoints re-run on the same rows, except tweet_topic and JevBench, which use published numbers. The hosted Jev API has higher accuracy than v3 on every one of these sets where its accuracy is published. Treat v3 as the small local option, not a replacement for the hosted model.
+
+| Build | Size | Used by |
+|---|---:|---|
+| [safetensors (bf16)](https://huggingface.co/chaoliangUNSW/Jev-Style-0.8B-Decision-v3) | 1.50 GB | `--backend torch` (CUDA, Apple MPS, CPU) |
+| [MLX bf16 / 8-bit](https://huggingface.co/chaoliangUNSW/Jev-Style-0.8B-Decision-v3-MLX) | 1.50 / 0.80 GB | `--backend mlx` (Apple silicon; `auto` picks it there) |
+| [GGUF F16 / Q8_0 / Q4_K_M](https://huggingface.co/chaoliangUNSW/Jev-Style-0.8B-Decision-v3-GGUF) | 1.52 / 0.81 / 0.53 GB | `--backend gguf` (llama.cpp through the bundled `jev-score` scorer) |
+
+Each build carries its own runtime file next to the weights. The server downloads a pinned revision and uses that file, so the answers here match what the model card documents. Earlier 2B generations, for use in LM Studio or Ollama without this server: [v1 GGUF](https://huggingface.co/chaoliangUNSW/Jev-Style-Qwen3.5-2B-Decision-GGUF) (LM Studio, llama.cpp) and [v2 GGUF](https://huggingface.co/chaoliangUNSW/Jev-Style-Qwen3.5-2B-Decision-v2-GGUF) (Ollama).
+
+## Quick Start
+
+### Try it in the browser
+
+The [Hugging Face Space](https://huggingface.co/spaces/chaoliangUNSW/jev-style-v3) runs v3. There is nothing to install.
+
+### Run it locally
+
+You'll need Python 3.10 or newer.
+
+```bash
+pip install "jev-style[mlx]"      # Apple silicon (MLX)
+pip install "jev-style[torch]"    # Linux, Windows or an Intel Mac (PyTorch on CUDA or CPU)
+
+jev-style serve          # downloads the model once (~1.5 GB), then serves http://127.0.0.1:8765
+```
+
+To install the command line tool on its own, with the MCP server, use [uv](https://docs.astral.sh/uv/): `uv tool install "jev-style[all]"` on Apple silicon, `uv tool install "jev-style[torch,mcp]"` elsewhere.
+
+Open http://127.0.0.1:8765 for the Playground and the demos: agent action approval, Snake, and Chinese and 51 languages. In another terminal, send a ticket:
+
+```bash
+curl -s localhost:8765/v1/systemone -H 'content-type: application/json' -d '{
+  "state": "Shoes arrived two weeks late and in the wrong size. Also I see two charges on my card.",
+  "questions": {
+    "department":  {"type": "choice", "instructions": "Which team should handle this?",
+                    "criteria": {"returns":  "Exchanges, refunds, wrong or damaged items",
+                                 "shipping": "Delivery status, delays, lost packages",
+                                 "billing":  "Charges, invoices, payment problems"}},
+    "escalate":    {"type": "noul",  "instructions": "Does this need urgent human attention?"},
+    "frustration": {"type": "score", "instructions": "How frustrated is the customer?",
+                    "criteria": ["Calm", "Frustrated", "Very angry"]}
+  }}'
+```
+
+This is the actual response from v3 with MLX on an Apple M1 Max, with probabilities rounded:
+
+```json
+{
+  "model": "jev-style-0.8b-decision-v3",
+  "answers": {
+    "department":  { "type": "choice", "choice": "billing", "confidence": 0.46,
+                     "probabilities": { "returns": 0.07, "shipping": 0.29, "billing": 0.64 } },
+    "escalate":    { "type": "noul", "noul": 0.45 },
+    "frustration": { "type": "score", "score": 1.28, "confidence": 0.36,
+                     "legend": { "0": "Calm", "1": "Frustrated", "2": "Very angry" },
+                     "probabilities": { "0": 0.07, "1": 0.57, "2": 0.35 } }
+  },
+  "usage": { "input_tokens": 250, "state_tokens": 25, "output_tokens": 0 },
+  "latency_ms": 194.0,
+  "backend": "mlx"
+}
+```
+
+The ticket raises both a billing problem and a late delivery, and the probabilities show it: billing 0.64, shipping 0.29. That is why the model returns probabilities rather than a single label. Your code can act on the confident answers and hand the rest to a person.
+
+### Use it from Python
+
+For a script, one line is enough. The first call loads the model in-process, or uses the server in `JEV_STYLE_URL` if you set it:
+
+```python
+import jev_style
+
+jev_style.classify("Where is my parcel? It was due Monday.", ["billing", "shipping", "tech"])
+# {'label': 'shipping', 'confidence': ..., 'probabilities': {'billing': ..., 'shipping': ..., 'tech': ...}}
+```
+
+For several questions about one text, and to choose the engine yourself:
+
+```python
+from jev_style import JevStyle, choice, noul, score
+
+js = JevStyle.from_pretrained("chaoliangUNSW/Jev-Style-0.8B-Decision-v3-MLX")   # in-process; the repo picks the backend
+# js = JevStyle(base_url="http://127.0.0.1:8765")                                # or a running server
+out = js.decide("I was charged twice. Please fix this ASAP.", {
+    "billing": noul("This ticket is about billing."),
+    "tone":    choice("What is the customer's tone?", ["calm", "frustrated", "angry"]),
+    "urgency": score("How urgent is this ticket?", ["can wait", "this week", "today"]),
+})
+print(out["answers"]["billing"]["noul"], out["answers"]["tone"]["choice"])
+```
+
+`from_pretrained` takes the main repo (PyTorch), `-MLX` (`precision="8bit"` for the 0.8 GB weights) or `-GGUF` (`quant="Q4_K_M"`, needs the `jev-score` scorer, see [Backends](#backends)). The client is not tied to this model: `JevStyle(base_url=...)` works with any server that implements `POST /v1/systemone`, and a client written for another systemone-compatible server can call `http://127.0.0.1:8765` with any API key string.
+
+### From the shell
+
+```bash
+jev-style decide "Refund still missing after 3 weeks" --url http://127.0.0.1:8765 \
+  --choice "Which team?::billing,shipping,returns" --noul "The customer is angry"
+# without --url (or JEV_STYLE_URL) it loads its own copy of the model
+```
+
+## Agent Skills
+
+The skills live in [`skills/`](https://github.com/lawrence3699/jev-style/tree/main/skills). Each one tells a coding agent how to do one job from start to finish, and ends with a check that the job worked.
+
+```bash
+npx skills add lawrence3699/jev-style                    # pick skills interactively
+npx skills add lawrence3699/jev-style --skill '*' -y     # all six
+```
+
+| Skill | What your agent does with it |
+|---|---|
+| [`jev-style-serve`](https://github.com/lawrence3699/jev-style/blob/main/skills/jev-style-serve/SKILL.md) | Installs the CLI, picks the backend for your machine, starts the server, checks it with a real request, and can optionally start it at login. |
+| [`jev-style`](https://github.com/lawrence3699/jev-style/blob/main/skills/jev-style/SKILL.md) | Writes code that calls the model: request format, reading the probabilities, turning them into actions with thresholds, limits. |
+| [`jev-style-eval`](https://github.com/lawrence3699/jev-style/blob/main/skills/jev-style-eval/SKILL.md) | Builds a labelled JSONL from your data and runs `jev-style eval`. It reports accuracy, Brier, ECE, how much you can automate at a 1, 5 or 10 % error budget, and a refitted temperature. |
+| [`jev-style-adopt`](https://github.com/lawrence3699/jev-style/blob/main/skills/jev-style-adopt/SKILL.md) | Scans your code for LLM calls that only return a label, yes/no or a rating, and rewrites them as typed questions. The LLM stays as the fallback below a confidence threshold. It runs in shadow mode, measures agreement, then switches. |
+| [`jev-style-guard`](https://github.com/lawrence3699/jev-style/blob/main/skills/jev-style-guard/SKILL.md) | Installs the Claude Code guard hook. It recommends a dry run first, then shows how to tune thresholds and measure them on labelled calls. |
+| [`jev-style-mcp`](https://github.com/lawrence3699/jev-style/blob/main/skills/jev-style-mcp/SKILL.md) | Registers the MCP tools with Claude Code, Codex, Cursor, Claude Desktop or Windsurf, and checks that a tool call works. |
+
+In Claude Code you can also install everything as plugins:
+
+```text
+/plugin marketplace add lawrence3699/jev-style
+/plugin install jev-style@jev-style          # the six skills + MCP tools
+/plugin install jev-style-guard@jev-style    # the PreToolUse guard
+```
+
+## Claude Code Guard
+
+Before Claude Code runs a `Bash`, `Write`, `Edit`, `Read`, `WebFetch` or MCP call, `jev-style guard` sends the call to the local model. It asks whether the call is destructive, exfiltrates data, touches secrets or goes outside the project, plus a 0 to 4 risk score. It turns the answers into **allow / ask / deny**. Regex hard rules in code can only make a verdict stricter. If the server is down, times out or rejects the request, the verdict is **ask**, never a silent allow.
+
+```bash
+jev-style guard --check "git push --force origin main"
+# decision: DENY   (source: rule, 443 ms)  destructive 0.79 ...
+jev-style guard-replay --url http://127.0.0.1:8765     # the 49 bundled labelled tool calls
+```
+
+On the 49 bundled tool calls, which were written and labelled by hand, the default config agrees with the labels on **77.6 %**. **No call labelled deny was allowed.** 2 of the 16 calls labelled ask were allowed. The model alone, with no hard rules, agrees on 61.2 %. Use it as a second line of defence, not as a sandbox. The [skill](https://github.com/lawrence3699/jev-style/blob/main/skills/jev-style-guard/SKILL.md) covers installing, dry runs and tuning.
+
+## MCP Server
+
+```bash
+claude mcp add jev-style --scope user -- jev-style mcp       # Claude Code
+```
+
+`jev-style mcp` is a thin stdio server that forwards to the running `jev-style serve`, so one copy of the model serves every client. It provides `decide` (several questions about one input), `noul`, `choice`, `score` and `model_info`. Setup for Codex, Cursor and Claude Desktop is in [the skill](https://github.com/lawrence3699/jev-style/blob/main/skills/jev-style-mcp/SKILL.md).
+
+## Evaluate on Your Own Data
+
+The best evidence is your own labelled examples. `jev-style eval` takes JSONL in the request format, with a `label` on each question:
+
+```bash
+jev-style eval examples/support_tickets.jsonl --url http://127.0.0.1:8765
+```
+
+```
+question                   n     acc   brier    ece   automate @1% / 5% / 10% error
+team                      30   93.3%   0.077  0.123    90.0% (p>=0.65) /  93.3% (p>=0.57) / 100.0% (p>=0.44)
+escalate                  30   96.7%   0.107  0.125    80.0% (p>=0.71) / 100.0% (p>=0.54) / 100.0% (p>=0.54)
+mood                      30   73.3%   0.433  0.174    40.0% (p>=0.56) /  40.0% (p>=0.56) /  46.7% (p>=0.54)
+```
+
+The 30 example tickets were written by hand for this repository. They demonstrate the format; they are not a benchmark. Read `automate @5%: 93.3% (p>=0.57)` like this: if you act only when the top probability is at least 0.57, the model handles 93.3 % of tickets with at most 5 % errors among them, and everything else goes to a person or an LLM. The report also refits a temperature on half the rows and shows its effect on the other half. See the [skill](https://github.com/lawrence3699/jev-style/blob/main/skills/jev-style-eval/SKILL.md) for building a proper evaluation set.
+
+### Compare engines
+
+Repeat `--server` to run the same file through several engines: this package's local model, another build or quantisation, or any other server that implements `POST /v1/systemone`. The first one is the reference.
+
+```bash
+jev-style eval examples/support_tickets.jsonl --server bf16=local:mlx --server q8=http://127.0.0.1:8799
+```
+
+```
+90 questions answered by every engine; the table and the differences use only those.
+
+engine             answered failed rows     acc   brier log loss    ece   automate @5% error
+bf16                     90           0   87.8%   0.206    0.369  0.125    80.0% (p>=0.54)
+q8                       90           0   87.8%   0.206    0.370  0.117    78.9% (p>=0.54)
+
+difference to bf16 (95 % paired bootstrap over rows; brier: lower is better):
+  q8               accuracy  +0.0 pts [+0.0, +0.0]   brier +0.001 [-0.001, +0.002]
+```
+
+That run compares the MLX bf16 weights in-process with `jev-style serve --precision 8bit` on an Apple M1 Max. Engine specs are `NAME=URL`, `NAME=local[:backend]`, `NAME=hf:<repo id>` or `NAME=fake`; `--key NAME=ENV_VAR` sends a bearer token from an environment variable and `--model NAME=MODEL` sets the request's `model` field. Every engine is scored on the same questions: if one engine rejects a row (too long, too many options), that row is dropped for all of them and counted under `failed rows`. `--json PATH` writes every answer.
+
+## API
+
+`POST /v1/systemone` with `{"state": text | object | array, "questions": {id: question}}`:
+
+| `type` | `criteria` | Answer |
+|---|---|---|
+| `noul` | optional `{"true": "...", "false": "..."}` | `noul` = P(true) |
+| `choice` | `{option: description or null}`, 1 to 255 options | `choice`, `probabilities`, `confidence` |
+| `score` | 2 to 10 levels, lowest first: `"label"` or `{"label", "description"}` | `score` = expected level index, `legend`, `probabilities`, `confidence` |
+
+`confidence = (k · p_max − 1) / (k − 1)` for k options: 0 when the probabilities are uniform, 1 when one option takes all of them. The other routes are `GET /v1/models`, `GET /healthz` and the Playground at `/`. Errors look like `{"error": {"code", "message", "question"?}}` and use HTTP 422 (`invalid_json`, `invalid_request`, `invalid_question`, `input_budget_exceeded`), 401 (`unauthorized`), 404 or 500. Start the server with `--api-key-env NAME` to require `Authorization: Bearer <key>`. The full reference is [skills/jev-style/reference.md](https://github.com/lawrence3699/jev-style/blob/main/skills/jev-style/reference.md).
+
+## Backends
+
+| Machine | Command |
+|---|---|
+| Apple silicon | `jev-style serve` (MLX bf16; add `--precision 8bit` for 0.8 GB) |
+| NVIDIA GPU | `jev-style serve --backend torch` |
+| CPU only | `jev-style serve --backend torch --device cpu` |
+| llama.cpp | build `jev-score` once (`sh build_jev_score.sh /path/to/llama.cpp` from the GGUF repo), then `jev-style serve --backend gguf --scorer /absolute/path/printed/by/the/script --quant Q4_K_M` |
+| Offline | `jev-style serve --model-dir /path/to/a/downloaded/model/repo` |
+| No model (UI or plumbing work) | `jev-style serve --fake` (deterministic, meaningless answers) |
+
+## Repository Layout
+
+```
+jev_style/           server, client, CLI, guard, MCP server, eval; web/ = Playground + demos
+skills/              six agent skills (npx skills add lawrence3699/jev-style)
+plugins/             Claude Code guard plugin (the root .claude-plugin/ is the marketplace)
+examples/            labelled example data for jev-style eval
+space/               source of the Hugging Face Space
+tests/               pytest suite, runs on the fake engine (no model download)
+```
+
+## Development
+
+```bash
+git clone https://github.com/lawrence3699/jev-style && cd jev-style
+uv venv && uv pip install -e ".[dev]"
+uv run pytest -q                # fake engine: no weights, no GPU
+uv run jev-style serve --fake   # UI work without the model
+```
+
+## Acknowledgements and License
+
+Code: Apache-2.0 ([LICENSE](https://github.com/lawrence3699/jev-style/blob/main/LICENSE)). The weights are Apache-2.0 fine-tunes of [Qwen3.5-0.8B](https://huggingface.co/Qwen/Qwen3.5-0.8B); the NOTICE in each model repository lists the changes. The typed-question convention follows [Laya](https://github.com/NandhaKishorM/laya).
+
+Not affiliated with, endorsed by or connected to TypeSafe or Jev. "Jev-Style" describes the kind of model: a small typed-decision model in a similar style. No Jev weights, code or outputs are included. Not affiliated with Alibaba Cloud or the Qwen team or the Laya authors.