mirror of
https://github.com/koala73/worldmonitor.git
synced 2026-04-25 17:14:57 +02:00
b64eb2872b
* Update README.md with corrected links to documentation * Apply suggestion from @greptile-apps[bot] Update link to architecture page Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com> * Apply suggestion from @greptile-apps[bot] Not technically accurate, IMHO, but prettier. Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com> --------- Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
168 lines
8.2 KiB
Markdown
168 lines
8.2 KiB
Markdown
# World Monitor
|
|
|
|
**Real-time global intelligence dashboard** — AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface.
|
|
|
|
[](https://github.com/koala73/worldmonitor/stargazers)
|
|
[](https://github.com/koala73/worldmonitor/network/members)
|
|
[](https://discord.gg/re63kWKxaz)
|
|
[](https://www.gnu.org/licenses/agpl-3.0)
|
|
[](https://www.typescriptlang.org/)
|
|
[](https://github.com/koala73/worldmonitor/commits/main)
|
|
[](https://github.com/koala73/worldmonitor/releases/latest)
|
|
|
|
<p align="center">
|
|
<a href="https://worldmonitor.app"><img src="https://img.shields.io/badge/Web_App-worldmonitor.app-blue?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Web App"></a>
|
|
<a href="https://tech.worldmonitor.app"><img src="https://img.shields.io/badge/Tech_Variant-tech.worldmonitor.app-0891b2?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Tech Variant"></a>
|
|
<a href="https://finance.worldmonitor.app"><img src="https://img.shields.io/badge/Finance_Variant-finance.worldmonitor.app-059669?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Finance Variant"></a>
|
|
<a href="https://commodity.worldmonitor.app"><img src="https://img.shields.io/badge/Commodity_Variant-commodity.worldmonitor.app-b45309?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Commodity Variant"></a>
|
|
<a href="https://happy.worldmonitor.app"><img src="https://img.shields.io/badge/Happy_Variant-happy.worldmonitor.app-f59e0b?style=for-the-badge&logo=googlechrome&logoColor=white" alt="Happy Variant"></a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://worldmonitor.app/api/download?platform=windows-exe"><img src="https://img.shields.io/badge/Download-Windows_(.exe)-0078D4?style=for-the-badge&logo=windows&logoColor=white" alt="Download Windows"></a>
|
|
<a href="https://worldmonitor.app/api/download?platform=macos-arm64"><img src="https://img.shields.io/badge/Download-macOS_Apple_Silicon-000000?style=for-the-badge&logo=apple&logoColor=white" alt="Download macOS ARM"></a>
|
|
<a href="https://worldmonitor.app/api/download?platform=macos-x64"><img src="https://img.shields.io/badge/Download-macOS_Intel-555555?style=for-the-badge&logo=apple&logoColor=white" alt="Download macOS Intel"></a>
|
|
<a href="https://worldmonitor.app/api/download?platform=linux-appimage"><img src="https://img.shields.io/badge/Download-Linux_(.AppImage)-FCC624?style=for-the-badge&logo=linux&logoColor=black" alt="Download Linux"></a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://www.worldmonitor.app/docs/documentation"><strong>Documentation</strong></a> ·
|
|
<a href="https://github.com/koala73/worldmonitor/releases/latest"><strong>Releases</strong></a> ·
|
|
<a href="https://www.worldmonitor.app/docs/contributing"><strong>Contributing</strong></a>
|
|
</p>
|
|
|
|
|
|
|
|
---
|
|
|
|
## What It Does
|
|
|
|
- **435+ 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](https://www.worldmonitor.app/docs/documentation)**.
|
|
|
|
---
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
git clone https://github.com/koala73/worldmonitor.git
|
|
cd worldmonitor
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
Open [localhost:5173](http://localhost:5173). No environment variables required for basic operation.
|
|
|
|
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
|
|
```
|
|
|
|
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 (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](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 data sources across geopolitics, finance, energy, climate, aviation, cyber, military, infrastructure, and news intelligence. 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** 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](LICENSE) for full terms. For commercial licensing, contact the maintainer.
|
|
|
|
Copyright (C) 2024-2026 Elie Habib. All rights reserved.
|
|
|
|
---
|
|
|
|
## Author
|
|
|
|
**Elie Habib** — [GitHub](https://github.com/koala73)
|
|
|
|
## Contributors
|
|
|
|
<a href="https://github.com/koala73/worldmonitor/graphs/contributors">
|
|
<img src="https://contrib.rocks/image?repo=koala73/worldmonitor" />
|
|
</a>
|
|
|
|
## 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](./SECURITY.md) for responsible disclosure guidelines.
|
|
|
|
---
|
|
|
|
<p align="center">
|
|
<a href="https://worldmonitor.app">worldmonitor.app</a> ·
|
|
<a href="https://www.worldmonitor.app/docs/documentation">docs.worldmonitor.app</a> ·
|
|
<a href="https://finance.worldmonitor.app">finance.worldmonitor.app</a> ·
|
|
<a href="https://commodity.worldmonitor.app">commodity.worldmonitor.app</a>
|
|
</p>
|
|
|
|
## Star History
|
|
|
|
<a href="https://api.star-history.com/svg?repos=koala73/worldmonitor&type=Date">
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=koala73/worldmonitor&type=Date&type=Date&theme=dark" />
|
|
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=koala73/worldmonitor&type=Date&type=Date" />
|
|
</picture>
|
|
</a>
|