RunForge Handbook
Welcome to the RunForge Handbook — your guide to deterministic, contract-driven ML training directly in VS Code.
What is RunForge?
Section titled “What is RunForge?”RunForge is a VS Code extension for push-button machine learning training. It provides deterministic, seeded runs with full provenance — every model can be traced back to the exact code, data, and configuration that produced it. No cloud dependencies, no hidden databases, no magic.
The RunForge guarantee
Section titled “The RunForge guarantee”- Determinism — every run is seeded. Same preset + same seed + same data = same model
- Provenance — every
run.jsonincludes Git commit SHA, Python path, and extension version - Auditability — artifacts are standard formats (JSON, joblib) saved to disk
Handbook sections
Section titled “Handbook sections”- Getting Started — Install, configure, and run your first training session
- Reference — Presets, run lifecycle, artifacts, interpretability, and settings
- Cancel and Recovery — Cancel an active training run, recover an orphaned index, and grant workspace trust
Lifecycle commands
Section titled “Lifecycle commands”RunForge: Cancel Active Training— fire VS Code’sCancellationToken; Python gets a 5s grace window to write a durable.cancelledmarker beforeSIGKILLRunForge: Recover Index— walk.ml/runs/, re-append missing entries to.ml/outputs/index.json, return a structuredRecoveryReport