World Monitor

简体中文 | 日本語 | Русский

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

         

       

     

Documentation  ·  Releases  ·  Contributing

Ways to Use It

Surface	Get it	Docs
Web app	worldmonitor.app and the tech, finance, commodity, happy and energy variants	Getting Started
Desktop app (Tauri)	Windows, macOS and Linux downloads above	Desktop App
Terminal dashboard	npx worldmonitor	Terminal Dashboard
CLI	npm install -g worldmonitor	Command-Line Client
SDKs	Python worldmonitor-sdk, Ruby worldmonitor, Go sdk/go	SDKs
MCP server	https://worldmonitor.app/mcp	MCP Overview

The terminal dashboard runs the same live data in your shell: world map, news, markets, conflict, military flights, cyber, climate, prediction markets and live TV, with mouse support and colour themes. No API key needed.

---

What It Does

• Curated news feeds across global and regional categories, AI-synthesized into briefs
• Dual map engine — 3D globe (globe.gl) and WebGL flat map (deck.gl) with a shared map-layer catalog
• Panel inventory — concrete panel implementations across specialized variants
• Cross-stream correlation — military, economic, disaster, and escalation signal convergence
• Country Instability Index (CII) — live CII v14 scores, bands, and approximate 24-hour movement for 31 Tier-1 countries
• Finance radar — stock exchanges, commodities, crypto, and a market composite
• Local AI — run everything with Ollama, no API keys required
• Site variants from a single codebase (world, tech, finance, commodity, happy, energy)
• Native desktop app (Tauri 2) for macOS, Windows, and Linux
• Multilingual UI with native-language feeds and RTL support

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

---

Support Status

All site variants and desktop binaries are built from a single codebase and ship from the same release process. The table below clarifies maintenance status so you know which surfaces are safe to depend on.

Surface	Status	Notes
worldmonitor.app, tech., finance., commodity., happy., energy.	Stable	Public deployments built from this repo, actively maintained
Desktop binaries (Windows / macOS Apple Silicon / macOS Intel / Linux AppImage)	Stable	One Tauri binary for every variant — install World Monitor and switch to tech, finance, commodity, energy, or happy in-app. There is deliberately no per-variant download
worldmonitor npm package (terminal dashboard and CLI)	Stable	Published from cli/ on every cli-v* tag

Issues filed against any of the above are triaged from the same backlog — see the issues board for currently-open work.

---

Quick Start

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

Open localhost:3000 (override the port with DEV_PORT in .env.local). The app runs with no environment variables.

Feature-specific data sources may require credentials. See .env.example for the full list.

For variant-specific development:

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
npm run dev:energy     # energy.worldmonitor.app

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

---

Tech Stack

Category	Technologies
Frontend	Vanilla TypeScript, Vite, globe.gl + Three.js, deck.gl + MapLibre GL
Desktop	Tauri 2 (Rust) with Node.js sidecar
AI/ML	Ollama / OpenRouter, Transformers.js (browser-side)
API Contracts	Protocol Buffers and sebuf HTTP annotations
Deployment	Vercel Edge Functions, Railway relay, Tauri, PWA
Caching	Redis (Upstash), 3-tier cache, CDN, service worker

Full stack details in the architecture docs.

---

Programmatic Access

World Monitor is built for agents and scripts as well as browsers:

• MCP server — https://worldmonitor.app/mcp (Streamable HTTP). Public tools/list; tools/call authenticates with a X-WorldMonitor-Key header or OAuth. The server also publishes its Agent Skills through the draft io.modelcontextprotocol/skills extension (skills/list, skills/get, and skill://… resource reads).

• REST API — base https://api.worldmonitor.app, described by the OpenAPI spec.

• CLI — the official worldmonitor npm package (source in cli/). Run it with no arguments in a terminal for the terminal dashboard:

  npx worldmonitor tools          # run ad-hoc — list every MCP tool (no key needed)
  npm ins