A Github Bot that automatically follows and unfollows users, to boost your profile growth, presence, and interactions.
This project is experimental and was developed for educational purposes only. Please be aware that using automated tools on GitHub, including this application, may violate GitHub’s Terms of Service, which prohibit activities such as:
- Automated excessive bulk activity (e.g., mass following or starring)
- Coordinated inauthentic interactions, such as fake accounts or bots
- Rank abuse through automated following or starring
- Spamming or cryptocurrency mining
- Excessive burden on GitHub servers through automated requests
By using this tool, you acknowledge the risk of your account being flagged or banned for violating GitHub's policies. Proceed with caution, and use at your own risk. This tool is intended solely for learning purposes, and the developer is not responsible for any misuse or potential consequences.
This project is a Node.js application that automates following and unfollowing users on GitHub at random intervals, simulating human-like behavior. It uses a queue system to manage actions, integrates logging for tracking activity, and includes a Discord webhook feature for real-time notifications of follow and unfollow events. The app ensures compliance with GitHub’s API rate limits and helps boost your profile growth, presence, and interactions by automatically engaging with users. Designed for long-term, 24/7 operation, it efficiently handles large volumes of users by optimizing API calls and minimizing redundant actions, ensuring smooth and resource-effective performance.
This project was built using Node 16.20.2 on Ubuntu (Linux)
This project is designed to mimic human-like behavior when interacting with GitHub. It follows and unfollows users at randomized intervals, simulating how a real person might interact with the platform. Instead of using a fixed schedule, the app randomizes both the timing and the number of users followed or unfollowed in each cycle, so the actions don't follow a predictable pattern.
Additionally, the program carefully limits the number of API calls it makes to avoid overwhelming GitHub’s servers or exceeding the API rate limits. It keeps track of users who have already been followed, ensuring no unnecessary actions are taken, making the process efficient and resource-friendly.
The table below uses estimated values for each MIN and MAX time frame (in seconds) between each API request.
| Wait Time Range | Follows + Unfollows per Hour | Estimated API Requests per Hour | Follows + Unfollows per Day | Followers per Day | Unfollowers per Day |
|---|---|---|---|---|---|
| 30-60 seconds | 60 to 120 | 300 to 600 | 1,440 to 2,880 | 720 to 1,440 | 720 to 1,440 |
| 60-120 seconds | 30 to 60 | 150 to 300 | 720 to 1,440 | 360 to 720 | 360 to 720 |
| 500-900 seconds | ~4 to 7.2 | ~20 to 36 | ~96 to 172 | 48 to 86 | 48 to 86 |
| 600-1200 seconds | ~3 to 6 | ~15 to 30 | ~72 to 144 | 36 to 72 | 36 to 72 |
| 700-1500 seconds | ~2.4 to 5.1 | ~12 to 25.5 | ~57.6 to 122.4 | 28.8 to 61.2 | 28.8 to 61.2 |
| 800-1800 seconds | ~2 to 4.5 | ~10 to 22.5 | ~48 to 108 | 24 to 54 | 24 to 54 |
| 900-2000 seconds | ~1.8 to 4 | ~9 to 20 | ~43.2 to 96 | 21.6 to 48 | 21.6 to 48 |
| 1000-2400 seconds | ~1.5 to 3.6 | ~7.5 to 18 | ~36 to 86.4 | 18 to 43.2 | 18 to 43.2 |
-
Clone repository OR download the latest release
git clone https://github.com/KevinTrinh1227/Github-Followers-Bot
cd Github-Auto-Followers-Bot -
OPTIONAL: Use the correct Node version using NVM (Node v16.20.2)
nvm install 16
nvm alias default 16 -
Install the dependencies using npm or yarn
npm install
yarn install
-
Now run the application
npm start
yarn run start