raw/worldmonitor.md

Raw capture — raw/worldmonitor.md

url: https://github.com/koala73/worldmonitor date_fetched: 2026-07-05 backfilled: true

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

Documentation · Releases · Contributing

500+ curated news feedsacross 15 categories, AI-synthesized into briefs
Dual map engine— 3D globe (globe.gl) and WebGL flat map (deck.gl) with 56 map layer types
Cross-stream correlation— military, economic, disaster, and escalation signal convergence
Country Instability Index (CII)— server-authoritative CII v8 stress scoring for 31 Tier-1 countries
Finance radar— 29 stock exchanges, commodities, crypto, and 7-signal market composite
Local AI— run everything with Ollama, no API keys required
6 site variantsfrom a single codebase (world, tech, finance, commodity, happy, energy)
Native desktop app(Tauri 2) for macOS, Windows, and Linux
25 languageswith native-language feeds and RTL support

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

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 that switches variants in-app; current CI release targets are `full`and`tech`

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

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).

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 / Groq / OpenRouter, Transformers.js (browser-side)
API Contracts	Protocol Buffers (278 protos, 35 services), sebuf HTTP annotations
Deployment	Vercel Edge Functions (60+), Railway relay, Tauri, PWA
Caching	Redis (Upstash), 3-tier cache, CDN, service worker

Full stack details in the architecture docs.

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

MCP server—https://worldmonitor.app/mcp(Streamable HTTP). Publictools/list;tools/callauthenticates with aX-WorldMonitor-Keyheader or OAuth.
REST API— basehttps://api.worldmonitor.app, described by the OpenAPI spec.
CLI— the officialworldmonitornpm package (source incli/):npx worldmonitor tools # run ad-hoc — list every MCP tool (no key needed) npm install -g worldmonitor # or install the worldmonitor (alias wm) command worldmonitor risk IR --api-key wm_xxx
SDKs— official zero-dependency client libraries mirroring the CLI: Pythonworldmonitor-sdk(source insdk/python/), Rubyworldmonitor(sdk/ruby/), Gogithub.com/koala73/worldmonitor/sdk/go(sdk/go/). Guide: worldmonitor.app/docs/sdks.

Agent discovery files: llms.txt · agent-skills manifest · api-catalog. Get an API key at worldmonitor.app/pro.

Flight data provided graciously by Wingbits, the most advanced ADS-B flight data solution.

WorldMonitor aggregates 65+ external providers and APIs across geopolitics, finance, energy, climate, aviation, cyber, military, infrastructure, and news intelligence — surfaced through 500+ curated feeds and tracked by a freshness monitor covering 35 source groups. See the full data sources catalog for providers, feed tiers, and collection methods.

Contributions welcome! See CONTRIBUTING.md for guidelines.

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

AGPL-3.0-only for the source code. Commercial use is permitted under the AGPL when you comply with its copyleft and source-availability terms.

Use Case	Allowed?
Personal / research / educational	Yes, under AGPL-3.0-only
Self-hosted instance	Yes, under AGPL-3.0-only
Fork and modify	Yes, share source under AGPL-3.0-only when required
Commercial use / SaaS	Yes, under AGPL-3.0-only when you comply with AGPL obligations
Private-source proprietary use or official branding rights	Separate commercial or trademark permission needed

See LICENSE for the full code license and docs/license.mdx for a plain-language summary. Commercial licensing is available as an alternative option for teams that need non-AGPL terms.

Elie Habib — GitHub

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.

worldmonitor.app · docs.worldmonitor.app · finance.worldmonitor.app · commodity.worldmonitor.app