Unsplash Image Search & Download

Search Unsplash for images, download them, and optionally add text overlay.

Tool Location

• Script: ~/.agents/tools/unsplash-search.py
• Env file: ~/.agents/tools/.env (contains UNSPLASH_CLIENT_ID)

Quick Usage

Search and download a random matching image

python ~/.agents/tools/unsplash-search.py \
  --query "nature landscape" \
  --output ./image.jpg