Skip to content

ShreyRavi/covid-19-sms

Repository files navigation

A Twilio-powered SMS service that returns COVID-19 stats for zipcode, state, and city. Powered by Flask. Coded for the Twilio Hackathon. Hackathon submission post at Dev.to here.

Screenshots of the COVID-19 SMS Update Service in action for various requests.

Usage

The COVID-19 SMS Update Service can be used by texting +1(231) 774-2545 with a zipcode, a City, State Code (such as Chicago, IL), or a state (such as IL or Ohio) to get the latest COVID-19 updates for that area. One can call +1(231) 774-2545 to get these instructions read out loud.

Examples

  1. Text +1(231) 774-2545 a zipcode

Input:

77001

Output:

04/13 COVID-19 SMS Update:
Harris County, Texas:
Confirmed Cases: 3629
Deaths: 44
Source: New York Times. Thanks for using COVID-19 SMS Update!
  1. Text +1(231) 774-2545 a city, state Code

Input:

Kansas City, MO

Output:

04/13 COVID-19 SMS Update for Kansas City, MO:

Platte County, Missouri:
Confirmed Cases: 25
Deaths: 0

Jackson County, Missouri:
Confirmed Cases: 213
Deaths: 7

Clay County, Missouri:
Confirmed Cases: 48
Deaths: 1

Source: New York Times. Thanks for using COVID-19 SMS Update!
  1. Text +1(231) 774-2545 a state

Input:

WA

Output:

04/13 COVID-19 SMS Update for Washington:
Confirmed Cases: 10411
Deaths: 511
Source: New York Times. Thanks for using COVID-19 SMS Update!
  1. Call +1(231) 774-2545

See for yourself!

The SMS and voice routes are hosted on the Heroku repo above.

Local Setup

  1. Clone Repository
git clone https://github.com/ShreyRavi/covid-19-sms.git
  1. PIP install requirements
pip install -r requirements.txt
  1. Run Flask app and open browser to http://localhost:5000/
python3 app.py
  1. Use ngrok and Twilio to configure webhooks for your Twilio account.

Built With

Data Source/Attribution

The COVID-19 data is sourced from the New York Times's public GitHub repository CSV of COVID-19 data, from here.

Future Plans

  • More intelligent request handling
  • Efficiency improvements
  • Multiple data sources
  • More granular reports
  • Regular subscription to reports

License

The MIT License (MIT)

About

A Twilio powered SMS service that returns localized COVID-19 stats, built with Python/Flask. Text a zip, state, or city to +1 (231) 774-2545.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published