koala73/worldmonitor

站内导读

中文 World Monitor 是实时全球情报仪表盘，把 AI 新闻聚合、地缘政治监测与基础设施追踪放进同一个态势感知界面。它解决多源信息分散、难以同时掌握的问题，提供 Web、桌面（Tauri）、终端仪表盘、CLI、Python/Ruby/Go SDK 与 MCP server 等多种接入方式，另有科技、金融、大宗商品、能源等专题版本。适合关注国际局势的分析师、研究者与开发者。

README · 详细文档

来源 · 查看原文

World Monitor

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

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

0 1 2 3 4 5 6

<a href="https://www.worldmonitor.app/docs/documentation">Documentation</a>  ·  <a href="https://github.com/koala73/worldmonitor/releases/latest">Releases</a>  ·  <a href="https://www.worldmonitor.app/docs/contributing">Contributing</a>

World Monitor Dashboard

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 or brew install 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.

World Monitor terminal dashboard

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 0 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 install -g worldmonitor     # or install the `worldmonitor` (alias `wm`) command
  brew install worldmonitor       # or install it with Homebrew
  worldmonitor risk IR --api-key wm_xxx

SDKs — official zero-dependency client libraries mirroring the CLI: Python 0 (source in sdk/python/), Ruby 2 (sdk/ruby/), Go 4 (sdk/go/). Guide: worldmonitor.app/docs/sdks.

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

Flight Data

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

Data Sources

WorldMonitor aggregates attributed upstream sources across geopolitics, finance, energy, climate, aviation, cyber, military, infrastructure, and news intelligence. Curated feeds and freshness-tracked source groups are published in the full data sources catalog, with provider, feed-tier, license-posture, and collection-method details.

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

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

License

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.

Author

Elie Habib — GitHub

Contributors

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.

<a href="https://www.worldmonitor.app">worldmonitor.app</a>  ·  <a href="https://www.worldmonitor.app/docs/documentation">docs.worldmonitor.app</a>  ·  <a href="https://finance.worldmonitor.app">finance.worldmonitor.app</a>  ·  <a href="https://commodity.worldmonitor.app">commodity.worldmonitor.app</a>

Star History