Features • Installation • Usage • API Integration • Visualization • Security • Disclaimer
- Real-time NWS alert monitoring for California
- Automatic IP-based location detection
- Interactive map visualization with Leaflet.js
- Manual location override capabilities
- Background data refresh (1-hour intervals)
- Responsive web interface
- Alert filtering for:
- Wildfires
- Evacuation orders
- Red flag warnings
git clone https://github.com/ronknight/firemon.git
cd firemon
pip install -r requirements.txt- Start the Flask server:
python3 app.py- Access the web interface at
http://localhost:8000
Manual Location Configuration:
- Submit county/city/ZIP via web form
- Map automatically centers on specified location
import requests
# Get active alerts
response = requests.get("http://localhost:8000/alerts")
alerts = response.json()
# Update map center
requests.post("http://localhost:8000/update_map_center", json={
"map_center": [34.0522, -118.2437] # LA coordinates
})graph TD
A[User Browser] -->|HTTP Request| B[Flask Server]
B --> C[Background Thread]
C -->|Every 1 Hour| D[NWS API]
D --> E[Filter Alerts]
E --> F[Update Cache]
B --> G[Leaflet.js Map]
F --> G
G --> H[Display Alert Markers]
B --> I[Location Services]
I -->|IP-API.com| J[Geolocation]
Important
- Custom User-Agent header for API compliance
- Rate-limited API retries (3 attempts with exponential backoff)
- Input validation for location data
- No persistent user data storage
- Built-in request timeout handling
This system provides informational alerts ONLY. Always:
- Verify with official emergency services
- Follow evacuation orders immediately
- Maintain multiple alert notification methods
NWS data may contain delays - do not rely solely on this system
for life-saving decisions. Use at your own risk.
firemon/
├── app.py # Main application logic
├── requirements.txt # Python dependencies
├── templates/
│ └── index.html # Web interface template
├── static/
│ ├── js/
│ │ └── map.js # Javascript
│ └── style.css # Stylesheets
├── LICENSE
└── README.md
