Repo LLM Apps

koala73/worldmonitor

Open-source real-time global intelligence dashboard with AI news briefs, dual 3D/flat maps, a Country Instability Index, and web, desktop, CLI, SDK and MCP access.

  • 88.1k GitHub stars
  • TypeScript
  • ⚖️ AGPL-3.0
  • 🎯 Intermediate
View on GitHub (opens in a new tab) Setup guide
koala73/worldmonitor preview image

What it is

World Monitor is a TypeScript-based real-time global intelligence dashboard that combines curated news feeds (AI-synthesized into briefs), geopolitical monitoring, and infrastructure tracking in one situational awareness interface. It offers a 3D globe and WebGL flat map, a Country Instability Index for 31 Tier-1 countries, and a finance radar. It ships as multiple site variants (world, tech, finance, commodity, happy, energy) and a Tauri 2 desktop app from a single codebase, and exposes an MCP server, REST API, CLI and SDKs.

Who it's for

  • Developers who want to run or self-host a situational awareness dashboard
  • Analysts tracking geopolitical, economic, energy, and infrastructure signals
  • Teams building agents or scripts that need programmatic access via MCP, REST, CLI, or SDKs
  • Users who want to run the AI features locally with Ollama and no API keys

Requirements

Requirements

  • Node.js and npm (the Quick Start uses git clone, npm install and npm run dev)
  • Optional credentials for feature-specific data sources (see .env.example)
  • API key for MCP tools/call and CLI use (obtainable at worldmonitor.app/pro)

Setup

  1. Clone, install and run locally

    Clone the repo, install dependencies and start the dev server, then open localhost:3000. The app runs with no environment variables; override the port with DEV_PORT in .env.local.

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

  2. Run a site variant

    Use the variant-specific dev scripts to develop a particular variant.

    bash
    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

  3. Install the CLI

    Run the official npm package ad-hoc or install it globally; the command is worldmonitor (alias wm).

    sh
    npx worldmonitor tools          # run ad-hoc — list every MCP tool (no key needed)
npm install -g worldmonitor     # or install the `worldmonitor` (alias `wm`) command

Examples

List every MCP tool without a key

sh
sh
npx worldmonitor tools

What it does: Runs the CLI ad-hoc to list all MCP tools; the README states no key is needed.

Query country risk with the CLI

sh
sh
worldmonitor risk IR --api-key wm_xxx

What it does: Calls the installed CLI with an API key to get risk data for a country code (IR), as shown in the README.

Type check and production build

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

What it does: Contributor commands from the README for validating types and producing a production build.

Pros & cons

Pros

  • Pro:Single codebase ships several variants (world, tech, finance, commodity, happy, energy) plus a Tauri 2 desktop app for macOS, Windows, and Linux
  • Pro:Runs locally with no environment variables, and AI can run fully locally via Ollama with no API keys
  • Pro:Programmatic access through an MCP server, REST API with OpenAPI spec, npm CLI, and Python, Ruby, and Go SDKs
  • Pro:Stated maintenance status: public deployments and desktop binaries are marked Stable

Cons

  • Con:AGPL-3.0-only license brings copyleft and source-availability obligations; proprietary private-source use or official branding needs separate permission
  • Con:Some feature-specific data sources may require credentials, and MCP tools/call needs an API key or OAuth
  • Con:Deployment details (Vercel, Docker, static) are not in the README and live in the external self-hosting guide

Images

koala73/worldmonitor preview image
koala73/worldmonitor preview image · koala73/worldmonitor on GitHub · AGPL-3.0
koala73/worldmonitor preview image