Pull the output of one or more OSMO workflows to a local folder. A workflow's data lives under a fixed Swift bucket path; the workflow name is all the user needs to supply.
URI construction
Each workflow name maps to a bucket URI by prefixing:
swift://pdx.s8k.io/AUTH_team-isaac/isaaclab_arena/workflows/<workflow-name>
osmo data download takes that URI and a local path:
osmo data download "swift://pdx.s8k.io/AUTH_team-isaac/isaaclab_arena/workflows/<workflow-name>" "<destination-folder>"
Do not use osmo dataset download here — that command resolves named datasets, not workflow
outputs, and will reject a workflow name as an invalid dataset. The data/dataset distinction is
the most common mistake with these downloads.
Procedure
-
Resolve inputs. Take the workflow name(s) and the destination folder from the user. If the user gave an OSMO workflow name (what the workflow service lists), it already works directly — no derivation beyond the prefix above.
-
Pick a per-workflow subfolder unless the user says otherwise. When downloading more than one workflow into a single parent folder, place each under its own
<destination>/<workflow-name>/subfolder so their contents don't merge. For a single workflow, download straight into the given folder if the user asked for exactly that. -
Check disk headroom for large pulls. Video-bearing workflows (e.g.
..._100epwith rendered.mp4s) are tens of GB each; "no vid" workflows are much smaller. Rundf -h <destination>before a multi-workflow batch. -
Create the folder and download.
mkdir -pthe destination, then run theosmo data downloadcommand. For several workflows, run them sequentially (each download already parallelises with 32 processes internally — concurrent whole-workflow downloads just contend). Launch long batches in the background and report the task id. -
Verify. After a download finishes, confirm files landed and report the size:
find "<destination>" -type f | wc -l du -sh "<destination>"
Login
osmo data download needs a valid OSMO login. On an expired token it fails with
invalid_grant … Please re-login with "osmo login". osmo login is an interactive device flow that
must be run by the user — ask them to run ! osmo login in the session, then retry the download. Do
not attempt to complete the login flow yourself.
Resuming
If a download is interrupted, re-run the same command with --resume (-r) to continue rather than
restarting from scratch.
Batch pattern
For several workflows into one parent folder:
BASE=<destination-parent>
URI=swift://pdx.s8k.io/AUTH_team-isaac/isaaclab_arena/workflows
for run in <workflow-1> <workflow-2> <workflow-3>; do
dest="$BASE/$run"
mkdir -p "$dest"
osmo data download "$URI/$run" "$dest"
done