🤖 Automated follow/unfollow bot for GitHub. Follow from multiple sources. Choose which users to unfollow. Custom options to control bot speed and maximum actions.
GitHub Follow Bot
Table of Contents
- Install Requirements - Authenticate - Get a GitHub Personal Access Token - Add your GitHub username and PAT to.env file
- Follow
- Target user's followers
- Followers of the most popular users from a country
- From a file
- Unfollow
- All
- Followers
- Non-followers
- From a file
- Options
- Maximum follows/unfollows
- Speed
Disclaimer
This is a PoC and was developed for educational purposes only. You may get your account banned. Use at your own risk.
### Spam and Inauthentic Activity on GitHub
Automated excessive bulk activity and coordinated inauthentic activity, such as spamming, are prohibited on GitHub. Prohibited activities include:
- (...)
- inauthentic interactions, such as fake accounts and automated inauthentic activity
- rank abuse, such as automated starring or following
From GitHub Acceptable Use Policies
Getting Started
Install Requirements
pip install -r requirements.txtAuthenticate
Get a GitHub Personal Access Token
Make sure to enable the user scope and all subscopes inside of that permission.
Add your GitHub username and PAT to .env file
Create a .env file on the project's root directory or edit .env.sample (rename to .env) and add your username and PAT.
GITHUBUSER=YOURGITHUB_USERNAME
TOKEN=YOURGITHUBPERSONALACCESSTOKENHow to Use
Follow
Target user's followers
python botfollow.py -t <TARGETUSER>Followers of the most popular users from a country
(list of valid countries)python botfollow.py -p <COUNTRYNAME>From a file
Follow users from a pre-generated file (JSON)python bot_follow.py -f <FILENAME>Unfollow
note: Unfollow order is FIFO, as in the most recently followed user will be the last to be unfollowed.
All
Unfollow all your followingspython bot_unfollow.py -aFollowers
Only unfollow users who already follow youpython bot_unfollow.py -foNon-followers
Only unfollow users who don't follow you backpython bot_unfollow.py -nfFrom a file
Unfollow users from a pre-generated file (JSON)python bot_unfollow.py -f <FILENAME>Options
Maximum follows/unfollows
Set the maximum number of follow/unfollow actions-m 300Speed
A random delay (in seconds) is performed after follow/unfollow actions or when the account is rate limited. You can change these delays to your liking with the following arguments:
- Minimum delay between actions
-smin 20- Maximum delay between actions
-smax 120- Minimum delay when rate limited
-slmin 600- Maximum delay when rate limited
-slmin 1500Future Implementation
- Schedule - Bot only performs actions between set time and sleeps after off-schedule
- Max follow per source - Follow max
nper popular user - Add follow source - Follow users per topic
- Add follow source - Grab followers from users listed in a file
- Email followed users - Send an email to followed users with templates (colaboration, follow back or custom)
- Star
nrepositories of followed users
Contributing
Contributions are welcome! Read the contribution guidelines first.
Wish there was another feature? Feel free to open an feature request issue with your suggestion!
If you find a bug, kindly open an bug report issue as described in the contribution guidelines.
