|
| 1 | +<div align="center"> |
| 2 | +<h1>GirlScript Winter of Contributing Twitter Bot</h1> |
| 3 | +</div> |
| 4 | + |
| 5 | +[](https://github.com/thepranaygupta/GWoC-Bot/issues) |
| 6 | +[](https://github.com/thepranaygupta/GWoC-Bot/pulls) |
| 7 | +[](https://github.com/thepranaygupta/GWoC-Bot/network/members) |
| 8 | +[](https://github.com/thepranaygupta/GWoC-Bot/stargazers) |
| 9 | +[](https://github.com/thepranaygupta/GWoC-Bot/watchers) |
| 10 | + |
| 11 | +### A Twitter Bot that retweets and likes tweets with the hashtag [`#girlscriptwoc`](https://twitter.com/search?q=%23girlscriptwoc) and [`#girlscript`](https://twitter.com/search?q=%23girlscript), and also follows the user. |
| 12 | + |
| 13 | +<div align="center"> |
| 14 | +<a href="https://twitter.com/GWoC_Bot"> |
| 15 | +<img src="https://user-images.githubusercontent.com/64855541/134766679-c0a62e68-7663-4823-afb7-4ef21e9095d0.jpg" alt="GirlScript Winter of Contributing Bot on Twitter" width=500px> |
| 16 | +</a> |
| 17 | +</div> |
| 18 | + |
| 19 | +## Installation 📥 |
| 20 | + |
| 21 | +- Clone the repo |
| 22 | + |
| 23 | + ``` |
| 24 | + $ git clone https://github.com/thepranaygupta/GWoC-Bot.git |
| 25 | + ``` |
| 26 | + |
| 27 | +- Install [Tweepy](http://www.tweepy.org/) - An easy-to-use Python library for accessing the **Twitter API**. |
| 28 | + |
| 29 | + ``` |
| 30 | + $ pip install tweepy |
| 31 | + ``` |
| 32 | + |
| 33 | +## Working ⚙️ |
| 34 | + |
| 35 | +- Create a new Twitter account for your bot and Sign up for [Twitter Developer Account](https://developer.twitter.com/en/apply-for-access). |
| 36 | +- Make sure you fully understand [Twitter's Rules on Automation](https://support.twitter.com/articles/76915). Play nice. Don't spam! |
| 37 | +- Click on [Create an app](https://developer.twitter.com/en/apps). This is where you'll generate your keys, tokens, and secrets. |
| 38 | +- Enter the details and keep safe the access tokens generated. |
| 39 | +- Edit the [bot.py](./bot.py) file accordingly. |
| 40 | + |
| 41 | +## Deployment on [Heroku](https://www.heroku.com/) ⚒️ |
| 42 | + |
| 43 | +Follow all the steps as shown in this [YouTube Tutorial](https://youtu.be/BPvg9bndP1U). <br> |
| 44 | +You need to make three different files : |
| 45 | + |
| 46 | +- [runtime.txt](./runtime.txt) (Includes Python Version `python-3.8.12`) |
| 47 | +- [requirements.txt](./requirements.txt) (`pip freeze > requirements.txt`) |
| 48 | +- [Procfile](./Procfile) (`worker: python bot.py`) |
| 49 | + |
| 50 | +**Note**: Make sure that your [bot.py](./bot.py) file and the files generated above are in the same directory. |
| 51 | + |
| 52 | +## License 🧾 |
| 53 | + |
| 54 | +The GirlScript Winter of Contributing Twitter Bot is released under the under terms of the [MIT License](./LICENSE). |
| 55 | + |
| 56 | +## Contact 📬 |
| 57 | + |
| 58 | +If you are stuck anywhere you can contact me via [Twitter](https://twitter.com/thepranaygupta) or [LinkedIn](https://www.linkedin.com/in/thepranaygupta/) I will be glad to help you.😊 <br> |
| 59 | +Check out my other repositories [here](https://github.com/thepranaygupta?tab=repositories). |
0 commit comments