PuppyBouquet is a bot that send messages to users to spread some cheer. Messages include a short inspirational phrase and an image of a dog or puppy being silly.
The bot uses Twilio's SMS api to send texts. Message content is randomly generated from a set of curated phrases and images.
Tech Stack: Python3, Twilio SMS api
The following must be installed to run PuppyBoquet:
-
Python3
-
Twilio account or trial account:
- Twilio authorization token
- Twilio account SID
- Twilio phone number (sending number)
- Receiver's phone number (must verify on your Twilio trial account)
Clone repository:
$ git clone https://github.com/JKinsler/PuppyBouquet.git
Create and activate a virtual environment inside your PuppyBoquet directory:
$ virtualenv env --always-copy
$ source env/bin/activate
(Mac and Linux users use 'virtualenv env')
Install dependencies:
$ pip install -r requirements.txt
Get a Twilio authorization token, SID, and phone number:
Twilio create user account
Twilio SMS documentation
Twilio getting started video
Create a file called secrets.sh and add your private keys there:
- Twilio authorization token
- Twilio account SID
- Twilio phone number (sending number)
- Receiver's phone number (must verify on your Twilio trial account)
Source the private keys:
$ source secrets.sh
- Schedule messages so they send on a specific time when the bot is deployed
- expand into a web app that allows users to create an account and select when they'd like to receive PuppyBouquet messages
- Give users the option to upload and share images of their dogs.
PuppyBouquet creator, Johanna Kinsler, is a former automotive engineer turned software engineer. Johanna made PuppyBouquet to bring some cheer to friends and family during the covid19 shelter in place orders. Johanna learned her full stack software engineering skills at Hackbright's fellowship program, which she completed in March 2020. She can be found on LinkedIn and on Github.