How mhkh22/geo-sleuth works
geo-sleuth is an agent skill for geolocating a photo and producing an evidence-backed camera position, heading, confidence, and satellite image. The agent reads the skill instructions and runs focused Python commands: inspect the image and clues, search candidate regions and sites, compare terrain or street-view imagery, refine the camera pose, and document the result. Scripts rank candidates while the agent judges them. The README describes this workflow and major capabilities; source-index references support the cited internal links, but unsampled script behavior is not assumed.
Main entry points: _image.py Image utilities · geo.py Geo calculations · _net.py Network utilities · match.py Image matching
Components 26
Agent workflow
- Skill instructions
skills/geo-sleuth/SKILL.md - Candidate board
skills/geo-sleuth/scripts/board.py
Photo clues
- Photo intake
skills/geo-sleuth/scripts/intake.py - EXIF clues
skills/geo-sleuth/scripts/exif.py - Text recognition
skills/geo-sleuth/scripts/ocr.py - Clue lookup
skills/geo-sleuth/scripts/clues.py
Geographic search
- Region packs
skills/geo-sleuth/scripts/regions.py - OSM search
skills/geo-sleuth/scripts/osm.py - Gazetteer search
skills/geo-sleuth/scripts/gazetteer.py - POI search
skills/geo-sleuth/scripts/poi.py - Terrain scan
skills/geo-sleuth/scripts/terrain.py - Data refresh
skills/geo-sleuth/scripts/refresh.py
Candidate verification
- Image matching
skills/geo-sleuth/scripts/match.py - Google Street View
skills/geo-sleuth/scripts/gsv.py - Baidu panoramas
skills/geo-sleuth/scripts/baidu_pano.py - Satellite scan
skills/geo-sleuth/scripts/sat_scan.py - Camera pose
skills/geo-sleuth/scripts/pose.py - Sun geometry
skills/geo-sleuth/scripts/sun.py - Evidence output
skills/geo-sleuth/scripts/evidence.py - Satellite tiles
skills/geo-sleuth/scripts/tiles.py
Shared services
- Geo calculations
skills/geo-sleuth/scripts/geo.py - Image utilities
skills/geo-sleuth/scripts/_image.py - Network utilities
skills/geo-sleuth/scripts/_net.py - Browser helper
skills/geo-sleuth/scripts/_browser.py - Device helper
skills/geo-sleuth/scripts/_device.py
Other components
- Geolocation agent
Connections 39
- Geolocation agent → Skill instructions: reads instructions
README.md - Geolocation agent → Photo intake: runs scripts
README.md - Geolocation agent → EXIF clues: runs scripts
README.md - Geolocation agent → Candidate board: records candidates
README.md - Geolocation agent → Terrain scan: scans terrain
README.md - Geolocation agent → Image matching: ranks images
README.md - Geolocation agent → Camera pose: refines position
README.md - Geolocation agent → Evidence output: produces evidence
README.md - Photo intake → Image utilities: reads images
skills/geo-sleuth/scripts/intake.py - EXIF clues → Image utilities: reads images
skills/geo-sleuth/scripts/exif.py - Text recognition → Image utilities: reads images
skills/geo-sleuth/scripts/ocr.py - Clue lookup → Region packs: uses region data
skills/geo-sleuth/scripts/clues.py - OSM search → Region packs: uses region data
skills/geo-sleuth/scripts/osm.py - Gazetteer search → Region packs: uses region data
skills/geo-sleuth/scripts/gazetteer.py - POI search → Region packs: uses region data
skills/geo-sleuth/scripts/poi.py - Candidate board → Region packs: resolves regions
skills/geo-sleuth/scripts/board.py - Terrain scan → Geo calculations: uses calculations
skills/geo-sleuth/scripts/terrain.py - Terrain scan → Image utilities: uses image tools
skills/geo-sleuth/scripts/terrain.py - Image matching → Image utilities: reads images
skills/geo-sleuth/scripts/match.py - Image matching → Google Street View: renders candidates
skills/geo-sleuth/scripts/match.py - Image matching → Baidu panoramas: renders candidates
skills/geo-sleuth/scripts/match.py - Google Street View → Baidu panoramas: uses China service
skills/geo-sleuth/scripts/gsv.py - Google Street View → Geo calculations: converts coordinates
skills/geo-sleuth/scripts/gsv.py - Baidu panoramas → Geo calculations: converts coordinates
skills/geo-sleuth/scripts/baidu_pano.py - OSM search → Network utilities: fetches map data
skills/geo-sleuth/scripts/osm.py - Terrain scan → Network utilities: fetches elevation
skills/geo-sleuth/scripts/terrain.py - Satellite tiles → Network utilities: fetches tiles
skills/geo-sleuth/scripts/tiles.py - Satellite tiles → Geo calculations: converts coordinates
skills/geo-sleuth/scripts/tiles.py - Sun geometry → Satellite tiles: uses tile data
skills/geo-sleuth/scripts/sun.py - Evidence output → Image utilities: uses image tools
skills/geo-sleuth/scripts/evidence.py - Evidence output → Satellite tiles: uses satellite maps
skills/geo-sleuth/scripts/evidence.py - Evidence output → Geo calculations: uses calculations
skills/geo-sleuth/scripts/evidence.py - Satellite scan → Satellite tiles: uses satellite tiles
skills/geo-sleuth/scripts/sat_scan.py - Satellite scan → Geo calculations: uses calculations
skills/geo-sleuth/scripts/sat_scan.py - Camera pose → Image utilities: reads images
skills/geo-sleuth/scripts/pose.py - Baidu panoramas → Network utilities: fetches panoramas
skills/geo-sleuth/scripts/baidu_pano.py - Browser helper → Network utilities: uses network helper
skills/geo-sleuth/scripts/_browser.py - Data refresh → Network utilities: fetches sources
skills/geo-sleuth/scripts/refresh.py - Image matching → Device helper: selects compute
skills/geo-sleuth/scripts/match.py