World Monitor

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

       

     

Documentation  ·  Releases  ·  Contributing

---

What It Does

• 500+ curated news feeds across 15 categories, AI-synthesized into briefs
• Dual map engine — 3D globe (globe.gl) and WebGL flat map (deck.gl) with 45 data layers
• Cross-stream correlation — military, economic, disaster, and escalation signal convergence
• Country Intelligence Index — composite risk scoring across 12 signal categories
• Finance radar — 92 stock exchanges, commodities, crypto, and 7-signal market composite
• Local AI — run everything with Ollama, no API keys required
• 5 site variants from a single codebase (world, tech, finance, commodity, happy)
• Native desktop app (Tauri 2) for macOS, Windows, and Linux
• 21 languages with native-language feeds and RTL support

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

---

Quick Start

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

Open localhost:5173. No environment variables required for basic operation.

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

See the self-hosting guide for deployment options (Vercel, Docker, static).

---

Self-Hosting Troubleshooting (Pro, Login, API Keys, Webcams)

If you run WorldMonitor locally (for example on localhost:3030), the app itself works without login, but some panels can still show Pro, No data available, or similar placeholders.

Why Login/Sign-in appears to do little locally

• The public repository is designed to run in community/self-host mode by default.
• Some Pro features are tied to hosted infrastructure, paid quotas, or backend credentials that are not shipped in this repo.
• Because of that, local Login/Sign-in actions may not unlock hosted-tier capabilities.

Where API keys usually belong

• Frontend Vite vars: .env.local (VITE_* variables).
• Edge/API secrets: deployment platform env vars (for example Vercel/Railway project settings).
• Never commit secrets to git.

Why many feeds can be empty

• Upstream providers may rate-limit/geo-block/self-host block requests.
• Missing optional provider keys can disable certain endpoints.
• Some data sources are intentionally best-effort and degrade gracefully.

Webcams: can I add my own?

Yes. The project can be extended with additional webcam/data sources, but this is a code/config contribution (not only a UI toggle). Typical path:

1. Add source configuration in shared/config files.
2. Add or extend an API/domain endpoint.
3. Wire hydration so bootstrap loads the new source.
4. Add/adjust panel mapping in src/config and component rendering.

Is local customization risky for public repos?

• Safe approach: keep secrets in local env only, and use .gitignored files.
• Prefer feature flags for experimental/custom sources.
• Don’t commit private API URLs, tokens, or paid provider credentials.

If you want, create an issue or PR with a concrete webcam provider and expected schema, and we can help you wire it in cleanly.

---

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 / Groq / OpenRouter, Transformers.js (browser-side)
API Contracts	Protocol Buffers (92 protos, 22 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.

---

Flight Data

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

---

Data Sources

WorldMonitor aggregates 65+ external data sources across geopolitics, finance, energy, climate, aviation, cyber, military, infrastructure, and news intelligence. See the full data sources catalog for providers, feed tiers, and collection methods.

---

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

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

---

License

AGPL-3.0 for non-commercial use. Commercial license required for any commercial use.

Use Case	Allowed?
Personal / research / educational	Yes
Self-hosted (non-commercial)	Yes, with attribution
Fork and modify (non-commercial)	Yes, share source under AGPL-3.0
Commercial use / SaaS / rebranding	Requires commercial license

See LICENSE for full terms. For commercial licensing, contact the maintainer.

Copyright (C) 2024-2026 Elie Habib. All rights reserved.

---

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.

---

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

Star History