koala73 / worldmonitor

koala73 / worldmonitor

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 World Monitor 实时全球情报仪表板——通过统一的态势感知界面,提供人工智能驱动的新闻聚合、地缘政治监测和基础设施追踪。文档 · 发布 · 贡献

What It Does

功能概述

500+ curated news feeds across 15 categories, AI-synthesized into briefs. 涵盖 15 个类别的 500 多个精选新闻源,经 AI 合成后生成简报。

Dual map engine — 3D globe (globe.gl) and WebGL flat map (deck.gl) with 56 map layer types. 双地图引擎——支持 3D 地球仪 (globe.gl) 和 WebGL 平面地图 (deck.gl),包含 56 种地图图层类型。

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. 国家不稳定指数 (CII)——为 31 个一级国家提供服务器权威的 CII v8 压力评分。

Finance radar — 29 stock exchanges, commodities, crypto, and 7-signal market composite. 金融雷达——涵盖 29 个证券交易所、大宗商品、加密货币及 7 信号市场综合指数。

Local AI — run everything with Ollama, no API keys required. 本地 AI——通过 Ollama 运行所有功能,无需 API 密钥。

6 site variants from a single codebase (world, tech, finance, commodity, happy, energy). 单一代码库支持 6 个站点变体(世界、科技、金融、商品、快乐、能源)。

Native desktop app (Tauri 2) for macOS, Windows, and Linux. 原生桌面应用 (Tauri 2),支持 macOS、Windows 和 Linux。

24 languages with native-language feeds and RTL support. 支持 24 种语言,提供母语新闻源及从右向左 (RTL) 的书写支持。

For the full feature list, architecture, data sources, and algorithms, see the 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. 所有站点变体和桌面二进制文件均由单一代码库构建,并采用相同的发布流程。下表明确了维护状态,以便您了解哪些平台可以安全依赖。

SurfaceStatusNotes
worldmonitor.app, tech., finance., commodity., happy., energy.StablePublic deployments built from this repo, actively maintained
Desktop binaries (Windows / macOS Apple Silicon / macOS Intel / Linux AppImage)StableOne Tauri binary that switches variants in-app; current CI release targets are full and tech
平台状态备注
worldmonitor.app, tech., finance., commodity., happy., energy.稳定基于此仓库的公共部署,处于活跃维护中
桌面二进制文件 (Windows / macOS Apple Silicon / macOS Intel / Linux AppImage)稳定单一 Tauri 二进制文件,可在应用内切换变体;当前 CI 发布目标为 full 和 tech

Issues filed against any of the above are triaged from the same backlog — see the issues board for currently-open work. 针对上述任何平台提交的问题都将从同一个待办事项列表中进行分类处理——请查看 issues 面板了解当前正在进行的工作。

Quick Start

快速开始

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

Open 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. 打开 localhost:3000。该应用无需环境变量即可运行。特定功能的数据源可能需要凭据——例如,flight-price 命令 (fly LON DXB) 需要 TRAVELPAYOUTS_API_TOKEN 才能返回实时报价;否则该命令将显示“需要凭据”消息,而不是合成数据。完整列表请参阅 .env.example。

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
npm run dev:energy # energy.worldmonitor.app

See the self-hosting guide for deployment options (Vercel, Docker, static). 请参阅自托管指南了解部署选项(Vercel、Docker、静态部署)。

Tech Stack

技术栈

  • 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

  • 前端: 原生 TypeScript, Vite, globe.gl + Three.js, deck.gl + MapLibre GL

  • 桌面端: Tauri 2 (Rust) 及 Node.js sidecar

  • AI/ML: Ollama / Groq / OpenRouter, Transformers.js (浏览器端)

  • API 契约: Protocol Buffers (276 个原型, 34 个服务), sebuf HTTP 注解

  • 部署: Vercel Edge Functions (60+), Railway relay, Tauri, PWA

  • 缓存: Redis (Upstash), 三级缓存, 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. 航班数据由 Wingbits 提供,这是目前最先进的 ADS-B 航班数据解决方案。

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 for providers, feed tiers, and collection methods. WorldMonitor 聚合了 65 个以上的外部提供商和 API,涵盖地缘政治、金融、能源、气候、航空、网络、军事、基础设施和新闻情报——通过 500 多个精选信息源呈现,并由覆盖 35 个源组的新鲜度监控器进行追踪。请参阅完整的数据源目录以了解提供商、信息源层级和收集方法。

Contributing

贡献

Contributions welcome! See CONTRIBUTING.md for guidelines. 欢迎贡献!请参阅 CONTRIBUTING.md 获取指南。

npm run typecheck # 类型检查
npm run build:full # 生产环境构建

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. 源代码采用 AGPL-3.0-only 许可证。在遵守其 Copyleft 和源代码公开条款的前提下,允许商业使用。

Use CaseAllowed?
Personal / research / educationalYes, under AGPL-3.0-only
Self-hosted instanceYes, under AGPL-3.0-only
Fork and modifyYes, share source under AGPL-3.0-only when required
Commercial use / SaaSYes, under AGPL-3.0-only when you comply with AGPL obligations
Private-source proprietary use or official branding rightsSeparate commercial or trademark permission needed
使用场景是否允许?
个人 / 研究 / 教育是,在 AGPL-3.0-only 下
自托管实例是,在 AGPL-3.0-only 下
分叉并修改是,在需要时需根据 AGPL-3.0-only 分享源代码
商业使用 / SaaS是,在遵守 AGPL 义务的前提下
私有闭源使用或官方品牌授权需要单独的商业或商标许可

See LICENSE for the full code license and docs/license.mdx for a plain-language summary. Commercial licensing is available as an alternative option for teams that need non-AGPL terms. 请参阅 LICENSE 获取完整的代码许可证,并参阅 docs/license.mdx 获取通俗易懂的摘要。对于需要非 AGPL 条款的团队,可选择商业许可作为替代方案。

Copyright (C) 2024-2026 Elie Habib. All rights reserved. 版权所有 (C) 2024-2026 Elie Habib。保留所有权利。

Author Elie Habib — GitHub Contributors 作者 Elie Habib — GitHub 贡献者

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) Cody Richard — 披露了三项安全发现,涵盖 IPC 命令暴露、渲染器到 sidecar 的信任边界分析以及 fetch patch 凭据注入架构 (2026)

See our Security Policy for responsible disclosure guidelines. 请参阅我们的安全策略以了解负责任的披露指南。