Skip to main content
Get World Monitor up and running in minutes. Choose your preferred platform and follow the steps below.

​
Choose Your Path

Web App

Access instantly via browser with PWA support

Desktop App

Native app for macOS, Windows, and Linux

​
Web App

The fastest way to start using World Monitor is through the web application.
1

Visit the live dashboard

Open your browser and navigate to one of the live variants:
2

Install as PWA (optional)

For offline access and a native app experience:Chrome/Edge: Click the install icon in the address bar (⊕ or computer icon)Safari: Tap Share → Add to Home ScreenFirefox: Click the three dots → Install
3

Explore the dashboard

Start exploring:
  • Pan and zoom the 3D globe
  • Toggle data layers in the left panel
  • Browse live news feeds
  • Watch live video streams
The web app works immediately with public data sources. Configure API keys in Settings for additional data sources.

​
Desktop App

For the full experience with local AI, offline maps, and OS integration, install the native desktop application.
1

Download the installer

Choose your platform:
Apple Silicon (M1/M2/M3):
curl -L "https://worldmonitor.app/api/download?platform=macos-arm64" -o WorldMonitor.dmg
Intel:
curl -L "https://worldmonitor.app/api/download?platform=macos-x64" -o WorldMonitor.dmg
Open the .dmg and drag World Monitor to Applications.
2

First launch

On first launch, the desktop app will:
  1. Start a local Node.js sidecar server (port auto-selected)
  2. Generate a session token for secure local communication
  3. Load the dashboard with cloud fallback for missing API handlers
The sidecar runs 60+ API endpoints locally for privacy and offline access.
3

Configure settings (optional)

Open Settings (Cmd+, on macOS, Ctrl+, on Windows/Linux) to configure:LLMs Tab:
  • Ollama endpoint (default: http://localhost:11434)
  • Model selection (auto-discovered from local instance)
  • Cloud AI providers (Groq, OpenRouter)
API Keys Tab:
  • Add API keys for data sources
  • Each key is validated on save
  • Stored securely in OS keychain (macOS Keychain, Windows Credential Manager)
Debug & Logs Tab:
  • Enable verbose logging
  • View traffic log (last 200 requests)
  • Access log files
See API Keys Configuration for the complete list of supported services.
4

Start exploring

You’re ready! Try these first actions:
  • View the World Brief: Click the AI Flow badge → “Generate World Brief”
  • Explore a country: Click any country on the map for a full intelligence dossier
  • Monitor keywords: Add custom keywords in News Feed panels
  • Toggle layers: Enable military bases, undersea cables, or conflicts
  • Watch live streams: Open the Live Streams panel for real-time video

​
First Actions

Once you’re up and running, here are some recommended first steps:
  1. Click the Intelligence Findings badge (top right)
  2. Click “Generate World Brief”
  3. If using Ollama locally, the brief will be generated on your machine
  4. Otherwise, it uses cloud AI (Groq → OpenRouter → Browser T5 fallback)
The brief provides a synthesized summary of top global developments from all active news feeds.
  1. Click any country on the map
  2. View the Country Instability Index (CII) score ring
  3. Read the AI-generated intelligence analysis
  4. Check active signals (protests, military, markets, etc.)
  5. Review the 7-day event timeline
  6. Export as JSON, CSV, or PNG
  1. Enable the Live Streams panel
  2. Default channels load automatically (Bloomberg, Sky News, Al Jazeera, etc.)
  3. Expand the channel library for 30+ additional sources
  4. Adjust global quality setting (Settings → auto/360p/480p/720p)
  5. Switch to the Webcams tab for 22 live feeds from geopolitical hotspots
  1. Open any News Feed panel
  2. Click the + Add Monitor button
  3. Enter keywords (comma-separated for multiple terms)
  4. Keywords are highlighted with automatic color coding
  5. Match counts update in real-time
  1. Open a country brief (click any country)
  2. Click Share
  3. Choose platform (Twitter, LinkedIn, WhatsApp, Telegram, Reddit, Facebook)
  4. Platform-specific formatting is applied automatically
  5. Or export as JSON/CSV/PNG for offline analysis

​
Switching Variants

World Monitor has 4 variants, each with specialized features and data sources:
  • World Monitor (worldmonitor.app) - Geopolitical, military, conflicts
  • Tech Monitor (tech.worldmonitor.app) - Tech industry, AI, startups
  • Finance Monitor (finance.worldmonitor.app) - Markets, trading, central banks
  • Happy Monitor (happy.worldmonitor.app) - Positive news, progress tracking
You can switch between variants:
  • Web: Navigate to different URLs or click the variant switcher in the header
  • Desktop: Download variant-specific installers (e.g., ?platform=macos-arm64&variant=tech)
See the Variants Guide for detailed differences.

​
What’s Next?

Configure API Keys

Add API keys for additional data sources

Set Up Local LLM

Install Ollama for private AI inference

Explore Features

Learn about the 3D globe and data layers

User Guide

Complete guide to using the dashboard

​
Troubleshooting

macOS: If you see “World Monitor is damaged and can’t be opened”:
  • Open Terminal
  • Run: xattr -cr /Applications/World\ Monitor.app
  • This removes the quarantine attribute
Windows: If SmartScreen blocks the installer:
  • Click “More info”
  • Click “Run anyway”
  • Or download the MSI installer instead
Linux: If AppImage won’t execute:
  • Run: chmod +x WorldMonitor.AppImage
  • Install FUSE: sudo apt install fuse (Ubuntu/Debian)
  • Check your internet connection
  • Clear browser cache (web app)
  • Restart the desktop app
  • Verify MapTiler API is accessible (no corporate firewall blocking)
  • Verify Ollama is running: ollama list
  • Check the endpoint URL matches: http://localhost:11434 (default)
  • Ensure at least one model is installed: ollama pull llama3.1:8b
  • Restart the World Monitor desktop app
  • Check Settings → LLMs → Model dropdown populates
  • Some feeds may be temporarily unavailable (circuit breaker active)
  • Check the Data Freshness panel for source status
  • Verify internet connection
  • If self-hosting, check CORS proxy is running
For detailed installation instructions, see the Installation Guide.

Build docs developers (and LLMs) love

Get started for freeTalk to us