Skip to main content
App version: 3.20250901

Resume a run

If a run was interrupted and became inactive, you can reconnect to it and continue logging metadata.

To resume an existing run, pass the run identifier to the run_id argument of the Run constructor:

from neptune_scale import Run


run = Run(run_id="SomeExistingRunId")
note

To specify the run ID, use the sys/custom_run_id attribute.

It's the run identifier that you set manually via the run_id argument of the Run constructor. If not provided, it's auto-generated.

After resuming a connection to the run, you can continue logging normally.

Example

Connect to an existing run and log new metadata:

from neptune_scale import Run


if __name__ == "__main__":
run = Run(run_id="seagull-s68kj78") # a run with this ID already exists

# continune logging metrics
for step in epoch: # start where the last run left off
run.log_metrics(
...,
step=step,
)

run.add_tags(tags=["best"])

Overwrite existing metadata

Note that calling log_configs() and passing different values for existing attributes will overwrite the previous values. For details, see Edit run configs.

When logging metrics, previously logged steps are not affected. You can continue logging metrics at any step that's higher than the series' last entry.

Resume a forked run

To resume a forked run, specify the parent run and step that the run was originally forked from:

from neptune_scale import Run

run = Run(
run_id="SomeExistingRunId",
fork_run_id="OriginalParentId",
fork_step=100,
)

This workaround is needed due to a technical limitation. If you don't provide the fork details, some errors are raised, but the data is still logged to the resumed run.