/COVIDResources

A Twitter bot that connects people willing to help with those in need

Primary LanguagePythonMIT LicenseMIT

header.png

The COVID Resources Bot Project

A Twitter bot that connects people willing to help with those in need. Follow the bot at @resource_botIN.

Disclaimer: The COVID Resource Bot Project (which including its creator, supporters, and development contributors) is NOT affiliated to the Government of India or any other formal institutions. The creator is, in no way, endorsing any political beliefs by making this tool (known as bot hereafter). The bot retweets are unmoderated and fully automated, which exempts the creator of any liability in case it retweets anything inappropriate. Requests to improve or shut the bot completely will be entertained if the creator finds it valid.

The bot also has a website where you can find other such resources as well. Visit resourcesbot.carrd.co

Table of Contents

FAQ

  • Why are you doing this? The simple answer is, because I can and I want to. Our country is going through the worst of the COVID-19 pandemic and it is very important that the people act as a whole and try their best to help those in need. I don't have any way to go out there and help people so I decided to put my skills to use instead and create this bot.

  • How does it work? The bot searches for the relevant hashtags in tweets and retweets them. The goal being, exposing the tweets that need attention to the followers of the bot so that the people who might be looking for any information can get it at one place - the bot's tweet history. The hashtags that trigger the bot to retweet currently are: "#Remdesvir", "#remdesivir", "#oxygen" and "#COVIDResourceBot". The last one can be used to make the bot retweet a tweet that doesn't contain other hashtags.

  • How does "#COVIDResourceBot" work? If you have a thread you've made already or you want the bot to retweet a tweet that doesn't have any triggering hashtags, reply to the tweet you want to be retweeted using "#COVIDResourceBot" and the bot will retweet it. For threads, you can reply with the hashtag to the first tweet of your thread.

  • How are you sustaining the costs of the servers? For the time being, I am paying for the servers and any additional costs. There some samaritans who have donated to the cause which has helped me tremendously. Take a look at the Supporters section here and you too can donate if you want!

  • Are you making any money off of this? No.

  • How do I believe you? I have records of all the donations and how the money is being spent which I can reproduce at any given time if asked. This is not like the PM-CARES fund.

  • I have a suggestion, how can I contact you? You can find me on Twitter to DM at @mayurtheboi. You can visit my GitHub profile or website to find all relevant contact information there.

  • I want to donate to this cause, how? Thank you so much! You can donate by buying me a coffee at buymeacoffee.com/mayurbhoi or you can pay using UPI (GPay, BHIM, PayTM, PhonePe, etc.) on this UPI ID- mayur072000@oksbi

Run It

(Recommended only if you want to learn to use Twitter API)

  • Make sure you have Python v3+ installed
  • Install tweepy using pip3 install --user tweepy
  • Clone the repository to your local machine
  • Open the main python file by going to bot/bot.py and change the following lines to your credentials:
consumer_key = '<REPLACE-WITH-YOUR-OWN>'
consumer_secret = '<REPLACE-WITH-YOUR-OWN>'
access_token = '<REPLACE-WITH-YOUR-OWN>'
access_token_secret = '<REPLACE-WITH-YOUR-OWN>'
  • Open Command Prompt on Windows or Terminal on macOS and change working directory to the project directory and execute using python3 bot.py

Contribute Changes

As the bot is fully open source, you can always open a pull request with your desired changes or suggestions and I can take a look to verify, test, and merge it.

Supporters

The awesome people who donated so that I can keep this going <3

  • Anjali Singh
  • @BlondDebjeet on Twitter
  • Dennis (@DennisJ__ on Twitter)
  • Isha Birla
  • M Faizaan Muzawar
  • Nikhil Kumar Kuppa
  • Oojal Kour
  • Praneeth Ratnagiri
  • Revanth Kumar Reddy
  • Ritwika Sarkar
  • Rutanjit Mandrekar
  • sid (@oldmonkbrownies on Twitter)
  • Supriya Nickam
  • Yash Saraf

Donate

Consider supporting my work by paying through UPI on mayur072000@oksbi or buying me a coffee: donate.png

#StaySafe #StayHome #IndiaFightsCOVID