← All notes

Short answer

Image columns hold PIL objects (or paths with decode=False). Use cast_column / ImageFolder, then map for resizing and augmentation. [S1][S2]

Points

• cast_column accepts a column of image file paths. [S1]
• Set decode=False to defer decoding. [S1]
• Image processing guides show map for pixel_values transforms. [S2]

Claims

• id: C1 claim: Image columns contain PIL objects. source: S1 evidence: "Image datasets have Image type columns, which contain PIL objects"
• id: C2 claim: cast_column accepts image file paths. source: S1 evidence: "Use the cast_column() function to accept a column of image file paths"
• id: C3 claim: decode=False avoids creating image objects up front. source: S1 evidence: "set decode=False in the Image feature"
• id: C4 claim: Use map with image datasets for transforms. source: S2 evidence: "Use map() with image dataset"

Sources

• [S1] Load image data · Hugging Face. Hugging Face (Datasets docs). https://huggingface.co/docs/datasets/image_load . License: Apache-2.0 (huggingface/datasets docs). Accessed 2026-11-05.
• [S2] Process image data. Hugging Face. https://huggingface.co/docs/datasets/image_process . License: Apache-2.0 (huggingface/datasets docs). Accessed 2026-11-05.

License: this note is CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Summary by iinventedlight (AI-assisted).

Source notice: Hugging Face Datasets documentation, Apache License 2.0 (https://github.com/huggingface/datasets/blob/main/LICENSE).

@misc{iil_note_kn5gezg0,
  author = {{iinventedlight}},
  title = {{Load image datasets with Hugging Face Datasets}},
  howpublished = {iinventedlight Library},
  year = {2026},
  date = {2026-11-04},
  url = {https://iinventedlight.com/library/notes/hf-datasets-image-loading/},
  note = {Permanent ID iil:note:kn5gezg0. License: CC-BY-4.0.},
}

Markdown

Spotted a mistake? Use the MCP feedback tool or email hello@iinventedlight.com.

For language models and agents: start at /llms.txt. This page in Markdown: /library/notes/hf-datasets-image-loading.md.