FolloGit

FolloGit is a fast and aggressive CLI tool that synchronizes your followers and following list on GitHub.

Built for people who prefer automation over wasting time.

---

Features

✔ Automatic follower synchronization
✔ Smart pagination support
✔ HTTP/2 optimized requests
✔ Connection pooling
✔ Retry system for network errors
✔ Rate-limit aware
✔ Fast execution
✔ Clean CLI output
✔ Token based authentication

Built using the GitHub REST API.

---

Installation

Clone the repository.

git clone https://github.com/yourname/follogit
cd follogit

Install dependencies.

pip install -r requirements.txt

---

Requirements

• Python 3.10+
• A valid GitHub Personal Access Token

---

Configuration

Create environment variables.

Linux / macOS

export GITHUB_TOKEN=your_token_here
export GITHUB_USERNAME=your_username

Windows PowerShell

$env:GITHUB_TOKEN="your_token_here"
$env:GITHUB_USERNAME="your_username"

---

Usage

Run the tool.

py main.py

Example output:

[*] Synchronizing followers...

[*] Fetching data from: https://api.github.com/users/username/following
[*] Fetching data from: https://api.github.com/users/username/followers

[+] You follow: 201
[+] They follow you: 208

[+] Followed: user1
[+] Followed: user2
[+] Followed: user3

[*] Sync completed in 4.31 seconds.

---

How it works

FolloGit performs three main steps.

1 --- Fetch following list

GET /users/{username}/following

2 --- Fetch followers list

GET /users/{username}/followers

3 --- Synchronization

The tool calculates:

followers − following

Every user in that difference gets followed automatically.

PUT /user/following/{username}

---

Core layer

Handles:

• pagination
• synchronization logic
• response parsing

Network layer

Handles:

• HTTP clients
• retries
• rate-limit handling
• connection pooling

---

Performance

FolloGit uses:

• HTTP/2
• connection pooling
• keep-alive
• compressed responses
• aggressive timeouts

Example run:

Followers: 208
Following: 201
Sync actions: 7

Execution time: 4.31s

---

Rate Limits

The GitHub API allows:

5000 requests per hour

FolloGit includes retry logic for:

• network failures
• temporary rate limits
• connection errors

---

Security

Your token is never stored.

It is read only from:

GITHUB_TOKEN

environment variable.

---

Warning

This tool performs real follow actions on your account.

If you run it:

• you will follow people automatically
• the API will execute the action

Use responsibly.

---

Roadmap

Future improvements may include:

• unfollow automation
• follower pruning
• follow back filters
• CLI flags
• parallel follow engine
• token rotation
• rate-limit dashboard