A powerful command-line interface (CLI) tool for managing and tracking GitHub followers and following relationships. This tool allows you to list your followers, see who you're following, identify users who don't follow you back, find unfollowers, and even automatically unfollow users who don't follow you.
- List Followers: Display all users who follow you.
- List Following: Show all users you are following.
- List Non-Followers: Identify users you follow who do not follow you back.
- List Unfollowers: Track users who have unfollowed you since the last check.
- Unfollow Non-Followers: Automatically unfollow users who do not follow you back.
- Python 3.6 or higher
- GitHub Personal Access Token (PAT) with appropriate permissions. Generate a PAT here.
-
Clone the Repository:
git clone https://github.com/nimanikoo/GitHub-Followers-management.git cd GitHub-Followers-management -
Set Up a Virtual Environment (Recommended):
python -m venv venv source venv/bin/activate # On Windows use `venv\Scripts\activate`
-
Install Dependencies:
pip install -r requirements.txt
To use the GitHub CLI tool, run the following command:
python github_cli.py [command]-
followers: List all followers.python github_cli.py followers
-
following: List all users you are following.python github_cli.py following
-
non-followers: List users you follow who do not follow you back.python github_cli.py non-followers
-
unfollowers: List users who have unfollowed you since the last check.python github_cli.py unfollowers
-
unfollow-non-followers: Automatically unfollow users who do not follow you back.python github_cli.py unfollow-non-followers
github_cli.py: Main script for handling commands and user interactions.github/api.py: Functions for interacting with the GitHub API.github/utils.py: Utility functions for data management, including saving and loading followers.requirements.txt: Lists necessary Python libraries.env: Github Username and Token values
GITHUB_USERNAME=USERNAME
GITHUB_TOKEN=TOKEN
You can use env sample file to define your own values then use command below to export all variables into the environment:
export $(grep -v '^#' env | xargs)Contributions are welcome! If you have suggestions or improvements, please open an issue or submit a pull request.
This project is licensed under the MIT License.
For any questions or feedback, please reach out to nikoonazar.nima@gmail.com.
Note: Ensure to replace [your-github-username] and [your-github-token] with your actual GitHub username and personal access token when using the tool.