War Alerts

Live alert tracker for Pikud HaOref (Israel Home Front Command). Includes a CLI tool for terminal monitoring and a web dashboard with real-time updates.

Setup

Requires Python 3.11+ and uv.

uv sync

CLI

uv run python alerts.py                        # Live polling (every 2s)
uv run python alerts.py --once -v              # Single check, verbose
uv run python alerts.py --history              # Last 24h from API
uv run python alerts.py --cities ירושלים        # Filter to Jerusalem area

Web dashboard

uv run python server.py                        # http://localhost:5004

Features:

• Real-time alerts via Server-Sent Events
• Filter by area (31 regions) and city
• 24h alert history
• Sound alerts, dark/light theme
• Alert persistence across server restarts

Data source

Uses the undocumented Pikud HaOref alert API. City geodata originally sourced from the RedAlert project.