Search images using natural language queries with optional filters.

This tool performs semantic search across your photo archive using AI-powered image understanding. It finds images based on their visual content, not just filenames or tags.

Args: query: Natural language search query describing what you're looking for. Examples: "person in a room", "mountain landscape", "children playing", "sunset over water", "food on a table" limit: Maximum number of results to return (default: 10, max: 100) date_from: Filter results to images taken on or after this date (ISO format: YYYY-MM-DD) date_to: Filter results to images taken on or before this date (ISO format: YYYY-MM-DD) folder_pattern: Filter by folder path pattern (e.g., "2024" or "vacation")

Returns: Dictionary containing: - success: Whether the search succeeded - query: The search query used - count: Number of results found - results: List of matching images with metadata and similarity scores

Get detailed metadata for a specific image.

Retrieves comprehensive information about an image including EXIF data, camera settings, location, and file details.

Args: image_id: Unique identifier for the image (obtained from search results)

Returns: Dictionary containing: - success: Whether the operation succeeded - image: Complete metadata including: - filepath: Full path to the image file - filename: Name of the file - folder: Folder containing the image - width/height: Image dimensions - date_taken: When the photo was taken (if available) - camera_make/model: Camera information - lens_model: Lens used - focal_length: Focal length in mm - aperture: F-stop value - iso: ISO sensitivity - shutter_speed: Exposure time - gps_latitude/longitude: Location coordinates (if available) - tags: Associated tags

Re-index the photo archive for new or modified images.

Scans the archive for new or changed images and updates the search index. This should be run after adding new photos to the archive.

Args: force: If True, re-index ALL images (slow). If False, only index new or modified images (default, recommended)

Returns: Dictionary containing: - success: Whether indexing succeeded - total_images: Total number of images found - indexed: Number of images indexed - errors: Number of errors encountered - duration_seconds: Time taken to complete indexing

Get statistics about the indexed photo archive.

Provides an overview of your photo collection including total count, date range, storage size, and distribution by camera and folder.

Returns: Dictionary containing: - success: Whether the operation succeeded - total_images: Total number of indexed images - date_range: Earliest and latest photo dates - total_size_bytes: Total storage used in bytes - total_size_gb: Total storage used in gigabytes - top_cameras: Most common camera models - top_folders: Folders with the most images