ARTI

ARTI guides

Recover an interrupted run

Inspect a completed checkpoint, retain the original training horizon and continue in a fresh attempt directory.

On this page

Inspect before constructing a model

A recovery plan reads recorded recipe/run metadata and validates the latest completed checkpoint. Integrity checks may hash files, but planning does not decode tensor payloads, import task code or allocate a model.

Terminal
python -m arti recipe resume-run outputs/first --plan-only --output recovery-plan.json

ActionNext step
resume_trainingRestore complete state and finish remaining updates
finalizeEvaluate and export with zero new optimizer updates
already_completedReturn the existing successful task result

Finish the original target

Recovery at update 80 of a 200-update task requests 120 remaining updates. It does not request another 200. Ordinary fit(steps=N, resume_from_checkpoint=...) requests N additional updates instead. Learned early stopping is terminal; recovery does not ignore its patience decision.

Terminal
python -m arti recipe resume-run outputs/first --run-dir outputs/recovered --max-seconds 300

Restore coherent training state

Supported checkpoints restore tensor state, optimizer, scheduler, RNG, data position and validation selection through the existing loader. The last-state checkpoint resumes training; the validation-selected model serves prediction and export. Deployment assets alone are not training checkpoints.

Keep availableWhy
Complete checkpointRestore weights and optimizer moments
Original data identityCheck the same task and preprocessing
Pinned task factory / immutable hostReconstruct the recorded execution contract

Relocate resources without changing the task

Custom tasks can replace named resource locations with --resources-json. The same task, data, objective, engine and supported state must still match. Relocation changes a path, not the mathematical contract. The original source run and resolved recipe remain intact.

Terminal
python -m arti recipe resume-run moved/run --plan-only
python -m arti recipe resume-run moved/run --run-dir outputs/recovered --resources-json relocated-resources.json