Skip to content

Latest commit

 

History

History
131 lines (94 loc) · 3.44 KB

README.md

File metadata and controls

131 lines (94 loc) · 3.44 KB

🤖 GitHub Smart Follow/Unfollow Manager

Python 3.6+ GitHub API License: MIT

🚀 Automate your GitHub networking with smart follow/unfollow scripts!

This repository contains two powerful Python scripts to help you manage your GitHub following list:

  • 🎯 github_smart_follow.py: Automatically find and follow relevant developers
  • 🔄 github_unfollow.py: Unfollow users who don't follow you back

📋 Prerequisites

Click to expand
  1. 🐍 Python 3.6 or higher
  2. 📦 Required library:
pip install requests
  1. 🔑 GitHub Personal Access Token:

🎯 Smart Follow Script (github_smart_follow.py)

Find and follow developers matching your interests!

🎨 Target Interests

  • 📊 Data Science
  • 🧠 Machine Learning
  • 🌐 Web Development
  • 📈 Data Analysis
  • 🐍 Python Development
  • 💻 JavaScript Development
  • 🔧 Full Stack Development
  • 🤖 AI Engineering

✨ Features

  • 🔍 Finds active users (active in the last month)
  • 🎯 Avoids following users you already follow
  • ⚖️ Smart filtering based on follower/following ratios
  • 🚀 Bulk following with optimal delays
  • 🛡️ Respects GitHub API rate limits

📝 Usage

  1. Run the script:
python github_smart_follow.py
  1. 🔑 Enter your GitHub token when prompted
  2. 📊 Specify how many users to follow (recommended: 50-200)
  3. 📋 Review the list of users found
  4. ✅ Confirm to start following them

🔄 Unfollow Script (github_unfollow.py)

Clean up your following list by removing non-followers!

✨ Features

  • 📊 Shows detailed following/followers statistics
  • 📋 Lists all users who don't follow you back
  • ✅ Confirmation before any action
  • 📝 Real-time feedback for each unfollow
  • 📚 Handles large following lists

📝 Usage

  1. Run the script:
python github_unfollow.py
  1. 🔑 Enter your GitHub token when prompted
  2. 📋 Review the list of non-followers
  3. ✅ Confirm to unfollow them

⚠️ Important Notes

  • 🚦 Rate Limits: GitHub API has rate limits. If hit, wait a few minutes.
  • 🔒 Token Security: Never share your GitHub token!
  • ⚡ Bulk Actions: Avoid following/unfollowing too many users at once.
  • ⏱️ Delays: Built-in delays prevent API blocking.

🐛 Error Handling

Both scripts include robust error handling for:

  • 🌐 Network errors
  • 🚦 Rate limit exceeded
  • 🔑 Invalid tokens
  • 🔄 API response errors

All errors display clear, actionable messages.

🤝 Contributing

Feel free to:

  • 🍴 Fork this repository
  • 🌟 Star it if you find it useful
  • 🔧 Submit pull requests with improvements

📄 License

License: MIT

This project is open source and available under the MIT License.

Made with ❤️ for the GitHub community