Skip to main content

Usage

sync [OPTIONS] [PATHS]...

Description

Upload .wandb files specified by PATHS. This is a beta re-implementation of wandb sync. It is not feature complete, not guaranteed to work, and may change in backward-incompatible ways in any release of wandb. PATHS can include .wandb files, run directories containing .wandb files, and “wandb” directories containing run directories. For example, to sync all runs in the current .wandb directory:
wandb beta sync ./wandb
To sync a specific run by specifying the run directory:
wandb beta sync ./wandb/run-20250813_124246-n67z9ude
Or equivalently:
wandb beta sync ./wandb/run-20250813_124246-n67z9ude/run-n67z9ude.wandb

Arguments

NameDefaultType
pathsPATHFalse

Options

FlagTypeDescription
--liveBOOL FlagSync a run while it’s still being logged. This may hang if the process generating the run crashes uncleanly. Default: False
-e, --entitySTRAn entity override to use for all runs being synced. Default:
-p, --projectSTRA project override to use for all runs being synced. Default:
--idSTRA run ID override to use for all runs being synced. If setting this and syncing multiple files (with the same entity and project), the files will be synced in order of start time. This is intended to work with syncing multiple resumed fragments of the same run. Default:
--job-typeSTRA job type override for all runs being synced. Default:
--replace-tagsSTRRename tags using the format ‘old1=new1,old2=new2’. Default:
--skip-syncedBOOL FlagSkip runs that have already been synced with this command. Default: True
--dry-runBOOL FlagPrint what would happen without uploading anything. Default: False
-v, --verboseBOOL FlagPrint more information. Default: False
-nINTMax number of runs to sync at a time. When syncing multiple files that are part of the same run, the files are synced sequentially in order of start time regardless of this setting. This happens for resumed runs or when using the —id parameter. Default: 5