World Monitor
简体中文 | 日本語 | Русский
Real-time global intelligence dashboard — AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface.
Ways to Use It
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 x64 and ARM64) | 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
One-line install (self-host the full stack with Docker — dashboard, Redis, AIS relay, seeded public data):
curl -fsSL https://www.worldmonitor.app/install.sh | bash
This clones into ./worldmonitor (or reuses your checkout), generates the required secrets, starts the stack, and seeds data. Then open localhost:3000. Options: --dir, --port, --no-seed, --no-build, passed after bash -s -- (see scripts/install.sh --help). API keys are optional. Details, production notes, and uninstall: SELF_HOSTING.md.
Local development (hot-reload Vite server):
Requires Node.js 24, the version pinned in .nvmrc. Distribution packages are often older. Debian 12 and Raspberry Pi OS ship Node.js 18 with npm 9.2.0, where npm install stops with Invalid comparator: file:vendor/braces. Install Node.js 24 with nvm (nvm install inside the checkout reads .nvmrc) or from nodejs.org.
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:
This is the beginning of the README. Read the rest at the original. Read the full README ↗
