Skip to content

Commit addbaa2

Browse files
docs: add README.md file
1 parent 3594ea0 commit addbaa2

File tree

1 file changed

+59
-0
lines changed

1 file changed

+59
-0
lines changed

README.md

+59
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
<div align="center">
2+
<h1>GirlScript Winter of Contributing Twitter Bot</h1>
3+
</div>
4+
5+
[![Issues](https://img.shields.io/github/issues/thepranaygupta/GWoC-Bot)](https://github.com/thepranaygupta/GWoC-Bot/issues)
6+
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/thepranaygupta/GWoC-Bot/pulls)
7+
[![Forks](https://img.shields.io/github/forks/thepranaygupta/GWoC-Bot?style=social)](https://github.com/thepranaygupta/GWoC-Bot/network/members)
8+
[![Stars](https://img.shields.io/github/stars/thepranaygupta/GWoC-Bot?style=social)](https://github.com/thepranaygupta/GWoC-Bot/stargazers)
9+
[![Watchers](https://img.shields.io/github/watchers/thepranaygupta/GWoC-Bot?style=social)](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

Comments
 (0)