Volver a proyectos
Activo

GEO_COPILOT: Copiloto Geoespacial con IA Multiagente

Sistema multiagente geoespacial con IA que democratiza el análisis espacial. Pregunta en lenguaje natural, obtén análisis PostGIS, mapas 3D y visualizaciones automáticas.

PythonLangGraphPostGISCesiumFastAPIReactA2AHITL
Ver en GitHub

Descripción

GEO_COPILOT es tu copiloto geoespacial inteligente: un ecosistema de 4 agentes especializados orquestados con LangGraph que transforman preguntas en lenguaje natural en análisis espaciales completos. Descubre datos relevantes, genera SQL PostGIS seguro, aplica simbología cartográfica inteligente y crea visualizaciones (mapas 3D con Cesium, gráficos, tablas). Con validación humana (HITL), soporte multi-LLM (OpenAI, Azure, Anthropic) y WebSocket para actualizaciones en tiempo real. Todo open-source, todo documentado, todo listo para democratizar el análisis geoespacial.

Características

  • 🤖 4 Agentes Especializados: DataAgent (descubrimiento), GISAgent (SQL PostGIS), SymbologyAgent (simbología), InsightsAgent (visualizaciones)
  • 🔄 Orquestación LangGraph A2A: flujo de agentes inteligente con coordinación automática
  • 🔍 Descubrimiento Dinámico: detecta tablas y columnas de PostGIS automáticamente
  • ✋ HITL (Human-in-the-Loop): validación humana para operaciones sensibles
  • 🧠 Multi-LLM: soporte para OpenAI, Azure OpenAI y Anthropic
  • 🗺️ Mapas 3D Interactivos: visualización con CesiumJS de resultados espaciales
  • 📊 Gráficos y Tablas: Recharts para visualizaciones estadísticas dinámicas
  • ⚡ WebSocket en Tiempo Real: actualizaciones instantáneas vía FastAPI
  • 🎯 Frontend React + Vite: UI moderna con Zustand y Tailwind CSS
  • ✅ 69 Tests Pasando: cobertura del 63% con pytest

Stack Tecnológico

Backend: FastAPI 0.109+, LangGraph 0.0.20+, asyncpg, Pydantic 2.5+Frontend: React 18.2, Vite 5.0, Cesium.js 1.114, Recharts 2.10, Zustand 4.4, Tailwind CSS 3.4Datos: PostgreSQL 15 + PostGIS 3.3, Redis 7 (cache)LLMs: OpenAI, Azure OpenAI, Anthropic (multi-provider)Testing: pytest, 69 tests pasando, 63% coverageDevOps: Docker Compose, Python 3.11+Geo: GeoPandas, Shapely, GDAL/OGR

Desafíos

  • • 🎯 Diseñar flujos A2A que coordinen 4 agentes especializados de forma eficiente
  • • ⚡ Generar SQL PostGIS correcto, seguro y optimizado desde lenguaje natural
  • • 🔒 Implementar validación HITL sin sacrificar UX en operaciones críticas
  • • 🗺️ Renderizar geometrías complejas en 3D con Cesium sin lag
  • • 💰 Optimizar costos de LLMs con caché inteligente y selección de modelo
  • • 📊 Seleccionar simbología cartográfica automática según tipo de dato y contexto

Lecciones Aprendidas

  • • 🏗️ Arquitectura multi-agente escalable con LangGraph y patrón A2A
  • • 🧠 Integración efectiva de LLMs con bases de datos espaciales (PostGIS)
  • • 🛡️ Diseño de sistemas HITL que balancean seguridad y experiencia de usuario
  • • ⚛️ Stack moderno React + FastAPI + WebSocket para apps geoespaciales en tiempo real
  • • 🧪 Testing robusto para sistemas de IA: 69 tests, 63% coverage, CI/CD
  • • 📚 Documentación técnica completa: 8+ docs detallados (arquitectura, API, visualizaciones)

¿Te interesa colaborar en este proyecto?

Únete a la comunidad