# WorldMonitor — Real-Time Global Intelligence Dashboard

> An open-source situational awareness platform that aggregates news, geopolitical events, and infrastructure data into a unified AI-powered monitoring dashboard.

## Install

Save in your project root:

# WorldMonitor — Real-Time Global Intelligence Dashboard

## Quick Use
```bash
git clone https://github.com/koala73/worldmonitor.git
cd worldmonitor
cp .env.example .env
docker compose up -d
# Open http://localhost:3000
```

## Introduction
WorldMonitor is an open-source intelligence dashboard that aggregates global news, geopolitical developments, and infrastructure events into a single interface. It uses AI to summarize, categorize, and surface relevant information for situational awareness and decision-making.

## What WorldMonitor Does
- Aggregates real-time news feeds from multiple global sources into a unified timeline
- Uses AI to summarize and categorize events by region, topic, and severity
- Displays geopolitical events on interactive maps with historical context
- Monitors infrastructure status including internet connectivity and service outages
- Sends configurable alerts when events match user-defined criteria

## Architecture Overview
WorldMonitor is a TypeScript application with a React frontend and a Node.js backend. Data ingestion pipelines collect information from RSS feeds, public APIs, and web scrapers on configurable intervals. An AI processing layer classifies and summarizes incoming events. Results are stored in a PostgreSQL database and served through a real-time WebSocket connection to the dashboard.

## Self-Hosting & Configuration
- Deploy via Docker Compose with all dependencies included
- Configure news sources and data feeds through the admin panel or environment variables
- Set up AI summarization with OpenAI, Anthropic, or compatible local model endpoints
- Alert channels support email, Slack, Discord, and webhook integrations
- Data retention policies are configurable for storage management

## Key Features
- Multi-source aggregation combines news, social media signals, and infrastructure data
- AI-powered event classification with automatic severity scoring and topic tagging
- Interactive global map view with event clustering and drill-down capabilities
- Historical timeline enables tracking event evolution over days and weeks
- Self-hosted design keeps sensitive monitoring data on your own infrastructure

## Comparison with Similar Tools
- **TrendRadar** — focused on trend monitoring and RSS; WorldMonitor adds geopolitical and infrastructure tracking
- **Glance** — general-purpose dashboard; WorldMonitor is purpose-built for intelligence and situational awareness
- **Huginn** — event-driven automation; WorldMonitor provides a visual dashboard-first experience
- **OSINT tools** — typically CLI-based; WorldMonitor offers a polished web interface with AI analysis

## FAQ
**Q: What data sources does WorldMonitor support?**
A: RSS feeds, public news APIs, social media endpoints, and infrastructure monitoring services.

**Q: Does it require an AI API key?**
A: AI summarization is optional. The dashboard works without it, but AI features require a configured LLM provider.

**Q: Can I add custom data sources?**
A: Yes. The plugin system supports custom data connectors with configurable polling intervals.

**Q: Is this suitable for enterprise use?**
A: The self-hosted architecture supports enterprise deployment. Evaluate the data source integrations for your needs.

## Sources
- https://github.com/koala73/worldmonitor

---
Source: https://tokrepo.com/en/workflows/asset-b52f9134
Author: AI Open Source