Back to Worldmonitor

World Monitor

README.md

2.5.237.6 KB
Original Source

World Monitor

Real-time global intelligence dashboard — AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface.

<p align="center"> <a href="https://worldmonitor.app"></a>&nbsp; <a href="https://tech.worldmonitor.app"></a>&nbsp; <a href="https://finance.worldmonitor.app"></a>&nbsp; <a href="https://commodity.worldmonitor.app"></a>&nbsp; <a href="https://happy.worldmonitor.app"></a> </p> <p align="center"> <a href="https://worldmonitor.app/api/download?platform=windows-exe"></a>&nbsp; <a href="https://worldmonitor.app/api/download?platform=macos-arm64"></a>&nbsp; <a href="https://worldmonitor.app/api/download?platform=macos-x64"></a>&nbsp; <a href="https://worldmonitor.app/api/download?platform=linux-appimage"></a> </p> <p align="center"> <a href="https://docs.worldmonitor.app"><strong>Documentation</strong></a> &nbsp;·&nbsp; <a href="https://github.com/koala73/worldmonitor/releases/latest"><strong>Releases</strong></a> &nbsp;·&nbsp; <a href="https://docs.worldmonitor.app/contributing"><strong>Contributing</strong></a> </p>


What It Does

  • 435+ curated news feeds across 15 categories, AI-synthesized into briefs
  • Dual map engine — 3D globe (globe.gl) and WebGL flat map (deck.gl) with 45 data layers
  • Cross-stream correlation — military, economic, disaster, and escalation signal convergence
  • Country Intelligence Index — composite risk scoring across 12 signal categories
  • Finance radar — 92 stock exchanges, commodities, crypto, and 7-signal market composite
  • Local AI — run everything with Ollama, no API keys required
  • 5 site variants from a single codebase (world, tech, finance, commodity, happy)
  • Native desktop app (Tauri 2) for macOS, Windows, and Linux
  • 21 languages with native-language feeds and RTL support

For the full feature list, architecture, data sources, and algorithms, see the documentation.


Quick Start

bash
git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor
npm install
npm run dev

Open localhost:5173. No environment variables required for basic operation.

For variant-specific development:

bash
npm run dev:tech       # tech.worldmonitor.app
npm run dev:finance    # finance.worldmonitor.app
npm run dev:commodity  # commodity.worldmonitor.app
npm run dev:happy      # happy.worldmonitor.app

See the self-hosting guide for deployment options (Vercel, Docker, static).


Tech Stack

CategoryTechnologies
FrontendVanilla TypeScript, Vite, globe.gl + Three.js, deck.gl + MapLibre GL
DesktopTauri 2 (Rust) with Node.js sidecar
AI/MLOllama / Groq / OpenRouter, Transformers.js (browser-side)
API ContractsProtocol Buffers (92 protos, 22 services), sebuf HTTP annotations
DeploymentVercel Edge Functions (60+), Railway relay, Tauri, PWA
CachingRedis (Upstash), 3-tier cache, CDN, service worker

Full stack details in the architecture docs.


Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

bash
npm run typecheck        # Type checking
npm run build:full       # Production build

License

AGPL-3.0 for non-commercial use. Commercial license required for any commercial use.

Use CaseAllowed?
Personal / research / educationalYes
Self-hosted (non-commercial)Yes, with attribution
Fork and modify (non-commercial)Yes, share source under AGPL-3.0
Commercial use / SaaS / rebrandingRequires commercial license

See LICENSE for full terms. For commercial licensing, contact the maintainer.

Copyright (C) 2024-2026 Elie Habib. All rights reserved.


Author

Elie HabibGitHub

Contributors

<a href="https://github.com/koala73/worldmonitor/graphs/contributors"> </a>

Security Acknowledgments

We thank the following researchers for responsibly disclosing security issues:

  • Cody Richard — Disclosed three security findings covering IPC command exposure, renderer-to-sidecar trust boundary analysis, and fetch patch credential injection architecture (2026)

See our Security Policy for responsible disclosure guidelines.


<p align="center"> <a href="https://worldmonitor.app">worldmonitor.app</a> &nbsp;·&nbsp; <a href="https://docs.worldmonitor.app">docs.worldmonitor.app</a> &nbsp;·&nbsp; <a href="https://finance.worldmonitor.app">finance.worldmonitor.app</a> &nbsp;·&nbsp; <a href="https://commodity.worldmonitor.app">commodity.worldmonitor.app</a> </p>

Star History

<a href="https://api.star-history.com/svg?repos=koala73/worldmonitor&type=Date"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=koala73/worldmonitor&type=Date&type=Date&theme=dark" /> </picture> </a>