worldmonitor README

The project's README from github.com/koala73/worldmonitor. As one markdown file: README.md.

World Monitor

简体中文 | 日本語 | Русский

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

GitHub stars License: AGPL v3 TypeScript Last commit Latest release npm: worldmonitor skills.sh

Web App  Tech Variant  Finance Variant  Commodity Variant  Happy Variant  Energy Variant

npm i worldmonitor  npx worldmonitor  pip install worldmonitor-sdk  gem install worldmonitor  go get github.com/koala73/worldmonitor/sdk/go

Download Windows  Download macOS ARM  Download macOS Intel  Download Linux

Documentation  ·  Releases  ·  Contributing

World Monitor Dashboard


What It Does

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.

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 for every variant — install World Monitor and switch to tech, finance, commodity, energy, or happy in-app. There is deliberately no per-variant download

Issues filed against any of the above are triaged from the same backlog — see the issues board for currently-open work.


Quick Start

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

Open localhost:3000 (override the port with DEV_PORT in .env.local). The app runs with no environment variables.

Feature-specific data sources may require credentials. See .env.example for the full list.

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).


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 / OpenRouter, Transformers.js (browser-side)
API Contracts Protocol Buffers and sebuf HTTP annotations
Deployment Vercel Edge Functions, Railway relay, Tauri, PWA
Caching Redis (Upstash), 3-tier cache, CDN, service worker

Full stack details in the architecture docs.


Programmatic Access

World Monitor is built for agents and scripts as well as browsers:

Agent discovery files: llms.txt · agent-skills manifest · api-catalog. Get an API key at worldmonitor.app/pro.


Flight Data

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


Data Sources

WorldMonitor aggregates attributed upstream sources across geopolitics, finance, energy, climate, aviation, cyber, military, infrastructure, and news intelligence. Curated feeds and freshness-tracked source groups are published in the full data sources catalog, with provider, feed-tier, license-posture, and collection-method details.


Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

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 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.

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:

See our Security Policy for responsible disclosure guidelines.


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

Star History

Star History Chart

worldmonitor (koala73/worldmonitor)

Searching Database…

这是什么?World Monitor 是一个实时全球情报仪表盘,它汇总新闻、地缘政治信号和基础设施数据,并借助 AI 进行综合分析,整合到一个界面中,帮助用户掌握全局态势。
这是网页仪表盘还是桌面应用?两者都是。它既可以作为网页仪表盘运行,提供多个站点版本(world、tech、finance、commodity、happy、energy),也提供基于 Tauri 2 构建的原生桌面应用,支持 macOS、Windows 和 Linux。
我该如何让它运行起来?克隆仓库,启动开发服务器,然后打开 localhost:3000(端口可通过 DEVPORT 修改)。应用开箱即用,无需环境变量,不过部分功能的数据源需要从 .env.example 中获取额外的凭据。
使用它需要 API 密钥吗?不需要。World Monitor 可以完全依靠本地 Ollama 模型运行,无需任何 API 密钥。当然,它也支持接入 Groq 或 OpenRouter 来使用 AI 功能。
它只是用来浏览的吗?开发者和智能体也能用吗?两者都支持。除了网页和桌面界面,它还提供 MCP 服务器、附带 OpenAPI 规范的 REST API、官方 CLI,以及适用于 Python、Ruby 和 Go 的零依赖 SDK,方便编写脚本和开发 AI 智能体。
桌面应用支持哪些平台?同一个 Tauri 二进制文件即可覆盖 Windows、macOS(Apple Silicon 和 Intel)以及 Linux(AppImage)。你可以在应用内切换站点版本,无需下载不同的安装包。
AGPL 许可证有什么需要注意的地方?代码采用 AGPL-3.0-only 许可证,因此允许自托管、分叉,甚至用于商业或 SaaS 用途,但前提是遵守其 copyleft 和源代码公开义务。私有闭源使用或使用官方品牌,则需要单独的商业许可证。
什么是国家不稳定指数(CII)?CII 是 World Monitor 自有的评分体系,为 31 个一级国家提供实时不稳定评分、风险等级以及约 24 小时内的变化趋势追踪。
地图渲染是如何工作的?它采用双地图引擎:3D 地球(globe.gl + Three.js)和基于 WebGL 的平面地图(deck.gl + MapLibre GL),两者共享同一套地图图层目录。
航班追踪数据从哪里来?航班数据由 Wingbits 提供,项目中将其描述为一种先进的 ADS-B 航班数据解决方案。
不重新安装的话,我能在财经、科技等版本之间切换吗?可以。所有站点版本和桌面应用都基于同一套代码库、同一个 Tauri 二进制文件构建,因此你可以直接在应用内切换版本(tech、finance、commodity、energy、happy)。
Creator
koala73
Size
268.4 MB
Stars
88.6K
Age
9mo
Commits · 90 Days