Evilgeniusnerd/soteria-dms

Soteria Disaster Management System

This is a simple application to locate tweets on a map based on the location from where they were sent. This can be helpful for first responders in times of natural or man-made disasters.

This application was written in Python 3.7, and uses Flask Socket IO which gives Flask applications access to low latency bi-directional communications between the clients and the server, and Tweepy a Python-based client to interact with the Twitter REST APIs.

In order to have access to Twitter data programmatically it's necessary to have some access tokens, you can create an app and get your secret tokens from here.

Installation

git clone https://github.com/Evilgeniusnerd/soteria-dms.git
cd soteria-dms
pip install -r requirements.txt

After this proccess is done you need to fill in the Twitter-Api Keys with your tokens

CONSUMER_KEY = 'Your API KEY'
CONSUMER_SECRET = 'Your API SECRET KEY'
ACCESS_TOKEN = 'Your Access Token'
ACCESS_SECRET = 'Your Access Secret Token'

Run

python app.py

If everything is correct you will see the server is running and which host and port is running on. Just go to the url and wait for the tweets appear on the map.

If you want to filter tweets based on other words you can change the tags in the app.py file

if __name__ == '__main__':
    """
    tags = ["#python", "programming", "flask"]   
    """

Enjoy it!!

There is more to come to this project such as using NLP to filter the tweets even more and other neat tools for disaster managment. So please check back :)