Repolode
Enviar
Oldcircle

Oldcircle/geo-sleuth

Una skill de agente que estima dónde se tomó una foto mediante geometría de OpenStreetMap, perfiles de elevación del horizonte, imágenes satelitales y vistas de calle, y explica su razonamiento.

Ver en GitHub
Estrellas
6,253
Forks
777
Issues abiertos
20
Último commit
anteayer

¿Qué es?

geo-sleuth es una skill de geolocalización de fotos para agentes de programación con IA. A partir de una foto, el agente ejecuta varios scripts de Python que leen los datos EXIF y el texto visible, buscan ubicaciones candidatas en OpenStreetMap y comparan la línea de crestas de la foto con perfiles del horizonte basados en la elevación, calculados para cada candidata. Las teselas satelitales y las imágenes de vista de calle se clasifican mediante CLIP, DINOv2 y coincidencias con SIFT; el resultado incluye una posición de cámara con un radio de error, una orientación y una imagen de evidencia.

La skill está pensada para fotos sin puntos de referencia evidentes, como escenas donde solo aparecen puentes, líneas eléctricas, montañas o árboles junto a la calle. Sus scripts clasifican las candidatas y el modelo solo elige entre las mejores. Toda conclusión debe remitir a un comando que se haya ejecutado y al archivo que haya generado. El repositorio incluye benchmarks y nuevas ejecuciones a ciegas para dos fotos de prueba.

Se instala como una Agent Skill estándar: una carpeta con SKILL.md y scripts. Funciona con Claude Code, Codex, Cursor, Gemini CLI, OpenCode y GitHub Copilot. Requiere Python 3.10 o posterior, uv y una instalación de Chrome o Chromium para Playwright para la búsqueda inversa de imágenes.

Funciones clave

  • 01Analiza elementos de OpenStreetMap, como puentes ferroviarios y líneas eléctricas, para generar ubicaciones candidatas.
  • 02Compara las líneas de crestas de la foto con perfiles del horizonte basados en la elevación y calcula pequeños ángulos de inclinación de la cámara.
  • 03Estima las sombras y la dirección del sol para inferir la orientación y la franja de latitud.
  • 04Clasifica teselas satelitales e imágenes de vista de calle mediante CLIP, DINOv2 y coincidencias con SIFT.
  • 05Devuelve las coordenadas de la cámara con un radio de error, una orientación y una imagen de evidencia.
  • 06Se ejecuta como una Agent Skill estándar en seis agentes de programación importantes.

Casos de uso

  • Ubicar una foto sin datos GPS ni letreros legibles para investigaciones OSINT.
  • Practicar habilidades de geolocalización con acertijos al estilo GeoGuessr y un razonamiento transparente.
  • Comprobar dónde se tomó una foto de un paisaje o de infraestructura, con permiso para analizarla.
  • Estudiar cómo se pueden combinar el terreno, las imágenes satelitales y los datos cartográficos para geolocalizar imágenes.

Inicio rápido

  1. 1

    Instala la skill con npx y elige tus agentes

    npx skills add Oldcircle/geo-sleuth
  2. 2

    La primera vez, haz que el agente ejecute doctor.py desde la carpeta scripts de la skill y corrija las comprobaciones que fallen

  3. 3

    Dale una foto a tu agente y pídele que encuentre dónde se tomó

Antes de usarlo

  • Requiere Python 3.10 o posterior y una comprobación de configuración en el primer uso.
  • La ejecución completa puede ser lenta; un caso documentado tardó unos 72 minutos de principio a fin.

En colecciones

Herramientas, skills y plugins para Claude CodeFrameworks y apps de agentes de IA open sourceAsistentes y agentes de programación con IABibliotecas de skills para agentes de IABibliotecas y herramientas de visión artificial

Temas

#ai-agents#agent-skills#geolocation#osint#computer-vision#openstreetmap#satellite-imagery#claude-code#codex#cursor

Preguntas frecuentes

¿Qué es geo-sleuth?
Una skill de agente que estima dónde se tomó una foto mediante geometría de OpenStreetMap, perfiles de elevación del horizonte, imágenes satelitales y vistas de calle, y explica su razonamiento. geo-sleuth es una skill de geolocalización de fotos para agentes de programación con IA. A partir de una foto, el agente ejecuta varios scripts de Python que leen los datos EXIF y el texto visible, buscan ubicaciones candidatas en OpenStreetMap y comparan la línea de crestas de la foto con perfiles del horizonte basados en la elevación, calculados para cada candidata. Las teselas satelitales y las imágenes de vista de calle se clasifican mediante CLIP, DINOv2 y coincidencias con SIFT; el resultado incluye una posición de cámara con un radio de error, una orientación y una imagen de evidencia.
¿geo-sleuth es gratuito? ¿Qué licencia tiene?
geo-sleuth es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿geo-sleuth sigue mantenido?
Mantenimiento activo. El último commit de geo-sleuth fue el 5 nov 2026.
¿Para qué puedo usar geo-sleuth?
Ubicar una foto sin datos GPS ni letreros legibles para investigaciones OSINT. Practicar habilidades de geolocalización con acertijos al estilo GeoGuessr y un razonamiento transparente. Comprobar dónde se tomó una foto de un paisaje o de infraestructura, con permiso para analizarla. Estudiar cómo se pueden combinar el terreno, las imágenes satelitales y los datos cartográficos para geolocalizar imágenes.
¿Cómo se instala geo-sleuth?
Instala la skill con npx y elige tus agentes: npx skills add Oldcircle/geo-sleuth La primera vez, haz que el agente ejecute doctor.py desde la carpeta scripts de la skill y corrija las comprobaciones que fallen Dale una foto a tu agente y pídele que encuentre dónde se tomó
¿Dónde consigo geo-sleuth?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Oldcircle/geo-sleuth

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados