Automate bulk inviting of Facebook friends to groups — batch processing with smart delays.
Quick Start • Features • Configuration • FAQ • Contributing
Facebook Group Invite Bot is a free, open-source Facebook automation tool built with Python and Selenium. It automates the tedious process of inviting your Facebook friends to join a group. Instead of clicking through hundreds of friends one by one, this bot handles it in configurable batches with smart delays.
The bot opens Chrome, lets you log in manually, then automatically selects and invites friends in random batches — mimicking human behavior to reduce detection.
- Community Managers growing their Facebook group membership
- Marketing Professionals building engaged communities
- Event Organizers inviting friends to event-related groups
- Startup Founders bootstrapping their community
- Social Media Managers handling multiple group campaigns
- Content Creators expanding their audience reach
- Batch Processing - Invite friends in configurable random batches (5-10 per batch)
- Multi-Language - Supports French and English Facebook UI
- Smart Delays - Randomized timing between batches to avoid detection
- Graceful Shutdown - Press Ctrl+C to stop cleanly at any time
- Structured Logging - Timestamped logs for monitoring and debugging
- Headless Mode - Run without a visible browser window
- Input Validation - Validates group URLs before starting
- Configurable Limits - Set maximum number of invitations per session
- Cross-Platform - Works on Windows, macOS, and Linux
- Free & Open Source - MIT license, no API key required
| Requirement | Details |
|---|---|
| Python | Version 3.8 or higher (Download) |
| Google Chrome | Latest version (Download) |
| Facebook Account | A valid Facebook account with group invite permissions |
# 1. Clone the repository
git clone https://github.com/SoCloseSociety/FacebookInviteFriendToGroup.git
cd FacebookInviteFriendToGroup
# 2. (Recommended) Create a virtual environment
python -m venv venv
# Activate it:
# Windows:
venv\Scripts\activate
# macOS / Linux:
source venv/bin/activate
# 3. Install dependencies
pip install -r requirements.txtpython main.pyThe bot will:
- Open Chrome and navigate to Facebook
- Wait for you to log in manually
- Navigate to the specified group
- Start inviting friends in batches
python main.py --help| Option | Description | Default |
|---|---|---|
--group-url URL |
Facebook group URL | (interactive) |
--lang {fr,en} |
Facebook UI language | fr |
--batch-min N |
Min friends per batch | 5 |
--batch-max N |
Max friends per batch | 10 |
--max-invites N |
Stop after N total invites (0 = unlimited) | 0 |
--headless |
Run Chrome without visible window | Off |
-v, --verbose |
Enable debug logging | Off |
# French Facebook, default settings
python main.py --group-url "https://www.facebook.com/groups/mygroup"
# English Facebook, batches of 3-7, max 50 invites
python main.py --group-url "https://www.facebook.com/groups/mygroup" \
--lang en --batch-min 3 --batch-max 7 --max-invites 50
# Verbose mode for debugging
python main.py -vFacebook Group URL
│
▼
┌─────────────────────────┐
│ 1. Open Chrome │
│ 2. Manual Login │
│ 3. Navigate to Group │
├─────────────────────────┤
│ 4. Click "Invite" │
│ 5. Select Random Batch │
│ 6. Send Invitations │
│ 7. Wait (random delay) │
│ 8. Repeat until done │
└─────────────────────────┘
All settings are controlled via CLI arguments. See the CLI Options table above.
FacebookInviteFriendToGroup/
├── main.py # Main automation script
├── requirements.txt # Python dependencies
├── setup.sh # Quick installer script
├── assets/
│ └── banner.svg # Project banner
├── LICENSE # MIT License
├── README.md # This file
├── CONTRIBUTING.md # Contribution guidelines
└── .gitignore # Git ignore rules
The bot uses webdriver-manager to automatically download the correct ChromeDriver. If you encounter issues:
pip install --upgrade webdriver-managerFacebook occasionally updates its UI. If the bot can't find buttons:
- Check the Issues page for known problems
- Try switching language with
--lang enor--lang fr - Open a new issue with the error message
Ensure the group URL format is: https://www.facebook.com/groups/...
Make sure you are a member of the group with invite permissions.
Q: Is this free? A: Yes. Facebook Group Invite Bot is 100% free and open source under the MIT license.
Q: Do I need a Facebook API key? A: No. This tool uses browser automation (Selenium), so no API key or developer account is needed.
Q: How many friends can I invite?
A: There is no hard limit in the tool. Use --max-invites to set your own limit. Be mindful of Facebook's usage policies.
Q: Does it work with Facebook Pages? A: No. This tool is designed for Facebook Groups only.
Q: Can I run it without opening a browser?
A: Yes. Use --headless mode: python main.py --headless
Q: Does it work on Mac / Linux? A: Yes. The bot is fully cross-platform and works on Windows, macOS, and Linux.
| Feature | Facebook Group Invite Bot | Manual Inviting | Facebook Ads |
|---|---|---|---|
| Price | Free | Free | $5-50/day |
| Bulk invite | Yes (batches) | No | N/A |
| Configurable batches | Yes | N/A | N/A |
| Open source | Yes | N/A | No |
| API key required | No | No | Yes |
| Cross-platform | Yes | Yes | Web only |
| Headless mode | Yes | N/A | N/A |
Contributions are welcome! Please read the Contributing Guide before submitting a pull request.
This project is licensed under the MIT License.
This tool is provided for educational and personal use purposes only. Use it responsibly and in compliance with Facebook's Terms of Service. The authors are not responsible for any misuse or consequences arising from the use of this software.
If this project helps you, please give it a star!
It helps others discover this tool.
Built with purpose by SoClose — Digital Innovation Through Automation & AI
Website •
LinkedIn •
Twitter •
Contact