koala73/worldmonitor

What it is

World Monitor aggregates news feeds, geopolitical events, financial markets, commodity and energy data, flight tracking, cyber and climate signals into one situational-awareness interface. It shows a 3D globe or a WebGL flat map, customizable panels, and a Country Instability Index with live scores for 31 Tier-1 countries. Briefs can be synthesized by AI, and the same data is available through web, desktop, terminal, CLI, REST API, MCP server and Python/Ruby/Go SDKs. It is aimed at analysts, developers and anyone who wants a single live view of world events rather than many separate feeds.

Quick start

For local development, Node.js 24 is required (pinned in .nvmrc); older distributions such as Debian 12 ship Node.js 18 and fail during install.

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

Open http://localhost:3000; the port can be overridden with DEV_PORT in .env.local. The app starts without environment variables, but feature-specific data sources may need credentials listed in .env.example. Variants can be started with npm run dev:tech, dev:finance, dev:commodity, dev:happy or dev:energy.

To try it without building, use the hosted web app or run npx worldmonitor for the terminal dashboard, which needs no API key. Desktop builds are distributed for Windows, macOS and Linux; the project's releases page and desktop documentation are the places to check before running an installer.

Programmatic access and self-hosting

The MCP server at https://worldmonitor.app/mcp exposes public tools/list; tools/call requires an X-WorldMonitor-Key header or OAuth. A REST API is documented by an OpenAPI spec, and the worldmonitor npm package provides a CLI and terminal dashboard. A self-hosting guide covers Vercel, Docker and static deployment options. Since the project is AGPL-3.0-only, self-hosted forks and SaaS deployments must comply with its copyleft and source-availability requirements; proprietary use or official branding requires separate permission.

Constraints

• The frontend is built with Vanilla TypeScript and Vite, with globe.gl/Three.js and deck.gl/MapLibre GL for maps; the desktop client uses Tauri 2.
• Desktop installers are compiled binaries; the README gives no checksums or signing details. Prefer the hosted web app or npm CLI if you need to inspect the code before running anything.
• API keys and third-party data providers may be needed for full functionality; without them, parts of the dashboard rely on public data and local AI via Ollama.

HotRepo's take

The project has appeared on HotRepo's all-language daily list with hundreds to thousands of stars gained in a day during June and July 2026, then 110 stars on the TypeScript daily list for 2026-11-02, where it ranked 7th. It has no recorded best all-language daily rank, so those snapshots show activity but not a top overall position. Hacker News discussion is sparse: the most visible thread from February 2026 drew a reply questioning whether AI-generated dashboards are becoming interchangeable, while noting this project looks more complex. The breadth of surfaces — multiple variants, SDKs, MCP, terminal — gives developers concrete ways to try it beyond the browser.