Run states

The run state indicates the current status of a W&B run. Check a run’s state to confirm whether training is still in progress, has completed successfully, or has stopped unexpectedly. You can view the state of a run in the W&B App or programmatically using the W&B Python SDK.

The following table describes the possible states a run can be in:

State	Description
`Crashed`	The run stopped sending heartbeats in the internal process, which can happen if the machine crashes.
`Failed`	The run ended with a non-zero exit status.
`Finished`	The run ended and fully synced data, or called `wandb.Run.finish()`.
`Killed`	The run was forcibly stopped before it could finish.
`Running`	The run is still running and has recently sent a heartbeat.
`Pending`	The run is scheduled but not yet started (common in sweeps and Launch jobs).

Run states in sweeps

When runs are part of a sweep, their states behave independently from the sweep’s status. The following points describe how run states interact with sweeps:

Individual run states reflect each run’s execution status, such as Running, Finished, or Failed.
Sweep status controls whether new runs are created, not how existing runs execute.
Pausing or stopping a sweep doesn’t affect already-running runs.
Only canceling a sweep forcibly stops running runs (changes their state to Killed).

For a detailed explanation of how sweep and run statuses interact, see Understanding sweep and run statuses.

View the state of a run

You can view a run’s state programmatically with the Python SDK or interactively in the W&B App. Choose the Python SDK to inspect or filter states across many runs at once. Choose the W&B App to check a single run interactively.

Python SDK
W&B App

Use the state property of the wandb.Api.Run object to access the current state of a run.The following code snippet retrieves and prints the state of all runs in a specified project. Copy the following code snippet into your Python environment. Replace [ENTITY] with your W&B entity name and [PROJECT] with your W&B project name:

import wandb

api = wandb.Api()

runs = api.runs(path="[ENTITY]/[PROJECT]")

# Access run object's properties
for run in runs:
    print(f"Run: {run.name}")
    print(f"Run state: {run.state}")
    print()

You can apply different filters to retrieve runs from your projects based on different criteria. See Filter runs to learn more about filtering runs programmatically.

Guides

Integrations

Reference

Run states

Run states

Run states in sweeps

View the state of a run

​Run states

​Run states in sweeps

​View the state of a run

Run states

Run states in sweeps

View the state of a run