<!-- # hard line break macro for HTML -->

# fiftyone.utils.lfw

Utilities for working with the
[Labeled Faces in the Wild dataset](http://vis-www.cs.umass.edu/lfw).

Copyright 2017-2026, Voxel51, Inc.
<br/>
[voxel51.com](https://voxel51.com/)
<br/>
<br/>

**Functions:**

| [`download_lfw_dataset`](#fiftyone.utils.lfw.download_lfw_dataset)(dataset_dir[, ...])   | Downloads and extracts the Labeled Faces in the Wild dataset.   |
|------------------------------------------------------------------------------------------|-----------------------------------------------------------------|

### fiftyone.utils.lfw.download_lfw_dataset(dataset_dir, scratch_dir=None, cleanup=True)

Downloads and extracts the Labeled Faces in the Wild dataset.

Any existing files are not re-downloaded.

* **Parameters:**
  * **dataset_dir** – the directory to output the final dataset
  * **scratch_dir** (*None*) – a scratch directory to use to store temporary files
  * **cleanup** (*True*) – whether to cleanup the scratch directory after
    extraction
