/github-follow-insights

A simple Python application that leverages the GitHub API to fetch your followers and following lists. It then compares the two lists and generates a report of users that you are following, but they are not following you in return.

Primary LanguagePythonMIT LicenseMIT

A Python script to analyze your GitHub follow relationships and identify one-way connections where you are following someone, but they are not following you back And, This Python script allows you to unfollow multiple GitHub users programmatically using the GitHub REST API.

Install Usage Preview Contributing

Preview

2024-10-09_15-08

Installation

Important

Requirements

  • Python 3.6 or later
  1. Clone the repository:
git clone https://github.com/yourusername/github-follow-insights.git

cd github-follow-insights

pip install -r requirements.txt

Important

Prerequisites

Before using this script, you need to have a GitHub personal access token with the necessary permissions. If you don't have one already, you can generate it here.

Usage

  1. For get the list of users:
python main.py --token YOUR_GITHUB_TOKEN
  1. Get and Unfollow the founded users:
python main.py --token YOUR_GITHUB_TOKEN --unfollow
  1. For using proxy:
python main.py --proxy YOUR-PROXY-SERVER --token YOUR_GITHUB_TOKEN --unfollow

Note

Excluded Users

The script uses a file named excluded_users.txt to specify GitHub usernames that should be excluded from the unfollow process. This file should be located in the root directory of the script. Each line of the file should contain a single username. Users listed in this file will be ignored during the unfollow operation.

Example excluded_users.txt content:

tomnomnom
torvalds
jadijadi

Contributing

Contributions are always welcome! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request.

License

This project is licensed under the MIT License.