Skip to content

sirajahmedx/bots

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 

Repository files navigation

GitHub Bot Project

Three automation bots for GitHub: generate commits, follow users, and unfollow users.

⚠️ Important Disclaimer

Use at your own risk! These tools interact with GitHub's API to automatically follow/unfollow users. Please be aware that:

  • Automated following/unfollowing may violate GitHub's Terms of Service
  • Excessive automation could result in account restrictions or suspension
  • Always respect rate limits and use reasonable delays
  • Consider the ethical implications of automated social interactions

🏗️ Project Structure

bot/
├── github/                    # Main GitHub bots folder
│   ├── commit/               # GitHub Commit Bot (Standalone)
│   │   ├── index.js         # Commit bot application
│   │   ├── data.json        # Commit data file
│   │   ├── package.json     # Commit bot dependencies
│   │   └── README.md        # Commit bot documentation
│   │
│   ├── follow/               # GitHub Auto-Follow Bot (Standalone)
│   │   ├── index.js         # Follow bot application
│   │   ├── github.js        # GitHub API with follow functionality
│   │   ├── config.js        # Configuration management
│   │   ├── logger.js        # Logging utilities
│   │   ├── progress.js      # Progress tracking
│   │   ├── package.json     # Follow bot dependencies
│   │   ├── config.json      # Follow bot configuration
│   │   ├── run.sh           # Follow bot runner (executable)
│   │   ├── .env.example     # Environment template
│   │   ├── .gitignore       # Git ignore rules
│   │   ├── logs/            # Follow bot logs directory
│   │   └── README.md        # Follow bot documentation
│   │
│   └── unfollow/            # GitHub Auto-Unfollow Bot (Standalone)
│       ├── index.js         # Unfollow bot application
│       ├── github.js        # GitHub API with unfollow functionality
│       ├── config.js        # Configuration management
│       ├── logger.js        # Logging utilities
│       ├── progress.js      # Progress tracking
│       ├── package.json     # Unfollow bot dependencies
│       ├── config.json      # Unfollow-specific configuration
│       ├── run.sh           # Unfollow bot runner (executable)
│       ├── unfollow-run.sh  # Alternative runner (executable)
│       ├── .env.example     # Environment template
│       ├── .gitignore       # Git ignore rules
│       ├── logs/            # Unfollow bot logs directory
│       ├── SUMMARY.md       # Quick reference
│       └── README.md        # Unfollow bot documentation
│
└── README.md               # This file

🚀 Quick Start

Commit Bot (No Setup Required)

cd github/commit
node index.js
git push

Follow/Unfollow Bots (Requires GitHub Token)

  1. Setup:
cd github/follow  # or github/unfollow
cp .env.example .env.user1
# Add your GitHub token to .env.user1
  1. Run:
./run.sh user1 octocat followers

🔧 Creating GitHub Personal Access Tokens

  1. Go to GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)
  2. Click "Generate new token (classic)"
  3. Give it a name and select the user:follow scope
  4. Copy the token to your .env.user1 file

Bots Overview

1. Commit Bot

  • Purpose: Creates 10 commits with random past dates
  • Usage: cd github/commit && node index.js && git push
  • No token required

2. Follow Bot

  • Purpose: Follows users from a target account's followers/following
  • Usage: cd github/follow && ./run.sh user1 username followers
  • Requires GitHub token

3. Unfollow Bot

  • Purpose: Unfollows users from a target account's followers/following
  • Usage: cd github/unfollow && ./run.sh user1 username followers
  • Requires GitHub token

Important Notes

  • Each bot is independent with its own dependencies
  • Follow/unfollow bots support multiple users (user1-user4)
  • Progress is automatically saved and can be resumed
  • Use at your own risk - may violate GitHub ToS

About

A simple GitHub automation toolkit with three standalone bots for following users, unfollowing users, and generating fake commits. Features intelligent rate limiting, progress persistence, and human-like behavior to make automation safe and effortless.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors