Sobre el proyecto

## Qué es World Monitor es un tablero de inteligencia global en tiempo real que combina la agregación de noticias impulsada por IA, el monitoreo geopolítico y el seguimiento de infraestructura en una interfaz de conciencia situacional. Está construido a partir de un único código base que distribuye varias variantes de sitio: world, tech, finance, commodity, happy y energy. ## Capacidades documentadas - Feeds de noticias curados en categorías globales y regionales, sintetizados por IA en resúmenes. - Un motor de mapas dual: un globo 3D construido con globe.gl y un mapa plano WebGL construido con deck.gl, que comparten un catálogo de capas de mapa. - Un inventario de paneles con implementaciones concretas de paneles a través de las variantes especializadas. - Correlación de flujos cruzados de señales militares, económicas, de desastres y de escalada. - Índice de Inestabilidad de Países (CII): puntuaciones CII v8 en vivo, bandas y movimiento aproximado de 24 horas para 31 países de Nivel 1. - Radar financiero que cubre bolsas de valores, materias primas, criptomonedas y un compuesto de mercado. - Operación de IA local a través de Ollama, sin necesidad de claves API; también enumera Groq y OpenRouter, además de Transformers.js en el lado del navegador. - Una aplicación de escritorio nativa (Tauri 2) para macOS (Apple Silicon e Intel), Windows y Linux AppImage. Un solo binario cubre cada variante, intercambiable dentro de la aplicación. - Una interfaz de usuario multilingüe con feeds en idioma nativo y soporte RTL. ## Ejecución El inicio rápido documentado consiste en clonar el repositorio, ejecutar `npm install` y `npm run dev`, y luego abrir localhost:3000 (puerto modificable con `DEV_PORT`). Se informa que la aplicación se ejecuta sin variables de entorno, aunque las fuentes de datos específicas de funciones pueden requerir credenciales enumeradas en `.env.example`. Existen scripts de desarrollo específicos para cada variante (`dev:tech`, `dev:finance`, `dev:commodity`, `dev:happy`, `dev:energy`). Las opciones de auto-alojamiento mencionadas incluyen Vercel, Docker y despliegue estático. ## Acceso programático Más allá de la interfaz del navegador, el proyecto documenta: - Un servidor MCP en `https://worldmonitor.app/mcp` (HTTP transmitible), con `tools/list` público y `tools/call` autenticado, además de Agent Skills publicados a través de una extensión de habilidades MCP en borrador. - Una API REST en `https://api.worldmonitor.app` descrita por una especificación OpenAPI. - Una CLI de npm oficial `worldmonitor` ejecutable ad hoc vía `npx` o instalada globalmente como `worldmonitor` / `wm`. - SDKs oficiales sin dependencias para Python (`worldmonitor-sdk`), Ruby y Go. También se publican archivos de descubrimiento de agentes como `llms.txt`, un manifiesto de agent-skills y un catálogo de API. ## Notas sobre el stack tecnológico El README enumera TypeScript vanilla y Vite para el frontend; Tauri 2 (Rust) con un sidecar de Node.js para escritorio; Ollama, Groq, OpenRouter y Transformers.js para IA; Protocol Buffers y anotaciones HTTP de sebuf para contratos de API; Vercel Edge Functions, un relay de Railway, Tauri y PWA para el despliegue; y Redis (Upstash) con un caché de tres niveles, CDN y service worker para el almacenamiento en caché. ## Fuentes de datos y atribución Los datos se agregan de proveedores ascendentes atribuidos en geopolítica, finanzas, energía, clima, aviación, ciberseguridad, militar, infraestructura e inteligencia de noticias. Los datos de vuelo se atribuyen a Wingbits. Un catálogo de fuentes de datos documenta el proveedor, el nivel del feed, la postura de la licencia y el método de recolección. ## Licencia y estado del proyecto El código fuente es AGPL-3.0-only; el uso personal, de investigación, educativo, auto-alojado y comercial se describe como permitido cuando se cumplen las obligaciones de copyleft de AGPL y disponibilidad de código fuente, con permisos comerciales o de marca separados para el uso propietario de fuente privada. Los despliegues públicos y los binarios de escritorio se listan como estables y mantenidos desde el mismo backlog. El proyecto fue creado por Elie Habib y acepta contribuciones de acuerdo con su guía CONTRIBUTING.