metrik-core

The vocabulary every other Metrik package agrees on: the artifact envelope, canonical serialization, and content addressing.

This package defines vocabulary, not behaviour (plan.md §4). It has no ML dependencies — no torch, no transformers — which is enforced in CI by import-linter, not by convention. That constraint is what lets the artifact layer be installed and reasoned about without a multi-gigabyte ML stack.

Install it directly only if you are reading artifacts without running Metrik — pip install metrik-ai gets you this plus the CLI.

What is here

Module Purpose
metrik.core.artifacts The envelope every artifact carries
metrik.core.hashing Canonical JSON, Digest, content_hash, derivation_hash
metrik.core.store The content-addressed artifact and blob store
metrik.core.lineage The lineage DAG, and the walker that recovers an input closure
metrik.core.runs The run registry — including runs that failed
metrik.core.ir ModelGraph, the shared representation producers write
metrik.core.profile ProfileRecord and the capability gate
metrik.core.bench BenchResult and the sandbox attestation it requires
metrik.core.analysis ModelFingerprint, GraphSummary, MemoryEstimate
metrik.core.viz VizSpec — a declarative render, no renderer
metrik.core.plugins Entry-point discovery that never imports plugin code
metrik.core.errors The error taxonomy plugins raise from

The two hashes

The subtlest part of the design, and getting it wrong makes both caching and reproducibility silently unreliable. There are two questions, so there are two hashes:

Question Answered by
Is this the same result as that? content_hash — over the payload only
Have I already computed this, so can I skip the work? derivation_hash — over how it was asked for

A single hash cannot do both. Caching needs a key computable before running, so it must cover inputs and parameters rather than results. Dedup and citation need a key covering only the value, so two runs producing identical numbers are recognised as identical even if asked for differently.

Because both are recorded, the store can check a producer's determinism claim rather than believe it: same derivation_hash, different content_hash, and a declared class of deterministic means the declaration is false.

Specification

The full contract is docs/planning/artifacts.md. This package implements §2 (envelope), §3 (hashing and canonicalization), and §4 (blobs).

Canonicalization rules are normative and tested as properties, not examples — see tests/test_canonical_properties.py.

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Hello-max-cloud-ally1010 from gravatar.com Hello-max-cloud-ally1010

Credits

Author: The Metrik Authors

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.11

Tags

machine-learning provenance quantization reproducibility

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

metrik_core-0.3.1.tar.gz (90.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

metrik_core-0.3.1-py3-none-any.whl (73.1 kB view details)

Uploaded Python 3

File details

Details for the file metrik_core-0.3.1.tar.gz.

File metadata

  • Download URL: metrik_core-0.3.1.tar.gz
  • Upload date:
  • Size: 90.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for metrik_core-0.3.1.tar.gz
Algorithm Hash digest
SHA256 d77bcbf6727349a84e745e48fa2f08a58d99c7aa45b8693826b758572492e4f9
MD5 a41722ab836c1e151daac2a8f68bdc1b
BLAKE2b-256 0dc5ae0f8a56440a18dfa33069497ebd364aa6759452092c312436cd830db5eb

See more details on using hashes here.

Provenance

The following attestation bundles were made for metrik_core-0.3.1.tar.gz:

Publisher: release.yml on Asmodeus14/Metrik

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file metrik_core-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: metrik_core-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 73.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for metrik_core-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4d1d3a2f69dc7df600b169c6ecd515558ecc0311a386f28d93758afc40e3461e
MD5 8716081aca4757ea4925d12a7748566a
BLAKE2b-256 4411ef14da02961d96a16e299a0d1d96789776e4e6f335ba5bafd9dcdf6b9fef

See more details on using hashes here.

Provenance

The following attestation bundles were made for metrik_core-0.3.1-py3-none-any.whl:

Publisher: release.yml on Asmodeus14/Metrik

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page