Skip to content
/ vaxer Public

COVID vaccine finder with SMS notifications.

Notifications You must be signed in to change notification settings

jswny/vaxer

Repository files navigation

Vaxer

A vaccine finder which can alert you using SMS when vaccines are available

Supported Sources

  • CVS

Environment Variables

Note: all phone numbers should be in the form +1XXXXXXXXXX for US numbers.

  • DELAY: delay in MS in between checks, defaults to 10 minutes. The first check is done 1 minute after startup, then the delay is used.
  • TWILIO_ACCOUNT_SID: for your Twilio account
  • TWILIO_AUTH_TOKEN: for your Twilio account
  • TWILIO_PHONE_NUMBER: the Twilio phone number to send SMS from using your account
  • NOTIFICATION_PHONE_NUMBERS: a comma-separated list of phone numbers to message when a vaccine is available
  • STATE_ABBREVIATION: the two-letter abbreviation of the state to check, such as MA
  • ZIP_CODE: the zip code to check for vaccination locations near. If this is set, locations will be searched within the specified distance. Otherwise, any location in the state will be returned if vaccines are available.
  • DISTANCE: the distance around the zip code (in miles) to search for locations

Running

  1. Create a .env file with the following environment variables:
TWILIO_ACCOUNT_SID=<fill>
TWILIO_AUTH_TOKEN=<fill>
TWILIO_PHONE_NUMBER=<fill>
NOTIFICATION_PHONE_NUMBERS=<fill>
STATE_ABBREVIATION=<fill>
ZIP_CODE=<fill>
DISTANCE=<fill>
  1. Run the app with docker-compose up or docker-compose up -d for detatched mode

About

COVID vaccine finder with SMS notifications.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published