tf.keras.utils.get_file

Downloads a file from a URL if it not already in the cache.

tf.keras.utils.get_file(
    fname=None,
    origin=None,
    untar=False,
    md5_hash=None,
    file_hash=None,
    cache_subdir='datasets',
    hash_algorithm='auto',
    extract=False,
    archive_format='auto',
    cache_dir=None,
    force_download=False
)

Used in the notebooks

Used in the guideUsed in the tutorials

By default the file at the url origin is downloaded to the cache_dir ~/.keras, placed in the cache_subdir datasets, and given the filename fname. The final location of a file example.txt would therefore be ~/.keras/datasets/example.txt. Files in .tar, .tar.gz, .tar.bz, and .zip formats can also be extracted.

Passing a hash will verify the file after download. The command line programs shasum and sha256sum can compute the hash.

Example:

path_to_downloaded_file = get_file(
    origin="https://storage.googleapis.com/download.tensorflow.org/example_images/flower_photos.tgz",
    extract=True,
)

fnameName of the file. If an absolute path, e.g. "/path/to/file.txt" is specified, the file will be saved at that location. If None, the name of the file at origin will be used.
originOriginal URL of the file.
untarDeprecated in favor of extract argument. boolean, whether the file should be decompressed
md5_hashDeprecated in favor of file_hash argument. md5 hash of the file for verification
file_hashThe expected hash string of the file after download. The sha256 and md5 hash algorithms are both supported.
cache_subdirSubdirectory under the Keras cache dir where the file is saved. If an absolute path, e.g. "/path/to/folder" is specified, the file will be saved at that location.
hash_algorithmSelect the hash algorithm to verify the file. options are "md5', "sha256', and "auto'. The default 'auto' detects the hash algorithm in use.
extractTrue tries extracting the file as an Archive, like tar or zip.
archive_formatArchive format to try for extracting the file. Options are "auto', "tar', "zip', and None. "tar" includes tar, tar.gz, and tar.bz files. The default "auto" corresponds to ["tar", "zip"]. None or an empty list will return no matches found.
cache_dirLocation to store cached files, when None it defaults ether $KERAS_HOME if the KERAS_HOME environment variable is set or ~/.keras/.
force_downloadIf True, the file will always be re-downloaded regardless of the cache state.

Path to the downloaded file.

⚠️ Warning on malicious downloads ⚠️

Downloading something from the Internet carries a risk. NEVER download a file/archive if you do not trust the source. We recommend that you specify the file_hash argument (if the hash of the source file is known) to make sure that the file you are getting is the one you expect.