Automate unfollowing GitHub users who don't follow you back using Python.

• 📊 Analyzes your GitHub followers and following
• 🔍 Detects non-reciprocal followers
• 🤖 Automates unfollow process
• 🔒 Secure GitHub token authentication
• ⚡ Rate limit protection

1. Clone Repository

git clone https://github.com/0xmainak/github-unfollowers.git
cd github-unfollowers

2. Install Dependencies

pip install -r requirements.txt

3. Configure Authentication

• Create .env file:

GITHUB_USERNAME=your_username
GITHUB_TOKEN=your_token

• Get token: GitHub Settings → Developer Settings → PAT (need user scope)

⚠️ Important: Make sure to select the user scope when creating your token. This permission is required for following/unfollowing operations.

Run:

python main.py

The tool will:

1. Get your network data
2. Find non-mutual followers
3. Process unfollows safely

• Python 3.6+ required
• Implements API rate limiting
• Secure credential handling
• Robust error management

MIT

Use responsibly within GitHub's terms of service.