Metadata-Version: 2.4
Name: mechlab-sdk
Version: 0.1.0a2
Summary: Mechanistic interpretability that ships: MAIR-backed evidence bundles, receipts, and comparison packets
Author: mech-lab team
License-Expression: MIT
Project-URL: Homepage, https://github.com/mech-lab/mech-lab
Project-URL: Documentation, https://github.com/mech-lab/mech-lab/tree/main/docs
Project-URL: Repository, https://github.com/mech-lab/mech-lab
Project-URL: Issues, https://github.com/mech-lab/mech-lab/issues
Project-URL: Changelog, https://github.com/mech-lab/mech-lab/releases
Project-URL: Validation Report, https://github.com/mech-lab/mech-lab/blob/main/docs/qwen35-validation-report.md
Keywords: mechanistic-interpretability,release-assurance,evidence-bundles,holonomy,mair,research,slsa
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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: Programming Language :: Python :: Implementation :: CPython
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: jsonschema>=4.23
Requires-Dist: numpy>=2.0
Requires-Dist: pyarrow>=17.0
Provides-Extra: viz
Provides-Extra: offline-topology
Provides-Extra: dev
Requires-Dist: build; extra == "dev"
Requires-Dist: pyright; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: twine; extra == "dev"
Dynamic: license-file

# mech-lab

Mechanistic interpretability that ships.

`Architecture-agnostic IR · Sheaf holonomy · SLSA L3 provenance`

`mech-lab` produces Evidence Bundles, Receipts, Replay Packs, and Comparison Packets that other engineers can verify offline. The public trust anchor is concrete: the native Qwen3.5 lane runs through `mechlab` and emits MAIR-backed artifacts.

## Install

```bash
pip install --pre mechlab-sdk
```

## Quickstart

```bash
mechlab demo --output-dir artifacts/mechlab-demo
mechlab report artifacts/mechlab-demo/mair_manifest.v1.json --kind release-summary
```

```python
import mech_lab as ml

bundle = ml.demo(output_dir="artifacts/mechlab-demo")
print(bundle.manifest_path)
print(ml.report(bundle))
```

## What You Get

- Evidence Bundle: `mair_manifest.v1.json` plus required MAIR-backed run artifacts
- Receipt: `assurance_receipt.v1.json`
- Replay Pack: analyzed MAIR bundle with hook validation and intervention outputs
- Comparison Packet: `backend_comparison.v1.json`

## Real Model Proof

- native `qwen3_5` runtime proof is complete through the public `mechlab` facade
- the validated rerun used the real `Qwen/Qwen3.5-2B` checkpoint
- the validated host-local rerun used a documented CPU override after `device:auto` failed before artifact emission on the recorded machine

## Public Contract

- package name: `mechlab-sdk`
- CLI: `mechlab`
- Python namespace: `mech_lab`
- disk contract: MAIR-backed artifacts only
