Skip to content

Latest commit

 

History

History
91 lines (67 loc) · 5.54 KB

README.md

File metadata and controls

91 lines (67 loc) · 5.54 KB
Raw

Github-Followers-Bot

A Github Bot that automatically follows and unfollows users, to boost your profile growth, presence, and interactions.

Maintained status Release badge

📌 Important Info (Please Read)

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.

👥 What is this project?

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)

💭 How does it work?

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

🛠 Installation & setup

  1. Clone repository OR download the latest release

    git clone https://github.com/KevinTrinh1227/Github-Followers-Bot
    cd Github-Auto-Followers-Bot

  2. OPTIONAL: Use the correct Node version using NVM (Node v16.20.2)

    nvm install 16
    nvm alias default 16

  3. Install the dependencies using npm or yarn

    npm install
    yarn install

🚀 Start the application

  1. Now run the application

    npm start
    yarn run start