https://github.com/blackvoidx/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.
https://github.com/blackvoidx/github-follow-insights
Last synced: 4 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/blackvoidx/github-follow-insights
- Owner: blackvoidx
- License: mit
- Created: 2024-04-22T18:05:44.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2025-02-16T13:41:44.000Z (over 1 year ago)
- Last Synced: 2025-10-09T04:13:02.283Z (9 months ago)
- Language: Python
- Size: 25.4 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
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.
### Preview
### Installation
> [!IMPORTANT]
> #### Requirements
> - Python 3.6 or later
1. Clone the repository:
```bash
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](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens).
### Usage
1. For get the list of users:
```bash
python main.py --token YOUR_GITHUB_TOKEN
```
2. Get and Unfollow the founded users:
```bash
python main.py --token YOUR_GITHUB_TOKEN --unfollow
```
3. For using proxy:
```bash
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:
> ```bash
> 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.