https://github.com/nullhack/src-disaster-awareness
https://github.com/nullhack/src-disaster-awareness
Last synced: 23 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/nullhack/src-disaster-awareness
- Owner: nullhack
- Created: 2026-03-11T13:20:56.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-03-28T04:08:48.000Z (about 1 month ago)
- Last Synced: 2026-03-28T08:55:27.599Z (about 1 month ago)
- Language: Python
- Size: 219 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Disaster Awareness Agent
An intelligent LLM-powered agent prototype designed to autonomously monitor and analyze global disasters, providing critical situational awareness and humanitarian response coordination.
## Purpose
**Disaster Awareness Agent** is a specialized AI system that continuously scans the internet for emerging disasters, humanitarian crises, and critical events worldwide. By aggregating multi-source information and applying advanced natural language processing, the agent generates actionable intelligence reports that:
- **Monitor Global Events**: Track major disasters, natural catastrophes, humanitarian emergencies, and crisis situations across all regions
- **Compile Situation Reports**: Synthesize real-time data into coherent, structured intelligence assessments for decision-makers
- **Enable Rapid Response**: Identify areas requiring immediate international humanitarian assistance, medical aid, or disaster relief
- **Enhance Awareness**: Provide key stakeholders, NGOs, and government agencies with timely, accurate information about unfolding crises
- **Support Coordination**: Facilitate information sharing and coordination among disaster response organizations and international bodies
## Key Features
- **Web Intelligence**: Autonomous scraping and analysis of global news sources, social media, and disaster reporting channels
- **LLM-Powered Analysis**: Advanced natural language understanding to identify severity, affected populations, and urgent needs
- **Structured Reporting**: Generate standardized crisis reports with key metrics and response recommendations
- **Multi-Source Aggregation**: Correlate information from diverse sources to reduce misinformation and enhance accuracy
## Project Status
🚀 **Prototype Phase** - Early development and proof-of-concept implementation
## Technology Stack
- **Python** - Core development language
- **LLM Integration** - Leverages large language models for intelligent analysis
- **Web Scraping** - Autonomous internet monitoring capabilities
## Getting Started
```bash
# Clone the repository
git clone https://github.com/nullhack/src-disaster-awareness.git
cd src-disaster-awareness
# Install dependencies
uv sync
# Run the agent
uv run python main.py
```
## License
MIT License - See LICENSE file for details
## Contributing
Contributions are welcome! Please feel free to submit pull requests or open issues for feature requests and bug reports.
## Contact & Support
For questions or collaboration inquiries, please reach out through GitHub issues.