Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/8ORUZ7/github-autofollow-bot
automate github following and unfollowing with python. configurable options include targeting stargazers or users, setting page numbers, adjusting speed, and manually entering the otp code for 2fa verification.
https://github.com/8ORUZ7/github-autofollow-bot
automation
Last synced: 10 days ago
JSON representation
automate github following and unfollowing with python. configurable options include targeting stargazers or users, setting page numbers, adjusting speed, and manually entering the otp code for 2fa verification.
- Host: GitHub
- URL: https://github.com/8ORUZ7/github-autofollow-bot
- Owner: 8ORUZ7
- License: unlicense
- Created: 2024-09-02T05:29:31.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-10-24T12:26:40.000Z (3 months ago)
- Last Synced: 2024-12-12T22:38:03.093Z (27 days ago)
- Topics: automation
- Language: Python
- Homepage:
- Size: 79.1 KB
- Stars: 41
- Watchers: 2
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# github-autofollow-bot
This Python script automates the process of following or unfollowing users on GitHub. Designed for educational purposes, the script facilitates automated interactions with GitHub users and stargazers on repository pages, offering configurable options for a customizable experience. During the 2FA authentication process, you can manually enter the OTP code in Microsoft Edge to ensure seamless automation.
| Author's Note |
|---------------------------------------------------------------------------------------------------------------------------------|
| Sorry for the late update. Please disregard the "YES" option in the 2FA verification, as it requires multiple processes, especially with device passkeys. I will focus on automating the bypass of 2FA verification using GitHub recovery codes only, allowing you to manually enter the OTP code from your email. Thanks! 👀 |
## Features
- **Follow or Unfollow:** Choose to follow or unfollow users based on your preference.
- **Target Options:**
- **Stargazers:** Automatically follow or unfollow stargazers of a specified repository.
- **GitHub Users:** Follow or unfollow the followers of a specific GitHub user.
- **Default Targets:**
- **GitHub User:** https://github.com/osiristape
- **GitHub Repository:** https://github.com/gradle/gradle
- **Configurable Settings:**
- **Starting Page Number:** Specify the page number to start following or unfollowing users.
- **Speed Mode:** Choose a speed mode for the automation process to manage anti-detection.
- **2FA Authentication:**
- **Verification Option:** Manually enter the OTP code to bypass 2FA authentication. (during automation process)
- **IMPORTANT:** Please select "NO" if you have already completed your 2FA authentication. In case you miss this, the script will display a warning for you to check.
## Logging
The script provides detailed logs of the actions performed, helping you track the status and results of the automation process.
## Disclaimer
Please use this script responsibly and abide by all relevant terms and conditions while using GitHub.
## Setup
1. **Clone the repository:**
```sh
git clone https://github.com/osiristape/github-autofollow-bot.git
cd github-autofollow-bot
```
2. **Create a virtual environment and activate it:**
```sh
# Linux
python -m venv venv
source venv/bin/activate
```
```sh
# Windows
python -m venv venv
venv\Scripts\activate
```
3. **Install the dependencies:**
```sh
pip install -r requirements.txt
```
4. **Create a .env file and add your GitHub credentials:**
```sh
GITHUB_USERNAME=your_github_username
GITHUB_PASSWORD=your_github_password
```
5. **Run the script:**
```sh
python autofollow.py # use ms_edge browser
```
## License
This project is licensed under *The Unlicense*.
## Credits
This project is based on the template provided using [GitHub-Auto-Follow](https://github.com/ZigaoWang/github-auto-follow/blob/master/main.py).
I have made modifications and improvements to suit the needs of my specific use case. Please refer to the original repository for further details.