This Python tool leverages Google's Gemini API to perform AI-powered geolocation analysis on images, identifying where they were taken. It's designed for researchers and users interested in image analysis and location intelligence, offering a straightforward way to extract geographical data from visual content.

How It Works

GeoSpy utilizes Google's Gemini API, a multimodal AI model, to analyze image content and infer its geographical origin. The tool processes image data, potentially augmented by user-provided context or guesses, to generate location predictions. This approach allows for sophisticated analysis beyond simple metadata, aiming to identify cities, states, and countries with associated confidence levels and coordinates.

Quick Start & Requirements

• Install via pip: pip install geospyer
• Requires a Google Gemini API key, which can be set as an environment variable (GEMINI_API_KEY), passed during initialization, or provided via the --api-key command-line argument.
• Official documentation and examples are available in the repository.

Highlighted Details

• AI-powered geolocation using Google's Gemini API.
• Supports local image files and image URLs.
• Generates Google Maps links from identified coordinates.
• Outputs results in a structured JSON format, including confidence levels and reasoning.

Maintenance & Community

• The project is open for contributions via pull requests.
• No specific community channels (e.g., Discord, Slack) or notable contributors are listed in the README.

Licensing & Compatibility

• Licensed under the MIT License.
• Permissive for commercial use and integration with closed-source projects.

Limitations & Caveats

The tool is intended for educational and research purposes only, and its predictions are not guaranteed to be accurate. Users are cautioned against using it for surveillance, stalking, law enforcement, or any activity that infringes on privacy or violates laws.