Educational GitHub Action bot that automatically follows a target user's followers, with rate-limit handling.
Warning
This project is for educational purposes only. Automated following may violate GitHub's Terms of Service and could result in account restrictions, rate limiting, or suspension. Use at your own risk.
- Fetches the followers of a target GitHub user.
- Respects a configurable daily follow limit and delay between requests.
- Handles GitHub API rate limiting automatically.
- Runs on a schedule via GitHub Actions.
Environment variables:
| Variable | Description |
|---|---|
PAT_TOKEN |
Personal access token with user:follow scope |
BOT_USERNAME |
The account running the bot |
Script constants (in follow.py):
| Variable | Description |
|---|---|
TARGET_USER |
The user whose followers will be followed |
DAILY_FOLLOW_LIMIT |
Max follows per run |
DELAY_BETWEEN_FOLLOWS |
Delay (seconds) between each follow action |
MIT