Skip to content
This repository has been archived by the owner on Feb 27, 2023. It is now read-only.

sohalsdr/LittleTexts

Repository files navigation

drawing

LittleTexts

A service to help couples connect through random daily challenges!

LittleTexts is an SMS-based chatbot powered by Twilio, Python, Flask, and SQLite that messages you and your partner open-ended writing "challenges". Every day, at a random time, all LittleTexts users will recieve they day's prompt. They will then have until the next prompt to reply to the bot with their answer to the challenge. The bot will then forward that answer to their partner, creating a fun talking point and facilitating sharing more little moments!

This project was developed as part of ShellHacks 2022!


Installation/Usage

This version of LittleTexts is a work in progress and not currently suitable for real-world usage.

How to install

  1. Clone the Git repository to your local/development machine and make sure Python is installed

  2. Install all python packages necessary through pip install -r requirements.txt

  3. Create a file called twilio.env and add your TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN, TWILIO_SEND_NUMBER, and ADMIN_NUMBER

  4. Run python3 command_handler.py

How to use

To use the bot, start by enrolling by texting the word "START". The bot will then prompt you to run REGISTER <your_name> <partner's_name> <partner's_phone_number> (ex. REGISTER Jesse Walter +14445556666) to add yourself to the service, and the bot will send a confirmation message to your partner to make sure they consent to being texted by LittleTexts

About

An SMS-based chatbot to help couples add variety to their texts, built using Twilio SMS and Python!

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages