# MLTrail: Verifiable Provenance Ledger for Federated ML Experiments (MVP)

This repository contains a minimal, working MVP of MLTrail, a light-weight,
open-source ledger platform for recording machine-learning experiments across
organizations. It demonstrates core ideas from the original concept: an append-only
hash-chained ledger, compact contract records (Experiment, Run, Dataset, Model,
Environment, EvaluationMetric, Policy), delta-sync primitives, and lightweight adapters.

What you get in this MVP:
- Core ledger with cryptographic hash chaining (no external dependencies required)
- Data contracts (Experiment, Run, Dataset, Model, Environment, EvaluationMetric, Policy)
- Reproducibility helpers (environment fingerprint) and a small governance hook
- Two starter adapters (MLFlow-like and WandB-like) to publish records
- A minimal contract registry for schemas and conformance tests scaffold
- Basic delta-sync primitive to simulate cross-partition reconciliation
- CLI/test scaffold for local verification

How to run the MVP locally (quickstart):
- Install Python 3.9+ and run tests with pytest
- See test files under tests/ for guidance

This is a foundational MVP intended for stepping stones into a broader ecosystem and governance model. Extend it to implement more sophisticated delta-sync, secure anchoring, and adapter ecosystems as needed.

Hook the package into a Python packaging workflow via pyproject.toml (provided).