The author developed metrictrust, a lightweight Python tool that monitors training runs to determine if final validation metrics should be trusted. It addresses common issues such as keeping suboptimal checkpoints, overestimating performance due to memorization, and relying on noisy oscillating results.

  • Provides a plain-language verdict of 'trust', 'caution', or 'do-not-trust' based on training dynamics.
  • Detects when the best metric occurred mid-training but was not saved as the final checkpoint.
  • Identifies cases where train accuracy significantly exceeds eval accuracy, indicating memorization.
  • Flags runs with high oscillation to warn against treating a single noisy sample as a reliable measurement.
  • Works with HuggingFace Trainer via TrustCheckCallback or any custom loop via TrustMonitor.

The tool helps users avoid drawing incorrect conclusions from final log numbers by highlighting when the model's peak performance was missed or when the data is too unstable to be meaningful.