-0078D4?style=for-the-badge&logo=windows&logoColor=white){kind=icon}
-FCC624?style=for-the-badge&logo=linux&logoColor=black){kind=icon}
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 56 map layer types - **Cross-stream correlation** — military, economic, disaster, and escalation signal convergence - **Country Instability Index (CII)** — server-authoritative CII v8 stress scoring for 31 Tier-1 countries - **Finance radar** — 29 stock exchanges, commodities, crypto, and 7-signal market composite - **Local AI** — run everything with Ollama, no API keys required - **6 site variants** from a single codebase (world, tech, finance, commodity, happy, energy) - **Native desktop app** (Tauri 2) for macOS, Windows, and Linux - **24 languages** with native-language feeds and RTL support For the full feature list, architecture, data sources, and algorithms, see the **[documentation](https://www.worldmonitor.app/docs/documentation)**. --- ## Support Status All site variants and desktop binaries are built from a single codebase and ship from the same release process. The table below clarifies maintenance status so you know which surfaces are safe to depend on. | Surface | Status | Notes | |---------|--------|-------| | `worldmonitor.app`, `tech.`, `finance.`, `commodity.`, `happy.`, `energy.` | Stable | Public deployments built from this repo, actively maintained | | Desktop binaries (Windows / macOS Apple Silicon / macOS Intel / Linux AppImage) | Stable | One Tauri binary that switches variants in-app; current CI release targets are `full` and `tech` | Issues filed against any of the above are triaged from the same backlog — see the [issues board](https://github.com/koala73/worldmonitor/issues) for currently-open work. --- ## Quick Start ```bash git clone https://github.com/koala73/worldmonitor.git cd worldmonitor npm install npm run dev ``` Open [localhost:3000](http://localhost:3000). The app runs with no environment variables. Feature-specific data sources may require credentials — for example, the flight-price command (`fly LON DXB`) needs `TRAVELPAYOUTS_API_TOKEN` to return live quotes; without it the command shows a "credentials required" message rather than synthetic data. See `.env.example` for the full list. For variant-specific development: ```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 ``` See the **[self-hosting guide](https://www.worldmonitor.app/docs/getting-started)** for deployment options (Vercel, Docker, static). --- ## 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 (276 protos, 34 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](https://www.worldmonitor.app/docs/architecture)**. --- ## Flight Data Flight data provided gracefully by [Wingbits](https://wingbits.com?utm_source=worldmonitor&utm_medium=referral&utm_campaign=worldmonitor), the most advanced ADS-B flight data solution. --- ## Data Sources WorldMonitor aggregates 65+ external providers and APIs across geopolitics, finance, energy, climate, aviation, cyber, military, infrastructure, and news intelligence — surfaced through 500+ curated feeds and tracked by a freshness monitor covering 35 source groups. See the full [data sources catalog](https://www.worldmonitor.app/docs/data-sources) for providers, feed tiers, and collection methods. --- ## Contributing Contributions welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines. ```bash npm run typecheck # Type checking npm run build:full # Production build ``` --- ## License **AGPL-3.0-only** for the source code. Commercial use is permitted under the AGPL when you comply with its copyleft and source-availability terms. | Use Case | Allowed? | |----------|----------| | Personal / research / educational | Yes, under AGPL-3.0-only | | Self-hosted instance | Yes, under AGPL-3.0-only | | Fork and modify | Yes, share source under AGPL-3.0-only when required | | Commercial use / SaaS | Yes, under AGPL-3.0-only when you comply with AGPL obligations | | Private-source proprietary use or official branding rights | Separate commercial or trademark permission needed | See [LICENSE](LICENSE) for the full code license and [docs/license.mdx](docs/license.mdx) for a plain-language summary. Commercial licensing is available as an alternative option for teams that need non-AGPL terms. Copyright (C) 2024-2026 Elie Habib. All rights reserved. --- ## Author **Elie Habib** — [GitHub](https://github.com/koala73) ## Contributorsworldmonitor.app · docs.worldmonitor.app · finance.worldmonitor.app · commodity.worldmonitor.app
## Star History