Download data - Nullspace

Download directly from volumes when persistent data needs to leave Nullspace. Sources are absolute volume-internal paths rooted at /.

Download A File

result = volume.files.download_file("/models/model.bin", "./model.bin")
print(result.path, result.bytes_downloaded)

Downloads do not overwrite local paths unless you opt in:

volume.files.download_file("/models/model.bin", "./model.bin", overwrite=True)

CLI --force maps to SDK overwrite=True.

volume.files.download_dir("/datasets", "./datasets-copy", overwrite=True)

Directory downloads fetch a tar archive internally and extract it by default.

volume.files.download_dir(
    "/datasets",
    "./datasets.tar",
    archive=True,
    overwrite=True,
)

Use archive=True or --archive when you want to keep the tar file instead of extracting it locally.

volume.files.download("/models/model.bin", "./model.bin", overwrite=True)
volume.files.download("/datasets", "./datasets-copy", overwrite=True)

download() checks the source path and dispatches to the file or directory download helper.

file_url = volume.files.download_url("/models/model.bin")
archive_url = volume.files.download_url("/datasets", archive_format="tar")

Use signed URLs when a browser, CI job, or another service should fetch data directly.