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.
Incrivel! O software que todo menino sonha em ter, com ele, parece que você é o dono do mundo.