Summary

GeoAgent provides a unified AI agent layer for geospatial Python packages, map widgets, and QGIS plugins. It enables diverse geospatial libraries to expose tools to LLMs via a consistent interface, eliminating redundant agent stack development. This empowers users with advanced AI-driven geospatial analysis and interactive visualization.

How It Works

Built on Strands Agents, GeoAgent injects geospatial context, structured tool metadata, and safety features. Its core innovation is confirmation hooks, pausing execution before destructive or expensive operations. The framework supports multimodal inputs (images, screenshots) for vision-capable LLMs, enhancing interactive workflows.

Quick Start & Requirements

Install via pip install GeoAgent, with optional extras for providers (e.g., GeoAgent[openai]) or integrations (e.g., GeoAgent[leafmap], GeoAgent[qgis]). Provider configuration uses environment variables (e.g., OPENAI_API_KEY). QGIS integration requires installation within the QGIS Python environment. Documentation: https://geoagent.gishub.org. Repository: https://github.com/opengeos/GeoAgent.

Highlighted Details

• Unified Tool Exposure: Integrates tools from leafmap, anymap, geoai, geemap, STAC, and NASA Earthdata for LLM access.
• Broad LLM Compatibility: Supports OpenAI, Anthropic, Gemini, Bedrock, LiteLLM, Ollama, and ChatGPT/Codex OAuth.
• Multimodal Input: Accepts image attachments for vision-enabled models.
• Safety & Control: Implements confirmation hooks for sensitive operations; offers fast=True mode for reduced tool surface and latency.
• Deep Integrations: Dedicated factories (for_leafmap, for_qgis, etc.) bind to live objects.
• QGIS Plugin: OpenGeoAgent QGIS plugin provides a dockable AI assistant with image capture and PyQGIS script generation.

Maintenance & Community

The README does not detail specific contributors or community channels. Key links include documentation (https://geoagent.gishub.org), the GitHub repository (https://github.com/opengeos/GeoAgent), and the issue tracker.

Licensing & Compatibility

GeoAgent is released under the permissive MIT License, generally allowing commercial use and integration within closed-source projects.

Limitations & Caveats

Natural-language interaction for NASA OPERA data is disabled within QGIS, requiring direct tool calls. Confirmation-gated operations (e.g., loading layers) require explicit approval callbacks or testing configurations.