Skip to content

RunTrace v0.1.0

Choose a tag to compare

View all tags
@Corvus-226 Corvus-226 released this 13 Aug 08:48
· 20 commits to main since this release
v0.1.0
db03cb9
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

RunTrace v0.1.0 is the first public release of a lightweight, local-first CLI for recording and comparing machine-learning experiment context.

Install

python -m pip install ml-runtrace==0.1.0
ml-runtrace --version
python -m ml_runtrace --version

Python 3.10, 3.11, and 3.12 are supported.

Highlights

  • Capture Git commit, branch, detached state, and dirty state.
  • Capture Python, platform, installed distributions, and optional NVIDIA GPU/CUDA metadata.
  • Store validated, human-readable YAML snapshots under .runtrace/runs/.
  • Record optional experiment names, commands, and repository-local YAML configs.
  • List and inspect runs, then recursively compare configuration, Git, runtime, platform, and dependency changes.
  • Work locally without an account, server, database, or automatic upload.

First workflow

ml-runtrace init
ml-runtrace snapshot --name baseline --config configs/train.yaml --command "python train.py --config configs/train.yaml"
ml-runtrace list
ml-runtrace show <run-id>
ml-runtrace diff <baseline-id> <candidate-id>

See the Getting Started guide for a complete walkthrough.

Privacy and scope

RunTrace does not upload source, experiment data, credentials, environment variables, or artifacts. Values explicitly supplied through --config and --command are stored locally and should be reviewed before sharing. RunTrace records reproducibility context; it does not track metrics, host a dashboard, schedule jobs, or store model artifacts.

Release verification

  • Source tag v0.1.0 points to db03cb9999f8428962caa1e62c3bea5df4682b9d.
  • Final non-publishing candidate run 31682370801 passed with zero annotations.
  • Trusted Publishing run 31682596354 passed through the protected pypi environment and generated digital attestations.
  • A clean, no-cache PyPI install passed pip check, both entry points, and an end-to-end init → snapshot → list → show → diff acceptance test.

SHA-256

  • ml_runtrace-0.1.0-py3-none-any.whl: ebed8b75fec1ecda3e2e341278d54197b95cb86f88049ca52dd76885d14931c2
  • ml_runtrace-0.1.0.tar.gz: 1301e8b3555aa82927872af604c3fe5185c19d51556061311f00de3ce4c271a9

The distributions published on PyPI are the exact artifacts from the successful formal publication workflow. Its retained workflow artifact also contains SHA256SUMS and RELEASE_PROVENANCE.

Assets 2
Loading