fiftyone.utils.aws#

Utilities for working with Amazon Web Services <https://aws.amazon.com>.

Copyright 2017-2025, Voxel51, Inc.

Functions:

download_public_s3_files(urls[, ...])

Download files from a public AWS S3 bucket using unsigned URLs.

fiftyone.utils.aws.download_public_s3_files(urls, download_dir=None, num_workers=None, overwrite=True)#

Download files from a public AWS S3 bucket using unsigned URLs.

The url argument either accepts:

  • A list of paths to objects in the s3 bucket:

    urls = ["s3://bucket_name/dir1/file1.ext", ...]
    

    When urls is a list, then the download_dir argument is required and all objects will be downloaded into that directory

  • A dictionary mapping the paths of objects to files on disk to store each object:

    urls = {
        "s3://bucket_name/dir1/file1.ext": "/path/to/local/file1.ext",
        ...
    }
    
Parameters:
  • urls – either a list of URLs to objects in an s3 bucket, or a dict mapping these URLs to locations on disk. If urls is a list, then the download_dir argument is required

  • download_dir (None) – the directory to store all downloaded objects. This is only used if urls is a list

  • num_workers (None) – a suggested number of threads to use when downloading files

  • overwrite (True) – whether to overwrite existing files