community
/
mltrail-verifiable-provenance-ledger-for
34
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
mltrail-verifiable-provenan.../README.md

1.6 KiB
Raw Blame History

MLTrail Verifiable Provenance Ledger (MVP)

This repository contains a minimal, production‑oriented MVP for a verifiable provenance ledger tailored to federated machine learning experiments. It offers a compact, append-only hash-chain ledger with a contract-driven schema registry and a delta-sync protocol to keep distributed networks eventually consistent.

Key components (MVP):

  • Data contracts and schemas for Experiment, Run, Dataset, Model, Environment, EvaluationMetric, Policy.
  • Append-only ledger with hash-chain, genesis block, and delta-sync capability.
  • Lightweight contract registry (GoC bridge) concepts to enable canonical primitives and replay protection.
  • Adapters (MLFlow-like, WandB-like) that publish to the ledger.
  • Reproducibility groundwork via environment hashing and deterministic record layout.
  • Governance and security scaffolding via signatures (plausible placeholder for MVP).

How to use (quick start):

  • Run tests and build: ./test.sh
  • Publish a registry entry: use the ledger to add a ContractRegistryEntry payload.
  • Explore delta-sync: create two ledgers, publish on one, and retrieve deltas on the other with delta_sync.

Note: This is an MVP and intentionally lightweight. It focuses on correct data flow and verifiable append-only logs while keeping the surface area small for rapid iteration and extension (adapters, delta-sync, and governance).

For contributors: see mltrail_verifiable_provenance_ledger_for/goC_bridge.py for structure of the canonical bridge and mltrail_verifiable_provenance_ledger_for/ledger.py for the delta-sync primitives.

Version: 0.1.0

"README.md" hooks into packaging via pyproject.toml readme field.