Annoying-Housemates-Bot

A Telegram bot to automate organizing house chores and delegating tasks.

Tired of cleaning your apartment you share with 3 other people by yourself? Sick of being the only one cleaning up the bathroom every week when no one even bats an eye? Ever feel like punching someone in the gut after coming back home to a pile of dishes that was already there sitting nonchalantly in the sink for almost a week?

Introducing: Annoying Housemates Bot, a Telegram bot that can let you assign house chores within a week. Add the Annoying Housemates Bot to your house/apartment chat group on Telegram now, and it will help you manage your apartment cleaning chores so you'll never have to feel bad for being passive aggressive to your irresponsible roommates! In the app, the bot takes on the person of your mom as it will nag you to do house chores until you feel like doing it.

Features

  • /help - shows the list of commands

  • /addme - include yourself to the schedule. IMPORTANT: if you haven't yet, do this first before you run the /schedule command for the first time!

  • /schedule - organize your cleaning rosters. Pick who gets to do what, and when in a week. IMPORTANT: make sure you have run /addme at least once before running /schedule for the first time!

  • /showschedule - shows all scheduled tasks

  • /start - display welcome screen and message

ADMIN ONLY:

  • /stop - kill the bot

  • /restart - reboot the bot when it becomes laggy

How we built it

The app was build entirely on Python. We also utilize the python-telegram-bot and the Telegram Bot API

Challenges we ran into

The Telegram API was not clearly documented, so we spent a huge chunk of time trying to understand how to use the API. In addition, there were also features that we did plan, and bugs we intend to fix, but did not have enough time to finish. We also couldn't figure out how to deploy it to Gcloud

What we learned

Learned a lot about Python and using APIs as this was our first time using Python, also first time messing around with APIs.

What's next

As of now, the app only runs locally, so a good start would be to deploy it to a server. The app is still buggy, so we'll definitely have to fix that. We would also implement a really cool feature that we did not have enough time for.

Built With

Share this project:

Updates