Cursor like AI-agent for Google Earth Engine right in your browser as a Chrome extension. It helps you do anything related to Google Earth Engine automatically through chatting. Hatched from sundai.club.
- Chat interface for Earth Engine assistance
- Knows Earth Engine Data Catalog as well as community dataset
- Help you write code, and run the code
- Help debug the code
- Help you explian the map
- Planning and reasoning
- Environment management tools (reset map/console, clear code)
- Comprehensive agent testing framework with automated testing capabilities
- Visit the Earth Agent page on the Chrome Web Store.
- Click "Add to Chrome".
- The extension will be added to your browser and will appear in your Chrome toolbar.
- Go to the Releases page
- Download the latest
earth-agent-extension.zip - Extract the zip file to a folder on your computer
- Open Chrome and navigate to
chrome://extensions/ - Enable "Developer mode" (toggle in the top right)
- Click "Load unpacked" and select the extracted folder
- The extension will appear in your Chrome toolbar
- Clone the repository
- Install dependencies with
npm install - Build the extension with
npm run build - Load the unpacked extension from the
distdirectory in Chrome
After installation, you'll need to configure your AI provider:
- Click the Earth Agent extension icon in Chrome
- Go to Settings
- Choose your AI provider:
- OpenAI: Add your OpenAI API key (supports GPT-4o, GPT-4.1, GPT-o3, etc.)
- Anthropic: Add your Anthropic API key (supports Claude models)
- Google: Add your Google API key (supports Gemini models)
- Qwen: Add your DashScope API key (supports Qwen models)
- Ollama: Configure local Ollama server (requires local installation)
- Select your preferred model
- Start chatting with Earth Engine!
For Ollama local models:
- Install Ollama on your machine
- Pull your desired models:
ollama pull gemma3orollama pull llama3 - Important: Start Ollama with CORS enabled:
OLLAMA_ORIGINS="*" ollama serve - In the extension settings, select "Ollama" as provider
- Enter your model name (e.g., "gemma3:1b", "llama3:latest")
- Tool Support: Not all models support tools - check Ollama model search for models with "tools" tag for full Earth Engine integration
The agent includes powerful environment management capabilities:
- Reset Map/Inspector/Console: Ask the agent to "reset the map" or "clear the console" to clean up your Google Earth Engine workspace
- Clear Script: Request "clear the code" or "start fresh" to remove all code from the Earth Engine editor
- Natural Language Control: Simply describe what you want to clean up, and the agent will handle it automatically
These tools help maintain a clean workspace during development and are particularly useful when switching between different Earth Engine tasks.
The extension provides powerful Earth Engine integration tools, but tool support varies by AI provider and model:
- ✅ Full Tool Support: OpenAI GPT models, Anthropic Claude models, Google Gemini models, Qwen models
⚠️ Variable Tool Support: Ollama models - tool support depends on the specific model- Tool-Compatible Ollama Models: Check Ollama model search for models with "tools" tag
- Examples with tools:
qwen3,llama3.1,mistral,codellama,firefunction-v2 - Basic Chat Only: Models without tool support can still provide Earth Engine guidance and code suggestions
- 📖 Documentation: For other providers, refer to their respective documentation for tool/function calling capabilities
Tip: For the best Earth Engine integration experience with automated code execution, use tool-compatible models from any provider.
- Open Google Earth Engine Code Editor in a Chrome tab: https://code.earthengine.google.com/
- Click the Earth Agent extension icon in your Chrome toolbar
- Start chatting! The agent can see your Earth Engine environment and help with any GEE-related tasks
The Earth Agent works as your intelligent assistant for Google Earth Engine development:
- Ask questions about Earth Engine concepts, datasets, or code
- Request code generation for specific Earth Engine tasks
- Get help debugging existing code in your editor
- Analyze and explain maps, data, and results
- Manage your workspace with automatic cleanup tools
"Help me create a simple map showing NDVI for California using Landsat data"
"Show me how to filter satellite imagery by date and cloud cover"
"What datasets are available for precipitation data?"
"Create a time series chart of vegetation indices for a specific location"
"Find and display the latest Sentinel-2 image over New York City with less than 10% cloud cover"
"Calculate NDVI for cropland areas in Iowa and create a visualization"
"Compare deforestation between 2010 and 2020 in the Amazon rainforest"
"Detect urban expansion using night lights data over the past 5 years"
"Create a reducer to calculate mean temperature by administrative boundaries"
"Help me export this image to Google Drive with specific projection and scale"
"Set up a batch processing workflow for multiple images"
"Calculate zonal statistics for land use categories within protected areas"
"Add a legend to this map showing the color scale for elevation data"
"Create an interactive map with multiple layers that users can toggle"
"Style this land cover classification with appropriate colors"
"Add geometry drawing tools and export the drawn polygons"
"This code is running slowly, can you optimize it?"
"I'm getting a memory error, help me fix this computation"
"Explain what this error message means and how to fix it"
"Check my code for best practices and suggest improvements"
"Clear my console and reset the map view"
"Remove all code from the editor so I can start fresh"
"Reset my workspace to a clean state"
"Take a screenshot of my current results"
The Earth Agent includes powerful tools that enable it to interact directly with your Google Earth Engine environment:
- Insert Code: Automatically write code directly into your GEE Code Editor
- Execute Code: Run the code in your editor and monitor execution
- Code Analysis: Analyze existing code and suggest improvements
- Error Debugging: Identify and fix errors in your Earth Engine scripts
- Dataset Search: Find relevant Earth Engine datasets based on your needs
- Dataset Documentation: Get detailed information about specific datasets
- Data Catalog Access: Browse and explore the complete Earth Engine Data Catalog
- Community Datasets: Access community-contributed datasets and collections
- Map Inspection: Analyze what's currently displayed on your map
- Layer Management: Add, remove, and modify map layers
- Visualization Parameters: Automatically configure visualization settings
- Legend Creation: Generate appropriate legends for your data
- Reset Map/Inspector/Console: Clean up your workspace with a single command
- Clear Script: Remove all code from the editor to start fresh
- Screenshot Capture: Take snapshots of your work for documentation
- Console Monitoring: Check console output and error messages
- Element Clicking: Click buttons, links, and interface elements
- Text Input: Fill forms and input fields automatically
- Page Navigation: Navigate through web interfaces
- Element Inspection: Analyze web page structure and content
- Screenshot Capture: Take full-page or selective screenshots
- Element Detection: Find and identify specific page elements
- Content Extraction: Extract text and data from web pages
- Accessibility Analysis: Generate accessibility reports for web content
- Current Weather: Get real-time weather information for any location
- Weather Data: Access meteorological data for analysis
- Climate Information: Historical and current climate data
- Context7 Integration: Access comprehensive Earth Engine documentation
- API Reference: Get detailed API documentation and examples
- Best Practices: Learn recommended approaches and patterns
- Code Examples: Access curated code examples and tutorials
- Plan and Execute: Break down complex tasks into manageable steps
- Error Recovery: Automatically retry and fix failed operations
- Progress Tracking: Monitor long-running processes and operations
- Adaptive Learning: Adjust approach based on results and feedback
- Custom Scripts: Generate Earth Engine scripts for specific tasks
- Function Creation: Create reusable functions and modules
- Workflow Automation: Build complete analysis pipelines
- Batch Processing: Set up automated processing for multiple datasets
- Data Interpretation: Explain results and findings from your analysis
- Trend Detection: Identify patterns and trends in your data
- Anomaly Detection: Find unusual patterns or outliers
- Comparative Analysis: Compare different datasets or time periods
OpenAI, Anthropic, Google, Qwen: All tools and functions available
- Complete Earth Engine integration
- Full browser automation
- Advanced multi-step workflows
- Error recovery and debugging
Ollama: Tool availability depends on the specific model
- With Tools: Models tagged with "tools" on Ollama search
- Examples:
qwen3,llama3.1,mistral,codellama,firefunction-v2 - Full Earth Engine integration available
- Complete browser automation support
- Examples:
- Chat Only: Models without tool support
- Provides expert guidance and code suggestions
- Can explain concepts and help with debugging
- Limited to conversational assistance (no direct code execution)
- Use tool-compatible models when you need automated code execution
- Be specific in your requests for better results
- Ask for explanations to learn Earth Engine concepts
- Use workspace management tools to keep your environment clean
- Take screenshots to document your work and results
- Exploratory Analysis: Ask questions → Get code → Run and iterate
- Data Processing: Define requirements → Generate pipeline → Execute and export
- Visualization: Create map → Style layers → Add legends → Capture results
- Debugging: Describe problem → Analyze code → Apply fixes → Test solution
The extension includes a comprehensive testing framework for evaluating AI agent performance:
- Multi-Provider Support: Test with OpenAI GPT models, Anthropic Claude models, Google Gemini, Qwen models, or Ollama local models
- Batch Testing: Run multiple prompts automatically with configurable intervals
- Environment Controls: Configure reset and clear functions, including optional GEE editor reload
- Results Analysis: Export detailed test results with screenshots and metadata
- Screenshot Storage: Multiple storage options (local, downloads folder, Google Drive)
- Tool Compatibility: Automatically adapts testing based on model tool support capabilities
Access the testing panel by clicking the flask icon (🧪) in the main chat interface.
Example: Creating a Complete Deforestation Analysis
"I want to analyze deforestation in the Brazilian Amazon from 2000 to 2023.
Please create a complete workflow that:
1. Loads appropriate satellite imagery
2. Calculates forest loss over time
3. Creates visualizations showing the changes
4. Generates statistics by state/region
5. Exports the results for further analysis"
Example: Agricultural Monitoring Pipeline
"Set up an agricultural monitoring system for corn fields in Iowa that:
- Uses Sentinel-2 and Landsat data
- Calculates NDVI, EVI, and SAVI indices
- Creates time series analysis for growing seasons
- Identifies areas of crop stress
- Generates automated reports with charts and maps"
Example: Climate Change Analysis
"Help me create a climate change impact study that:
1. Uses ERA5 temperature and precipitation data
2. Calculates 30-year climate normals
3. Identifies significant trends and anomalies
4. Creates publication-ready visualizations
5. Exports data in formats suitable for statistical analysis"
Example: Urban Heat Island Study
"Design an urban heat island analysis for major cities that:
- Uses Landsat thermal bands and MODIS LST
- Compares urban vs rural temperatures
- Analyzes the relationship with land cover
- Creates before/after comparisons over 20 years
- Generates interactive maps for public outreach"
Example: Batch Processing Multiple Regions
"I have a list of 50 protected areas. Please create a batch processing workflow that:
1. Processes each area separately
2. Calculates vegetation indices for each season
3. Detects any significant changes or disturbances
4. Creates standardized reports for each area
5. Compiles results into a summary dashboard"
- Refresh the Earth Engine tab and try again
- Check your API keys in the extension settings
- Verify internet connection for cloud-based providers
- For Ollama: Ensure it's running with
OLLAMA_ORIGINS="*" ollama serve
- Check model compatibility: Ensure your selected model supports tools
- For Ollama: Use models with "tools" tag from Ollama search
- Try a different provider: Switch to OpenAI, Anthropic, Google, or Qwen for guaranteed tool support
- Use more specific prompts to reduce processing time
- Break complex tasks into smaller steps
- Check Earth Engine quotas if operations fail
- For local models: Ensure sufficient system resources
- Ask the agent to debug: "This code has an error, please fix it"
- Check console output: "What errors are showing in the console?"
- Reset workspace: "Clear everything and start fresh"
- Verify API keys are correctly entered
- Check provider status (OpenAI, Anthropic, Google, Qwen status pages)
- For Ollama: Confirm local server is accessible at
http://localhost:11434
- Use the agent itself: Ask "How do I..." or "Help me troubleshoot..."
- Check the console: Look for error messages in browser developer tools
- Try different models: Some models may work better for specific tasks
- Reset your workspace: Use environment management tools to start fresh
- API Keys: Stored securely in Chrome extension storage, never shared
- Chat History: Kept locally in your browser, not sent to external servers
- Code and Data: Only shared with your selected AI provider during active conversations
- Screenshots: Stored locally or in your chosen location (Downloads, Google Drive)
- Keep API keys secure: Don't share your extension settings or API keys
- Review generated code: Always review code before running important analyses
- Use appropriate models: Choose models based on your data sensitivity requirements
- Regular updates: Keep the extension updated for latest security features
For developers who want to create releases:
# Create and push a version tag
git tag v1.0.0
git push origin v1.0.0
# GitHub Actions will automatically:
# - Build the extension
# - Run tests
# - Create a release with installation filesYou need nodejs and npm,
- Clone the repository
- Install dependencies with
npm install - Build the extension with
npm run build - Load the unpacked extension from the
distdirectory in Chrome - Create branches and make changes
- Build the project and refresh the chrome extension to see updates
- push changes if all works good
The extension handles Cross-Origin Resource Sharing (CORS) issues by proxying API requests through the background script. This setup works because:
- Chrome extension background scripts have permission to make cross-origin requests if the URL is included in the
host_permissionsinmanifest.json - Content scripts and the sidepanel are subject to CORS restrictions
- The tools are designed to automatically detect the current environment and:
- Make direct API calls when running in the background script or Node.js
- Proxy requests via the background script when running in a content script or sidepanel
If you encounter CORS issues:
- Check that
https://context7.com/*is included in thehost_permissionsinmanifest.json - Verify that the background script is properly handling the message types
- Check the background script console for detailed error messages
MIT
- Sundai Club
- React
- Vercel AI SDK