Assay Python Bindings
assay-it is the Python package for the assay import namespace.
It currently provides a small, bounded surface on top of Assay core:
AssayClientfor writing JSONL trace records from PythonCoveragefor policy coverage analysis against trace/tool-call inputsExplainerfor rule-by-rule explanation of a single trace- a
pytestfixture plugin exposed asassay_client
Install
pip install assay-it
CPython 3.12, 3.13, and 3.14 on macOS x86_64/arm64 and Linux x86_64; other interpreters and platforms are not claimed.
Import path:
from assay import AssayClient, Coverage, Explainer, validate
What It Is
This package is for Python-side trace capture and lightweight policy-analysis helpers. It is useful when you want to:
- append structured trace events to a JSONL file from Python
- analyze tool-call traces against an Assay policy
- explain why a given trace matched or violated policy rules
- use a simple pytest fixture around the Python client
What It Is Not
This package is not the full Assay CLI or the full trust-compiler surface. It does not replace:
assay mcp wrapand runtime MCP enforcement- evidence bundle generation and verification workflows
- Trust Basis / Trust Card generation
- the GitHub Action or release-binary install path
Those outward-facing product surfaces live in the main Assay CLI and repository docs.
Example
from assay import AssayClient, Coverage, Explainer
client = AssayClient("traces.jsonl")
client.record_trace({"tool": "ToolA", "args": {"q": "weather"}})
coverage = Coverage("assay.yaml")
report = coverage.analyze([[{"tool": "ToolA", "args": {"q": "weather"}}]])
explainer = Explainer("assay.yaml")
details = explainer.explain([{"tool": "ToolA", "args": {"q": "weather"}}])
Repository
- Main project: https://github.com/Rul1an/assay
- Current CLI and trust-compiler docs: https://github.com/Rul1an/assay/blob/main/README.md
1 maintainer
Release files for assay-it 6.8.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| assay_it-6.8.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.12 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| assay_it-6.8.0-cp312-abi3-macosx_11_0_arm64.whl | CPython 3.12 | abi3 | macOS 11.0+ ARM64 | Details |
| assay_it-6.8.0-cp312-abi3-macosx_10_12_x86_64.whl | CPython 3.12 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 5.1 MB
Release files / assay_it-6.8.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | assay_it-6.8.0-cp312-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 1.8 MB |
| Tags | CPython 3.12 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
dc9bdf40c365d264d15551cd5dee199f2c1f8ca99fcb9577575a16e48fb1fd14
|
|
BLAKE2b-256 checksum How to use checksums |
4622d9e6a7a4614deb7bfd2e2d650af14e85507d6359823f87d04f3a9aa4119f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.
Transparency logRelease files / assay_it-6.8.0-cp312-abi3-macosx_11_0_arm64.whl
| Download URL | assay_it-6.8.0-cp312-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 1.3 MB |
| Tags | CPython 3.12 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
90a5987118e407f59f8d373bbf92ac9ed1d12ce1a1722abcd76a65d8e2a725b1
|
|
BLAKE2b-256 checksum How to use checksums |
fba1089e9fba5cb1f4dae26f8b630b44542ac60c57d8657e0813e58487a630a5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.
Transparency logRelease files / assay_it-6.8.0-cp312-abi3-macosx_10_12_x86_64.whl
| Download URL | assay_it-6.8.0-cp312-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 2.1 MB |
| Tags | CPython 3.12 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
d16938a1bbc349cda44c0f7a27065cd97a15a2a53445fc6be1457a6d4b3f792a
|
|
BLAKE2b-256 checksum How to use checksums |
9a25a8bc01136ac132e963ac773499f6f0639020343793b60c20a51829f27284
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.
Transparency log
