How geponce/geo-embeddings-agents works
geo-embeddings turns Earth Engine satellite embeddings and Cropland Data Layer labels into validated land-cover results, similarity search, and change insights on Databricks. The main workflow samples and labels pixels, trains and spatially validates a classifier, builds a county-wide embedding grid, then supports vector search and H3 change rollups. A Claude agent team exposes these results through read-only tools and checks claims against validation evidence. Edges use README workflow statements or source-index references; several implementation details were not excerpted, so their links are omitted where evidence is insufficient.
Main entry points: agent_tools.py Read-only tools · build_grid.py County grid builder · sampling.py Labeled sampling · build_samples.py Sample builder
Components 24
Earth Engine ingest
- EE authentication
src/geo_embeddings/ee_auth.py - Embedding access
src/geo_embeddings/embeddings.py - CDL class mapping
src/geo_embeddings/classes.py - Labeled sampling
src/geo_embeddings/sampling.py - Sample builder
src/geo_embeddings/build_samples.py - County grid builder
src/geo_embeddings/build_grid.py
Model and validation
- Random Forest
src/geo_embeddings/train_baseline.py - Spatial blocks
src/geo_embeddings/spatial.py - Cross-validation
src/geo_embeddings/validation.py - MLflow tracking
src/geo_embeddings/tracking.py
Search and change
- Embedding change
src/geo_embeddings/change.py - Change analysis
src/geo_embeddings/change_analysis.py - Vector Search
src/geo_embeddings/search.py - H3 rollup
src/geo_embeddings/h3_map.py - SQL access
src/geo_embeddings/dbsql.py
Agent interface
- Read-only tools
src/geo_embeddings/agent_tools.py - SQL guard
src/geo_embeddings/sql_guard.py - Planner and specialists
agents/team.py - Agent CLI
agents/run.py
Other components
- Analyst
- Earth Engine
- Databricks
- Claude API
- Delta tables
Connections 35
- Analyst → Sample builder: build samples
README.md - Sample builder → Labeled sampling: samples with
src/geo_embeddings/build_samples.py - Labeled sampling → Embedding access: reads vectors
src/geo_embeddings/sampling.py - Labeled sampling → CDL class mapping: groups labels
src/geo_embeddings/sampling.py - Sample builder → EE authentication: initializes
src/geo_embeddings/build_samples.py - EE authentication → Earth Engine: authenticates
src/geo_embeddings/ee_auth.py - Labeled sampling → Earth Engine: samples data
README.md - Analyst → County grid builder: build grid
README.md - County grid builder → Embedding access: uses vectors
src/geo_embeddings/build_grid.py - County grid builder → Labeled sampling: uses sampling
src/geo_embeddings/build_grid.py - County grid builder → EE authentication: initializes
src/geo_embeddings/build_grid.py - Sample builder → Delta tables: loads samples
README.md - County grid builder → Delta tables: loads grid
README.md - Analyst → Random Forest: train model
README.md - Random Forest → Cross-validation: evaluates folds
src/geo_embeddings/train_baseline.py - Cross-validation → Spatial blocks: builds blocks
src/geo_embeddings/validation.py - Random Forest → MLflow tracking: logs runs
src/geo_embeddings/train_baseline.py - Random Forest → Delta tables: reads samples
README.md - Analyst → Change analysis: analyze change
README.md - Change analysis → Embedding change: computes score
src/geo_embeddings/change_analysis.py - Analyst → Vector Search: find similar places
README.md - Vector Search → Delta tables: indexes grid
README.md - Analyst → H3 rollup: roll up change
README.md - H3 rollup → SQL access: queries tables
src/geo_embeddings/h3_map.py - SQL access → Databricks: runs statements
README.md - Analyst → Agent CLI: asks question
README.md - Agent CLI → Planner and specialists: starts team
agents/run.py - Planner and specialists → Read-only tools: dispatches tools
agents/team.py - Planner and specialists → Claude API: delegates reasoning
README.md - Read-only tools → SQL guard: guards SQL
src/geo_embeddings/agent_tools.py - Read-only tools → SQL access: runs queries
src/geo_embeddings/agent_tools.py - Read-only tools → Vector Search: queries index
src/geo_embeddings/agent_tools.py - Read-only tools → Embedding access: reads embeddings
src/geo_embeddings/agent_tools.py - Read-only tools → EE authentication: initializes EE
src/geo_embeddings/agent_tools.py - Planner and specialists → Delta tables: reads results
README.md