Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 

GitHub Follow Bot

Table of Contents

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.txt

Authenticate

Get a GitHub Personal Access Token

Make sure to enable the user scope and all subscopes inside of that permission.

How to get your GitHub PAT

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.

USER=YOUR_GITHUB_USERNAME
TOKEN=YOUR_GITHUB_PERSONAL_ACCESS_TOKEN

How to Use

Follow

Target user's followers

python bot_follow.py -t <TARGET_USER>

Followers of the most popular users from a country

(list of valid countries)

python bot_follow.py -p <COUNTRY_NAME>

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 followings

python bot_unfollow.py -a

Followers

Only unfollow users who already follow you

python bot_unfollow.py -fo

Non-followers

Only unfollow users who don't follow you back

python bot_unfollow.py -nf

From 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 300

Speed

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
     -smin 600
    
  • Maximum delay when rate limited
     -smin 1500
    

Future Implementation

  • Schedule - Bot only performs actions between set time and sleeps after off-schedule
  • 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 n repositories 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.

Resources

About

Automated follow/unfollow bot for GitHub. Follow from multiple sources. Choose which users to unfollow. Custom options to control bot speed and maximum actions.

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Languages