geomind-ai 1.1.1__tar.gz → 1.2.0__tar.gz

{geomind_ai-1.1.1 → geomind_ai-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geomind-ai
-Version: 1.1.1
+Version: 1.2.0
 Summary: AI agent for geospatial analysis with Sentinel-2 satellite imagery
 Author: Harsh Shinde, Rajat Shinde
 License-Expression: MIT

{geomind_ai-1.1.1 → geomind_ai-1.2.0}/geomind/__init__.py

@@ -3,7 +3,7 @@ GeoMind - Geospatial AI Agent
 
 """
 
-__version__ = "1.1.0"
+__version__ = "1.2.0"
 __author__ = "Harsh Shinde, Rajat Shinde"
 
 from .agent import GeoMindAgent

geomind_ai-1.2.0/geomind/agent.py

@@ -0,0 +1,218 @@
+"""
+GeoMind Agent - Simplified AI agent for satellite imagery analysis.
+"""
+
+import json
+from typing import Optional
+from datetime import datetime
+from openai import OpenAI
+
+from .config import OPENROUTER_API_KEY, OPENROUTER_API_URL, OPENROUTER_MODEL
+from .tools import (
+    list_recent_imagery,
+    create_rgb_composite,
+    calculate_ndvi,
+    search_imagery,
+    get_bbox_from_location,
+    geocode_location,
+    get_item_details,
+    get_band_statistics,
+)
+
+# Tool function mapping
+TOOL_FUNCTIONS = {
+    "list_recent_imagery": list_recent_imagery,
+    "create_rgb_composite": create_rgb_composite,
+    "calculate_ndvi": calculate_ndvi,
+    "search_imagery": search_imagery,
+    "get_bbox_from_location": get_bbox_from_location,
+    "geocode_location": geocode_location,
+    "get_item_details": get_item_details,
+    "get_band_statistics": get_band_statistics,
+}
+
+# Simplified tool definitions
+TOOLS = [
+    {
+        "type": "function",
+        "function": {
+            "name": "list_recent_imagery",
+            "description": "Find recent Sentinel-2 imagery for a location",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "location_name": {"type": "string", "description": "Location name"},
+                    "days": {"type": "integer", "description": "Days to look back (default: 14)"},
+                    "max_cloud_cover": {"type": "number", "description": "Max cloud cover %"},
+                    "max_items": {"type": "integer", "description": "Max results"},
+                },
+                "required": [],
+            },
+        },
+    },
+    {
+        "type": "function",
+        "function": {
+            "name": "create_rgb_composite",
+            "description": "Create RGB composite from Sentinel-2 data",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "zarr_url": {"type": "string", "description": "SR_10m Zarr URL"},
+                    "location_name": {"type": "string", "description": "Location for title"},
+                    "subset_size": {"type": "integer", "description": "Image size (default: 1000)"},
+                },
+                "required": ["zarr_url"],
+            },
+        },
+    },
+    {
+        "type": "function",
+        "function": {
+            "name": "calculate_ndvi",
+            "description": "Calculate NDVI vegetation index",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "zarr_url": {"type": "string", "description": "SR_10m Zarr URL"},
+                    "location_name": {"type": "string", "description": "Location for title"},
+                    "subset_size": {"type": "integer", "description": "Image size (default: 1000)"},
+                },
+                "required": ["zarr_url"],
+            },
+        },
+    },
+    {
+        "type": "function",
+        "function": {
+            "name": "search_imagery",
+            "description": "Search Sentinel-2 imagery by parameters",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "bbox": {"type": "array", "items": {"type": "number"}, "description": "Bounding box"},
+                    "start_date": {"type": "string", "description": "Start date YYYY-MM-DD"},
+                    "end_date": {"type": "string", "description": "End date YYYY-MM-DD"},
+                    "max_cloud_cover": {"type": "number", "description": "Max cloud cover %"},
+                    "max_items": {"type": "integer", "description": "Max results"},
+                },
+                "required": [],
+            },
+        },
+    },
+    {
+        "type": "function",
+        "function": {
+            "name": "get_bbox_from_location",
+            "description": "Get bounding box for a location",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "place_name": {"type": "string", "description": "Location name"},
+                    "buffer_km": {"type": "number", "description": "Buffer distance in km"},
+                },
+                "required": ["place_name"],
+            },
+        },
+    },
+]
+
+
+class GeoMindAgent:
+    """Simplified GeoMind agent for satellite imagery analysis."""
+
+    def __init__(self, model: Optional[str] = None, api_key: Optional[str] = None):
+        self.api_key = api_key or OPENROUTER_API_KEY
+        self.model_name = model or OPENROUTER_MODEL
+        
+        if not self.api_key:
+            raise ValueError("OpenRouter API key required")
+            
+        print(f"GeoMind Agent initialized with {self.model_name}")
+        self.client = OpenAI(base_url=OPENROUTER_API_URL, api_key=self.api_key)
+        self.history = []
+
+    def _get_system_prompt(self) -> str:
+        """Short, focused system prompt."""
+        return f"""You are GeoMind, an AI assistant for satellite imagery analysis using Sentinel-2 data.
+
+Current date: {datetime.now().strftime('%Y-%m-%d')}
+
+KEY RULES:
+1. Use list_recent_imagery to find satellite data for locations
+2. Extract Zarr URLs from results: item['zarr_assets']['SR_10m']['href'] 
+3. Always include location_name parameter when creating images
+4. Use actual function response data in your answers (don't make up paths/stats)
+5. Let functions use default output paths (saves to outputs/ folder as .png)
+
+Be helpful and accurate - always use real data from function responses."""
+
+    def chat(self, message: str, verbose: bool = True) -> str:
+        """Send message to agent and get response."""
+        if verbose:
+            print(f"\nUser: {message}")
+            print("Processing...")
+
+        self.history.append({"role": "user", "content": message})
+        messages = [{"role": "system", "content": self._get_system_prompt()}] + self.history
+
+        for _ in range(10):  # Max 10 iterations
+            response = self.client.chat.completions.create(
+                model=self.model_name,
+                messages=messages,
+                tools=TOOLS,
+                tool_choice="auto",
+                max_tokens=4096,
+            )
+
+            choice = response.choices[0]
+            assistant_message = choice.message
+
+            tool_calls = assistant_message.tool_calls
+            if tool_calls:
+                # Add assistant message with tool calls
+                messages.append({
+                    "role": "assistant",
+                    "content": assistant_message.content or "",
+                    "tool_calls": [
+                        {
+                            "id": tc.id,
+                            "type": "function",
+                            "function": {"name": tc.function.name, "arguments": tc.function.arguments},
+                        }
+                        for tc in tool_calls
+                    ],
+                })
+
+                # Execute tool calls
+                for tool_call in tool_calls:
+                    func_name = tool_call.function.name
+                    func_args = json.loads(tool_call.function.arguments)
+                    
+                    print(f"  Executing: {func_name}({func_args})")
+                    
+                    try:
+                        result = TOOL_FUNCTIONS[func_name](**func_args)
+                    except Exception as e:
+                        result = {"error": str(e)}
+
+                    messages.append({
+                        "role": "tool",
+                        "tool_call_id": tool_call.id,
+                        "content": json.dumps(result, default=str),
+                    })
+            else:
+                # Final response
+                final_text = assistant_message.content or ""
+                self.history.append({"role": "assistant", "content": final_text})
+                
+                if verbose:
+                    print(f"\nGeoMind: {final_text}")
+                    
+                return final_text
+
+        return "Max iterations reached"
+
+    def reset(self):
+        """Reset chat history."""
+        self.history = []

{geomind_ai-1.1.1 → geomind_ai-1.2.0}/geomind/config.py

@@ -37,9 +37,9 @@ REFLECTANCE_OFFSET = -0.1
 RGB_BANDS = {"red": "b04", "green": "b03", "blue": "b02"}
 
 # Default search parameters
-DEFAULT_MAX_CLOUD_COVER = 20  # percent
-DEFAULT_BUFFER_KM = 10  # km buffer around point for bbox
-DEFAULT_MAX_ITEMS = 10
+DEFAULT_MAX_CLOUD_COVER = 50  # percent (increased for better results)
+DEFAULT_BUFFER_KM = 15  # km buffer around point for bbox (increased coverage)
+DEFAULT_MAX_ITEMS = 20  # increased to find more options
 
 # Output directory for saved images
 OUTPUT_DIR = Path("outputs")

{geomind_ai-1.1.1 → geomind_ai-1.2.0}/geomind/tools/processing.py

@@ -99,6 +99,7 @@ def create_rgb_composite(
     zarr_url: str,
     output_path: Optional[str] = None,
     subset_size: Optional[int] = 1000,
+    location_name: Optional[str] = None,
 ) -> dict:
     """
     Create an RGB composite image from Sentinel-2 10m bands.
@@ -109,6 +110,7 @@ def create_rgb_composite(
         zarr_url: URL to the SR_10m Zarr asset or individual band asset URL
         output_path: Optional path to save the image
         subset_size: Size to subset the image (for faster processing)
+        location_name: Optional location name to include in the title
 
     Returns:
         Dictionary with path to saved image and metadata
@@ -116,38 +118,49 @@ def create_rgb_composite(
     try:
         import xarray as xr
         import zarr
+        import re
 
         # Determine if this is a band-specific URL or base SR_10m URL
-        # Band-specific URLs end with /b02, /b03, /b04, etc.
-        # Base SR_10m URLs end with /r10m
-        is_band_url = zarr_url.rstrip('/').split('/')[-1].startswith('b')
+        # Band-specific URLs end with /b01, /b02, etc. (Sentinel-2 band pattern)
+        url_parts = zarr_url.rstrip('/').split('/')
+        last_part = url_parts[-1]
+        is_band_url = re.match(r'^b(0[1-9]|1[0-2]|8a)(_\d+m)?$', last_part.lower()) is not None
         
         if is_band_url:
             # Individual band URL provided - need to construct URLs for each band
             base_url = '/'.join(zarr_url.rstrip('/').split('/')[:-1])
-            red = np.array(zarr.open(f"{base_url}/b04", mode="r"))
-            green = np.array(zarr.open(f"{base_url}/b03", mode="r"))
-            blue = np.array(zarr.open(f"{base_url}/b02", mode="r"))
+            red_zarr = zarr.open(f"{base_url}/b04", mode="r")
+            green_zarr = zarr.open(f"{base_url}/b03", mode="r")
+            blue_zarr = zarr.open(f"{base_url}/b02", mode="r")
         else:
             # Base SR_10m URL - bands are subdirectories
             base_url = zarr_url.rstrip('/')
-            red = np.array(zarr.open(f"{base_url}/b04", mode="r"))
-            green = np.array(zarr.open(f"{base_url}/b03", mode="r"))
-            blue = np.array(zarr.open(f"{base_url}/b02", mode="r"))
+            red_zarr = zarr.open(f"{base_url}/b04", mode="r")
+            green_zarr = zarr.open(f"{base_url}/b03", mode="r")
+            blue_zarr = zarr.open(f"{base_url}/b02", mode="r")
+
+        # Determine subset region before loading data
+        full_shape = red_zarr.shape
+        if subset_size and full_shape[0] > subset_size:
+            # Calculate center subset
+            h, w = full_shape
+            start_h = (h - subset_size) // 2
+            start_w = (w - subset_size) // 2
+            
+            # Load only the subset (memory efficient)
+            red = np.array(red_zarr[start_h:start_h + subset_size, start_w:start_w + subset_size])
+            green = np.array(green_zarr[start_h:start_h + subset_size, start_w:start_w + subset_size])
+            blue = np.array(blue_zarr[start_h:start_h + subset_size, start_w:start_w + subset_size])
+        else:
+            # Load full arrays (be careful with large datasets)
+            red = np.array(red_zarr)
+            green = np.array(green_zarr)
+            blue = np.array(blue_zarr)
 
         # Subset if requested (for faster processing)
         if subset_size and red.shape[0] > subset_size:
-            # Take center subset
-            h, w = red.shape
-            start_h = (h - subset_size) // 2
-            start_w = (w - subset_size) // 2
-            red = red[start_h : start_h + subset_size, start_w : start_w + subset_size]
-            green = green[
-                start_h : start_h + subset_size, start_w : start_w + subset_size
-            ]
-            blue = blue[
-                start_h : start_h + subset_size, start_w : start_w + subset_size
-            ]
+            # Already subsetted during loading - this section can be removed
+            pass
 
         # Apply scale and offset
         red = _apply_scale_offset(red)
@@ -171,7 +184,12 @@ def create_rgb_composite(
         # Create figure
         fig, ax = plt.subplots(figsize=(10, 10))
         ax.imshow(rgb)
-        ax.set_title("Sentinel-2 RGB Composite (B4/B3/B2)")
+        
+        # Create dynamic title with location
+        title = "Sentinel-2 RGB Composite (B4/B3/B2)"
+        if location_name:
+            title += f" - {location_name}"
+        ax.set_title(title)
         ax.axis("off")
 
         # Save
@@ -197,6 +215,7 @@ def calculate_ndvi(
     zarr_url: str,
     output_path: Optional[str] = None,
     subset_size: Optional[int] = 1000,
+    location_name: Optional[str] = None,
 ) -> dict:
     """
     Calculate NDVI (Normalized Difference Vegetation Index) from Sentinel-2 data.
@@ -208,6 +227,7 @@ def calculate_ndvi(
         zarr_url: URL to the SR_10m Zarr asset or individual band asset URL
         output_path: Optional path to save the NDVI image
         subset_size: Size to subset the image
+        location_name: Optional location name to include in the title
 
     Returns:
         Dictionary with NDVI statistics and output path
@@ -215,28 +235,40 @@ def calculate_ndvi(
     try:
         import zarr
         from matplotlib.colors import LinearSegmentedColormap
+        import re
 
         # Determine if this is a band-specific URL or base SR_10m URL
-        is_band_url = zarr_url.rstrip('/').split('/')[-1].startswith('b')
+        url_parts = zarr_url.rstrip('/').split('/')
+        last_part = url_parts[-1]
+        is_band_url = re.match(r'^b(0[1-9]|1[0-2]|8a)(_\d+m)?$', last_part.lower()) is not None
         
         if is_band_url:
             # Individual band URL provided
             base_url = '/'.join(zarr_url.rstrip('/').split('/')[:-1])
-            nir = np.array(zarr.open(f"{base_url}/b08", mode="r"))
-            red = np.array(zarr.open(f"{base_url}/b04", mode="r"))
+            nir_zarr = zarr.open(f"{base_url}/b08", mode="r")
+            red_zarr = zarr.open(f"{base_url}/b04", mode="r")
         else:
             # Base SR_10m URL
             base_url = zarr_url.rstrip('/')
-            nir = np.array(zarr.open(f"{base_url}/b08", mode="r"))
-            red = np.array(zarr.open(f"{base_url}/b04", mode="r"))
+            nir_zarr = zarr.open(f"{base_url}/b08", mode="r")
+            red_zarr = zarr.open(f"{base_url}/b04", mode="r")
 
-        # Subset if requested
-        if subset_size and nir.shape[0] > subset_size:
-            h, w = nir.shape
+        # Determine subset region and load efficiently
+        full_shape = nir_zarr.shape
+        if subset_size and full_shape[0] > subset_size:
+            h, w = full_shape
             start_h = (h - subset_size) // 2
             start_w = (w - subset_size) // 2
-            nir = nir[start_h : start_h + subset_size, start_w : start_w + subset_size]
-            red = red[start_h : start_h + subset_size, start_w : start_w + subset_size]
+            nir = np.array(nir_zarr[start_h:start_h + subset_size, start_w:start_w + subset_size])
+            red = np.array(red_zarr[start_h:start_h + subset_size, start_w:start_w + subset_size])
+        else:
+            nir = np.array(nir_zarr)
+            red = np.array(red_zarr)
+
+        # Subset if requested - already handled during loading
+        if subset_size and nir.shape[0] > subset_size:
+            # Already subsetted during loading
+            pass
 
         # Apply scale and offset
         nir = _apply_scale_offset(nir)
@@ -271,7 +303,12 @@ def calculate_ndvi(
         # Create figure
         fig, ax = plt.subplots(figsize=(10, 10))
         im = ax.imshow(ndvi, cmap=ndvi_cmap, vmin=-1, vmax=1)
-        ax.set_title("NDVI - Normalized Difference Vegetation Index")
+        
+        # Create dynamic title with location
+        title = "NDVI - Normalized Difference Vegetation Index"
+        if location_name:
+            title += f" - {location_name}"
+        ax.set_title(title)
         ax.axis("off")
 
         # Add colorbar

{geomind_ai-1.1.1 → geomind_ai-1.2.0}/geomind/tools/stac_search.py

@@ -25,23 +25,32 @@ def _format_item(item) -> dict:
     """Format a STAC item into a simplified dictionary."""
     props = item.properties
 
-    # Extract individual band assets for direct access
+    # Extract ALL assets, with special handling for Zarr assets
     assets = {}
+    zarr_assets = {}
+    other_assets = {}
+    
     for key, asset in item.assets.items():
-        if key in ["SR_10m", "SR_20m", "SR_60m", "TCI_10m", "product"]:
-            assets[key] = {
-                "title": asset.title,
-                "href": asset.href,
-                "type": asset.media_type,
-            }
-        # Include individual 10m band assets for direct access
-        elif key in ["B02_10m", "B03_10m", "B04_10m", "B08_10m"]:
-            assets[key] = {
-                "title": asset.title,
-                "href": asset.href,
-                "type": asset.media_type,
-                "band": key.split("_")[0].lower(),  # Extract band name (b02, b03, b04, b08)
-            }
+        asset_info = {
+            "title": asset.title,
+            "href": asset.href,
+            "type": asset.media_type,
+        }
+        
+        # Add band information for individual band assets
+        if "_" in key and key.split("_")[0] in ["B01", "B02", "B03", "B04", "B05", "B06", "B07", "B08", "B8A", "B09", "B11", "B12"]:
+            band_name = key.split("_")[0].lower()
+            asset_info["band"] = band_name
+            asset_info["resolution"] = key.split("_")[1] if "_" in key else "unknown"
+        
+        # Categorize assets by type
+        if asset.media_type and "zarr" in asset.media_type.lower():
+            zarr_assets[key] = asset_info
+        else:
+            other_assets[key] = asset_info
+        
+        # Include all assets in main assets dict
+        assets[key] = asset_info
 
     return {
         "id": item.id,
@@ -51,7 +60,14 @@ def _format_item(item) -> dict:
         "bbox": item.bbox,
         "geometry": item.geometry,
         "assets": assets,
+        "zarr_assets": zarr_assets,  # Separate zarr assets for easy access
+        "other_assets": other_assets,  # Non-zarr assets
         "stac_url": f"{STAC_API_URL}/collections/{STAC_COLLECTION}/items/{item.id}",
+        "asset_summary": {
+            "total_assets": len(assets),
+            "zarr_assets": len(zarr_assets),
+            "other_assets": len(other_assets),
+        }
     }
 
 
@@ -139,6 +155,10 @@ def search_imagery(
                 "datetime": datetime_str,
                 "max_cloud_cover": max_cloud_cover,
             },
+            "quality_info": {
+                "avg_cloud_cover": sum(item.properties.get("eo:cloud_cover", 100) for item in items) / len(items) if items else None,
+                "best_cloud_cover": min(item.properties.get("eo:cloud_cover", 100) for item in items) if items else None,
+            } if items else {},
         }
 
     except Exception as e:
@@ -186,7 +206,7 @@ def get_item_details(item_id: str) -> dict:
 
 def list_recent_imagery(
     location_name: Optional[str] = None,
-    days: int = 7,
+    days: int = 14,  # Changed from 7 to 14 days default
     max_cloud_cover: Optional[float] = None,
     max_items: Optional[int] = None,
 ) -> dict:
@@ -194,10 +214,11 @@ def list_recent_imagery(
     List recent Sentinel-2 imagery, optionally for a specific location.
 
     This is a convenience function that combines geocoding and search.
+    If no good quality results found, automatically extends search period.
 
     Args:
         location_name: Optional place name to search around
-        days: Number of days to look back (default: 7)
+        days: Number of days to look back (default: 14)
         max_cloud_cover: Maximum cloud cover percentage
         max_items: Maximum items to return
 
@@ -238,6 +259,25 @@ def list_recent_imagery(
         max_items=max_items,
     )
 
+    # If no results found and we used a restrictive cloud cover, try extending time and relaxing cloud cover
+    if result.get("success") and result.get("filtered_count", 0) == 0 and days < 30:
+        # Try 30 days with more permissive cloud cover
+        extended_start = end_date - timedelta(days=30)
+        relaxed_cloud = min((max_cloud_cover or DEFAULT_MAX_CLOUD_COVER) + 30, 80)
+        
+        extended_result = search_imagery(
+            bbox=bbox,
+            start_date=extended_start.strftime("%Y-%m-%d"),
+            end_date=end_date.strftime("%Y-%m-%d"),
+            max_cloud_cover=relaxed_cloud,
+            max_items=max_items,
+        )
+        
+        if extended_result.get("success") and extended_result.get("filtered_count", 0) > 0:
+            result = extended_result
+            result["extended_search"] = True
+            result["note"] = f"Extended search to 30 days with {relaxed_cloud}% cloud cover for better results"
+
     if location_info:
         result["location"] = location_info
 

{geomind_ai-1.1.1 → geomind_ai-1.2.0}/geomind_ai.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: geomind-ai
-Version: 1.1.1
+Version: 1.2.0
 Summary: AI agent for geospatial analysis with Sentinel-2 satellite imagery
 Author: Harsh Shinde, Rajat Shinde
 License-Expression: MIT

{geomind_ai-1.1.1 → geomind_ai-1.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "geomind-ai"
-version = "1.1.1"
+version = "1.2.0"
 description = "AI agent for geospatial analysis with Sentinel-2 satellite imagery"
 readme = "README.md"
 authors = [

geomind_ai-1.1.1/geomind/agent.py

@@ -1,466 +0,0 @@
-"""
-GeoMind Agent - Main agent class powered by OpenRouter.
-
-This module implements the AI agent that can understand natural language
-queries about satellite imagery and execute the appropriate tools.
-"""
-
-import json
-import re
-from typing import Optional, Callable, Any
-from datetime import datetime
-
-from openai import OpenAI
-
-from .config import (
-    OPENROUTER_API_KEY,
-    OPENROUTER_API_URL,
-    OPENROUTER_MODEL,
-)
-from .tools import (
-    geocode_location,
-    get_bbox_from_location,
-    search_imagery,
-    get_item_details,
-    list_recent_imagery,
-    create_rgb_composite,
-    calculate_ndvi,
-    get_band_statistics,
-)
-
-
-# Map tool names to functions
-TOOL_FUNCTIONS = {
-    "geocode_location": geocode_location,
-    "get_bbox_from_location": get_bbox_from_location,
-    "search_imagery": search_imagery,
-    "list_recent_imagery": list_recent_imagery,
-    "get_item_details": get_item_details,
-    "create_rgb_composite": create_rgb_composite,
-    "calculate_ndvi": calculate_ndvi,
-    "get_band_statistics": get_band_statistics,
-}
-
-# Tool definitions for the LLM
-TOOLS = [
-    {
-        "type": "function",
-        "function": {
-            "name": "geocode_location",
-            "description": "Convert a place name to geographic coordinates (latitude, longitude). Use this when you need to find coordinates for a location.",
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "place_name": {
-                        "type": "string",
-                        "description": "The name of the place to geocode (e.g., 'New York City', 'Paris, France')",
-                    }
-                },
-                "required": ["place_name"],
-            },
-        },
-    },
-    {
-        "type": "function",
-        "function": {
-            "name": "get_bbox_from_location",
-            "description": "Get a bounding box for a location, suitable for searching satellite imagery.",
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "place_name": {
-                        "type": "string",
-                        "description": "The name of the place",
-                    },
-                    "buffer_km": {
-                        "type": "number",
-                        "description": "Buffer distance in kilometers (default: 10)",
-                    },
-                },
-                "required": ["place_name"],
-            },
-        },
-    },
-    {
-        "type": "function",
-        "function": {
-            "name": "search_imagery",
-            "description": "Search for Sentinel-2 satellite imagery in the EOPF catalog. Returns available scenes.",
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "bbox": {
-                        "type": "array",
-                        "items": {"type": "number"},
-                        "description": "Bounding box as [min_lon, min_lat, max_lon, max_lat]",
-                    },
-                    "start_date": {
-                        "type": "string",
-                        "description": "Start date in YYYY-MM-DD format",
-                    },
-                    "end_date": {
-                        "type": "string",
-                        "description": "End date in YYYY-MM-DD format",
-                    },
-                    "max_cloud_cover": {
-                        "type": "number",
-                        "description": "Maximum cloud cover percentage (0-100)",
-                    },
-                    "max_items": {
-                        "type": "integer",
-                        "description": "Maximum number of results",
-                    },
-                },
-                "required": [],
-            },
-        },
-    },
-    {
-        "type": "function",
-        "function": {
-            "name": "list_recent_imagery",
-            "description": "List recent Sentinel-2 imagery for a location. Combines geocoding and search.",
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "location_name": {
-                        "type": "string",
-                        "description": "Name of the location to search",
-                    },
-                    "days": {
-                        "type": "integer",
-                        "description": "Number of days to look back (default: 7)",
-                    },
-                    "max_cloud_cover": {
-                        "type": "number",
-                        "description": "Maximum cloud cover percentage",
-                    },
-                    "max_items": {
-                        "type": "integer",
-                        "description": "Maximum number of results",
-                    },
-                },
-                "required": [],
-            },
-        },
-    },
-    {
-        "type": "function",
-        "function": {
-            "name": "get_item_details",
-            "description": "Get detailed information about a specific Sentinel-2 scene by its ID.",
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "item_id": {"type": "string", "description": "The STAC item ID"}
-                },
-                "required": ["item_id"],
-            },
-        },
-    },
-    {
-        "type": "function",
-        "function": {
-            "name": "create_rgb_composite",
-            "description": "Create an RGB true-color composite image from Sentinel-2 data.",
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "zarr_url": {
-                        "type": "string",
-                        "description": "URL to the SR_10m Zarr asset from a STAC item",
-                    },
-                    "output_path": {
-                        "type": "string",
-                        "description": "Optional path to save the output image",
-                    },
-                    "subset_size": {
-                        "type": "integer",
-                        "description": "Size to subset the image (default: 1000 pixels)",
-                    },
-                },
-                "required": ["zarr_url"],
-            },
-        },
-    },
-    {
-        "type": "function",
-        "function": {
-            "name": "calculate_ndvi",
-            "description": "Calculate NDVI (vegetation index) from Sentinel-2 data.",
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "zarr_url": {
-                        "type": "string",
-                        "description": "URL to the SR_10m Zarr asset",
-                    },
-                    "output_path": {
-                        "type": "string",
-                        "description": "Optional path to save the NDVI image",
-                    },
-                    "subset_size": {
-                        "type": "integer",
-                        "description": "Size to subset the image",
-                    },
-                },
-                "required": ["zarr_url"],
-            },
-        },
-    },
-    {
-        "type": "function",
-        "function": {
-            "name": "get_band_statistics",
-            "description": "Get statistics (min, max, mean) for spectral bands.",
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "zarr_url": {
-                        "type": "string",
-                        "description": "URL to the Zarr asset",
-                    },
-                    "bands": {
-                        "type": "array",
-                        "items": {"type": "string"},
-                        "description": "List of band names to analyze",
-                    },
-                },
-                "required": ["zarr_url"],
-            },
-        },
-    },
-]
-
-
-class GeoMindAgent:
-    """
-    GeoMind - An AI agent for geospatial analysis with Sentinel-2 imagery.
-
-    Uses OpenRouter API for access to multiple AI models.
-    """
-
-    def __init__(self, model: Optional[str] = None, api_key: Optional[str] = None):
-        """
-        Initialize the GeoMind agent.
-
-        Args:
-            model: Model name (default: nvidia/nemotron-3-nano-30b-a3b:free)
-            api_key: OpenRouter API key (required).
-        """
-        self.provider = "openrouter"
-        self.api_key = api_key or OPENROUTER_API_KEY
-        self.model_name = model or OPENROUTER_MODEL
-        self.base_url = OPENROUTER_API_URL
-
-        if not self.api_key:
-            raise ValueError(
-                "OpenRouter API key required.\n"
-                "Get your FREE API key at: https://openrouter.ai/settings/keys\n\n"
-                "Then provide it in one of these ways:\n"
-                "1. Run: geomind --api-key YOUR_KEY\n"
-                "2. Set environment variable: OPENROUTER_API_KEY=YOUR_KEY\n"
-                "3. Create .env file with: OPENROUTER_API_KEY=YOUR_KEY"
-            )
-
-        print(f"GeoMind Agent initialized with {self.model_name}")
-
-        # Create OpenAI-compatible client
-        self.client = OpenAI(base_url=self.base_url, api_key=self.api_key)
-
-        # Chat history
-        self.history = []
-
-        # Add system message
-        self.system_prompt = self._get_system_prompt()
-
-    def _get_system_prompt(self) -> str:
-        """Get the system prompt for the agent."""
-        return f"""You are GeoMind, an expert AI assistant specialized in geospatial analysis 
-and satellite imagery. You help users find, analyze, and visualize Sentinel-2 satellite data 
-from the EOPF (ESA Earth Observation Processing Framework) catalog.
-
-Your capabilities include:
-1. **Search**: Find Sentinel-2 L2A imagery by location, date, and cloud cover
-2. **Geocoding**: Convert place names to coordinates for searching
-3. **Visualization**: Create RGB composites and NDVI maps from imagery
-4. **Analysis**: Calculate spectral indices and band statistics
-
-Key information:
-- Data source: EOPF STAC API (https://stac.core.eopf.eodc.eu)
-- Satellite: Sentinel-2 (L2A surface reflectance products)
-- Bands available: B01-B12 at 10m, 20m, or 60m resolution
-- Current date: {datetime.now().strftime('%Y-%m-%d')}
-
-IMPORTANT - Zarr URL usage:
-- STAC search results include both SR_10m (base URL) and individual band assets (B02_10m, B03_10m, B04_10m, B08_10m)
-- EITHER type of URL works for create_rgb_composite and calculate_ndvi:
-  * SR_10m URL: Points to .../measurements/reflectance/r10m (contains all bands as subdirectories)
-  * Individual band URLs: Point directly to specific bands like .../r10m/b02
-- Prefer using SR_10m URL as it's simpler and works for all bands
-- The processing functions automatically handle the correct path structure
-
-When users ask for imagery:
-1. First use get_bbox_from_location or list_recent_imagery to search
-2. Present the results clearly with key metadata (ID, date, cloud cover)
-3. Offer to create visualizations if data is found
-4. For visualizations, use the SR_10m asset URL from search results
-
-Always explain what you're doing and interpret results in a helpful way."""
-
-    def _call_llm(self, messages: list, tools: list) -> dict:
-        """Call LLM via OpenAI-compatible client."""
-        response = self.client.chat.completions.create(
-            model=self.model_name,
-            messages=messages,
-            tools=tools,
-            tool_choice="auto",
-            max_tokens=4096,
-        )
-        return response.model_dump()
-
-    def _execute_function(self, name: str, args: dict) -> dict:
-        """Execute a function call and return the result."""
-        print(f"  Executing: {name}({args})")
-
-        if name not in TOOL_FUNCTIONS:
-            return {"error": f"Unknown function: {name}"}
-
-        try:
-            result = TOOL_FUNCTIONS[name](**args)
-            return result
-        except Exception as e:
-            return {"error": str(e)}
-
-    def chat(self, message: str, verbose: bool = True) -> str:
-        """
-        Send a message to the agent and get a response.
-        """
-        if verbose:
-            print(f"\nUser: {message}")
-            print("Processing...")
-
-        # Add user message to history
-        self.history.append({"role": "user", "content": message})
-
-        # Build messages with system prompt
-        messages = [{"role": "system", "content": self.system_prompt}] + self.history
-
-        max_iterations = 10
-        iteration = 0
-
-        while iteration < max_iterations:
-            iteration += 1
-
-            # Call the model (via proxy or direct)
-            response_data = self._call_llm(messages, TOOLS)
-
-            # Extract assistant message from response
-            choice = response_data["choices"][0]
-            assistant_message = choice["message"]
-
-            # Check if there are tool calls
-            tool_calls = assistant_message.get("tool_calls", [])
-            if tool_calls:
-                # Add assistant message with tool calls to messages
-                messages.append(
-                    {
-                        "role": "assistant",
-                        "content": assistant_message.get("content") or "",
-                        "tool_calls": [
-                            {
-                                "id": tc["id"],
-                                "type": "function",
-                                "function": {
-                                    "name": tc["function"]["name"],
-                                    "arguments": tc["function"]["arguments"],
-                                },
-                            }
-                            for tc in tool_calls
-                        ],
-                    }
-                )
-
-                # Execute each tool call
-                for tool_call in tool_calls:
-                    func_name = tool_call["function"]["name"]
-                    func_args = json.loads(tool_call["function"]["arguments"])
-
-                    result = self._execute_function(func_name, func_args)
-
-                    # Add tool result to messages
-                    messages.append(
-                        {
-                            "role": "tool",
-                            "tool_call_id": tool_call["id"],
-                            "content": json.dumps(result, default=str),
-                        }
-                    )
-            else:
-                # No tool calls, we have a final response
-                final_text = assistant_message.get("content") or ""
-
-                # Add to history
-                self.history.append({"role": "assistant", "content": final_text})
-
-                if verbose:
-                    print(f"\nGeoMind: {final_text}")
-
-                return final_text
-
-        return "Max iterations reached."
-
-    def reset(self):
-        """Reset the chat session."""
-        self.history = []
-        print("Chat session reset")
-
-
-def main(model: Optional[str] = None):
-    """Main entry point for CLI usage."""
-    import sys
-
-    print("=" * 60)
-    print("GeoMind - Geospatial AI Agent")
-    print("=" * 60)
-    print("Powered by OpenRouter | Sentinel-2 Imagery")
-    print("Type 'quit' or 'exit' to end the session")
-    print("Type 'reset' to start a new conversation")
-    print("=" * 60)
-
-    try:
-        agent = GeoMindAgent(model=model)
-    except ValueError as e:
-        print(f"\nError: {e}")
-        sys.exit(1)
-    except Exception as e:
-        print(f"\nError: {e}")
-        print("\nPlease check your API key and internet connection.")
-        sys.exit(1)
-
-    while True:
-        try:
-            user_input = input("\nYou: ").strip()
-
-            if not user_input:
-                continue
-
-            if user_input.lower() in ["quit", "exit", "q"]:
-                print("\nGoodbye!")
-                break
-
-            if user_input.lower() == "reset":
-                agent.reset()
-                continue
-
-            agent.chat(user_input)
-
-        except KeyboardInterrupt:
-            print("\n\nGoodbye!")
-            break
-        except Exception as e:
-            print(f"\nError: {e}")
-
-
-if __name__ == "__main__":
-    main()