README.md
Real-time global intelligence dashboard — AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface.
<p align="center"> <a href="https://worldmonitor.app"></a> <a href="https://tech.worldmonitor.app"></a> <a href="https://finance.worldmonitor.app"></a> <a href="https://commodity.worldmonitor.app"></a> <a href="https://happy.worldmonitor.app"></a> </p> <p align="center"> <a href="https://worldmonitor.app/api/download?platform=windows-exe"></a> <a href="https://worldmonitor.app/api/download?platform=macos-arm64"></a> <a href="https://worldmonitor.app/api/download?platform=macos-x64"></a> <a href="https://worldmonitor.app/api/download?platform=linux-appimage"></a> </p> <p align="center"> <a href="https://docs.worldmonitor.app"><strong>Documentation</strong></a> · <a href="https://github.com/koala73/worldmonitor/releases/latest"><strong>Releases</strong></a> · <a href="https://docs.worldmonitor.app/contributing"><strong>Contributing</strong></a> </p>For the full feature list, architecture, data sources, and algorithms, see the documentation.
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).
| 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.
Contributions welcome! See CONTRIBUTING.md for guidelines.
npm run typecheck # Type checking
npm run build:full # Production build
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.
Elie Habib — GitHub
We thank the following researchers for responsibly disclosing security issues:
See our Security Policy for responsible disclosure guidelines.