Sobre o projeto

## O que é World Monitor é um dashboard de inteligência global em tempo real que combina agregação de notícias via IA, monitoramento geopolítico e rastreamento de infraestrutura em uma única interface de consciência situacional. É construído a partir de um único código-fonte que disponibiliza várias variantes de site: world, tech, finance, commodity, happy e energy. ## Recursos documentados - Feeds de notícias curados em categorias globais e regionais, sintetizados por IA em resumos. - Um motor de mapa duplo: um globo 3D construído com globe.gl e um mapa plano WebGL construído com deck.gl, compartilhando um catálogo de camadas de mapa. - Um inventário de painéis com implementações concretas de painéis nas variantes especializadas. - Correlação de fluxos cruzados de sinais militares, econômicos, de desastres e de escalada. - Country Instability Index (CII): pontuações CII v8 ao vivo, faixas e movimentação aproximada de 24 horas para 31 países de Nível 1. - Radar financeiro cobrindo bolsas de valores, commodities, cripto e um composto de mercado. - Operação de IA local via Ollama, sem necessidade de chaves de API; também lista Groq e OpenRouter, além de Transformers.js no lado do navegador. - Um aplicativo desktop nativo (Tauri 2) para macOS (Apple Silicon e Intel), Windows e Linux AppImage. Um único binário cobre todas as variantes, alternáveis no aplicativo. - Uma interface multilíngue com feeds em idiomas nativos e suporte a RTL. ## Execução O início rápido documentado consiste em clonar o repositório, executar `npm install` e `npm run dev`, e então abrir localhost:3000 (porta substituível via `DEV_PORT`). O aplicativo supostamente funciona sem variáveis de ambiente, embora fontes de dados específicas de recursos possam precisar de credenciais listadas em `.env.example`. Existem scripts de desenvolvimento específicos para variantes (`dev:tech`, `dev:finance`, `dev:commodity`, `dev:happy`, `dev:energy`). As opções de auto-hospedagem mencionadas incluem Vercel, Docker e implantação estática. ## Acesso programático Além da interface do navegador, o projeto documenta: - Um servidor MCP em `https://worldmonitor.app/mcp` (HTTP Streamable), com `tools/list` público e `tools/call` autenticado, além de Agent Skills publicados através de uma extensão de skills MCP em rascunho. - Uma API REST em `https://api.worldmonitor.app` descrita por uma especificação OpenAPI. - Uma CLI npm oficial `worldmonitor` executável ad hoc via `npx` ou instalada globalmente como `worldmonitor` / `wm`. - SDKs oficiais sem dependências para Python (`worldmonitor-sdk`), Ruby e Go. Arquivos de descoberta de agentes, como `llms.txt`, um manifesto de agent-skills e um catálogo de API também são publicados. ## Notas da stack tecnológica O README lista TypeScript puro e Vite para o frontend; Tauri 2 (Rust) com um sidecar Node.js para desktop; Ollama, Groq, OpenRouter e Transformers.js para IA; Protocol Buffers e anotações HTTP sebuf para contratos de API; Vercel Edge Functions, um relay Railway, Tauri e PWA para implantação; e Redis (Upstash) com cache de três níveis, CDN e service worker para cache. ## Fontes de dados e atribuição Os dados são agregados de provedores upstream atribuídos em geopolítica, finanças, energia, clima, aviação, cyber, militar, infraestrutura e inteligência de notícias. Os dados de voo são creditados à Wingbits. Um catálogo de fontes de dados documenta o provedor, o nível do feed, a postura da licença e o método de coleta. ## Licenciamento e status do projeto O código-fonte é AGPL-3.0-only; o uso pessoal, de pesquisa, educacional, auto-hospedado e comercial é descrito como permitido quando as obrigações de copyleft AGPL e de disponibilidade de código-fonte são cumpridas, com permissão comercial ou de branding separada para uso proprietário de código privado. Implantações públicas e binários de desktop são listados como estáveis e mantidos a partir do mesmo backlog. O projeto é de autoria de Elie Habib e aceita contribuições de acordo com seu guia CONTRIBUTING.