🤖 Automated follow/unfollow bot for GitHub. Follow from multiple sources. Choose which users to unfollow. Custom options to control bot speed and maximum actions.
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
pip install -r requirements.txt
Make sure to enable the user
scope and all subscopes inside of that permission.
.env
fileCreate a .env
file on the project's root directory or edit .env.sample
(rename to .env
) and add your username and PAT.
GITHUB_USER=YOUR_GITHUB_USERNAME
TOKEN=YOUR_GITHUB_PERSONAL_ACCESS_TOKEN
python bot_follow.py -t <TARGET_USER>
python bot_follow.py -p <COUNTRY_NAME>
Follow users from a pre-generated file (JSON)
python bot_follow.py -f <FILENAME>
note: Unfollow order is FIFO, as in the most recently followed user will be the last to be unfollowed.
Unfollow all your followings
python bot_unfollow.py -a
Only unfollow users who already follow you
python bot_unfollow.py -fo
Only unfollow users who don't follow you back
python bot_unfollow.py -nf
Unfollow users from a pre-generated file (JSON)
python bot_unfollow.py -f <FILENAME>
Set the maximum number of follow/unfollow actions
-m 300
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:
smin 20
smax 120
slmin 600
slmin 1500
n
per popular usern
repositories of followed usersContributions 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.