1. Project Overview
WorldMonitor is a real-time global intelligence dashboard that aggregates news, geopolitical, financial, and infrastructure data from 65+ external providers and synthesizes them with AI into a single situational-awareness interface, so users no longer need to monitor dozens of disparate sources to track global events.
2. Background & Positioning
WorldMonitor was created to solve a specific problem: global events โ conflicts, market shocks, natural disasters, infrastructure disruptions โ are scattered across hundreds of news feeds, exchange tickers, and specialist trackers, making it hard for any single person to build a coherent picture of what's happening worldwide. The project consolidates these fragmented signals into curated feeds, interactive maps, and AI-generated briefs, turning raw data into actionable insight.
Compared to typical news aggregators or single-purpose dashboards (e.g., a flight tracker or a stock ticker), WorldMonitor differentiates itself by combining multiple intelligence domains โ geopolitics, finance, energy, aviation, and security โ into one unified platform, offering both a rich visual interface (3D globe, WebGL maps) and full programmatic access (API, MCP server, CLI, SDKs) for developers who want to build on top of the data.
3. Feature Categories
๐ฐ News Aggregation
500+ curated feeds across 15 categories, synthesized into AI-generated briefs.
- Global breaking news aggregation
- Category-based filtering (geopolitics, business, technology, etc.)
- AI-summarized daily/hourly briefs
- Source freshness monitoring across 35 source groups
- Purpose: replace manual scanning of dozens of news sites with a single curated stream.
๐ Mapping & Visualization
56 map layer types rendered across two mapping systems.
- Interactive 3D globe (globe.gl, Three.js)
- WebGL flat map (deck.gl, MapLibre GL)
- Layered overlays for conflicts, infrastructure, and weather
- Real-time event pins and clustering
- Purpose: give users a spatial, visual understanding of where global events are unfolding.
๐ Finance Radar
Coverage spanning 29 stock exchanges plus commodities and crypto.
- Live exchange indices tracking
- Commodity price monitoring
- Cryptocurrency market data
- Cross-market correlation views
- Purpose: connect macro/geopolitical events to real-time market movements.
๐ Security & Risk
Country Instability Index (CII) v8 stress scoring for 31 Tier-1 nations.
- Composite risk scoring methodology
- Historical trend tracking per country
- Multi-factor stress indicators
- Purpose: quantify geopolitical risk for research, analysis, and decision-making.
โก Energy Tracking
Dedicated monitoring of global energy markets and infrastructure signals, feeding into the broader risk and finance views.
๐ฐ๏ธ Aviation Intelligence
Flight data powered by a Wingbits partnership for ADS-B tracking.
- Live flight position tracking
- Notable/military flight highlighting
- Airspace disruption alerts
- Purpose: surface aviation activity relevant to global events in near real time.
๐ Multi-Language Support
25 languages including full right-to-left (RTL) text support, making the dashboard accessible to a genuinely global audience.
4. Key Highlights
- Local AI, no API keys required โ Ollama integration lets users run AI summarization entirely on their own machine, avoiding cloud AI costs and key management.
- Six site variants from one codebase โ
worldmonitor.app, plus themed deployments for tech, finance, commodity, happy, and energy news, all built from a shared foundation. - Native desktop apps โ Tauri 2 (Rust backend + Node.js sidecar) powers macOS, Windows, and Linux desktop clients alongside the web and PWA experience.
- Full programmatic access โ a public MCP server, REST API, official CLI, and zero-dependency SDKs for Python, Ruby, and Go make the data usable well beyond the web UI.
- Protocol Buffers-based API layer โ 288 protos across 35 services provide a strongly typed, efficient data contract for integrators.
- 75k+ GitHub stars and #1 GitHub Trending (June 2026) โ reflects strong community adoption and active development.
5. Use Cases by Role
General developers โ Use the REST API, CLI, or SDKs to pull curated news, risk, or market data into your own applications without building a scraping/aggregation pipeline from scratch.
Data/research scientists โ Leverage the Country Instability Index and historical trend data as a structured dataset for geopolitical or economic research.
Security/risk analysts โ Monitor the Security & Risk and Aviation Intelligence categories for early signals on instability, conflict, or infrastructure disruption.
Project managers / decision-makers โ Use the unified dashboard and AI-generated briefs to get a fast, cross-domain situational overview without manually cross-referencing multiple sources.
6. Getting Started
Find what you need โ Browse the live dashboard and category feeds at worldmonitor.app, or explore themed variants like tech.worldmonitor.app and finance.worldmonitor.app.
Install / integrate
git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor
npm install
npm run dev
Runs locally at localhost:3000; no environment variables are required to start, with optional API keys configurable in .env.local. For API/SDK integration, install the CLI via npm install -g worldmonitor or the SDKs via pip install worldmonitor-sdk (Python) / gem install worldmonitor (Ruby).
Contribute โ Read CONTRIBUTING.md and open a pull request against the main repository.
7. Project Structure
worldmonitor/
โโโ src/ # Main frontend application (TypeScript, Vite)
โโโ api/ # Backend services and REST API
โโโ cli/ # Command-line interface package
โโโ sdk/ # Language-specific SDKs (Python, Ruby, Go)
โโโ server/ # Server-side logic and relay services
โโโ docker/ # Container configurations for self-hosting
โโโ docs/ # Project documentation
src/contains the core dashboard UI, including globe/map rendering and news feed components.api/implements the Protocol Buffers-based service layer consumed by the frontend, CLI, and SDKs.sdk/hosts the officially maintained client libraries for third-party integration.
8. Related Ecosystem
- Ollama โ powers optional local, key-free AI summarization.
- Groq / OpenRouter โ optional cloud AI providers for faster or more capable summarization.
- Wingbits โ flight-data partner behind the Aviation Intelligence feature.
- Vercel Edge Functions / Railway โ deployment infrastructure for the hosted service.
- Tauri 2 โ powers the native desktop applications.
9. License
- โ Personal, research, and educational use
- โ Self-hosting your own instance
- โ Forking and modifying the code, provided source changes are shared under AGPL-3.0
- โ Commercial use and SaaS deployment, as long as AGPL-3.0 obligations (source disclosure) are met
- โ Closed-source/proprietary deployments without releasing source code
- โ Use of the WorldMonitor trademark without permission
- โน๏ธ A separate commercial license is available for organizations that need proprietary, closed-source deployment terms โ contact the maintainers via the repository.
10. FAQ
Q: Do I need API keys to run WorldMonitor locally?
A: No. The default local setup works with npm install && npm run dev and no environment variables; optional API keys for enhanced features can be added to .env.local.
Q: Can I use WorldMonitor's AI features without sending data to the cloud?
A: Yes. The project integrates with Ollama for fully local AI summarization, so no external API key is required.
Q: How do I access the data programmatically instead of using the web dashboard?
A: Use the REST API at https://api.worldmonitor.app, the MCP server at https://worldmonitor.app/mcp, the official worldmonitor CLI, or the Python/Ruby/Go SDKs.
Q: Can I deploy WorldMonitor as a closed-source commercial product?
A: Not under the default AGPL-3.0 license, which requires sharing source code for network-accessible deployments. A separate commercial license is available for proprietary use โ see the License section.
Q: What languages does the dashboard support?
A: 25 languages, including full right-to-left (RTL) layout support.
11. Quick Links
- Repository: github.com/koala73/worldmonitor
- Documentation: worldmonitor.app/docs/documentation
- Getting Started / Self-Hosting Guide: worldmonitor.app/docs/getting-started
- SDK Guide: worldmonitor.app/docs/sdks
- Contributing Guide: CONTRIBUTING.md
- Discussions: GitHub Discussions
12. Summary
WorldMonitor turns a fragmented landscape of news, market, and risk data into a single, AI-assisted intelligence dashboard, with full programmatic access via API, MCP, CLI, and SDKs for developers who want to build on top of it. It is well suited for developers, researchers, and analysts who need a fast, unified view of global events โ whether through the visual dashboard, local self-hosted deployment, or direct data integration โ backed by an actively developed, community-adopted open-source project.