Telegram follow-for-follow bot to grow your Instagram — automated, fair, and free.

Quick Start • Features • Configuration • FAQ • Contributing

---

What is BoosterBot?

BoosterBot is a free, open-source Telegram bot that automates Instagram follow-for-follow exchanges. Users join a Telegram group, submit their Instagram profile, and the bot pairs them with other users for mutual follows. It tracks all actions in a SQLite database and manages balances to ensure fairness.

Instead of manually finding follow-for-follow partners, the bot handles matchmaking, verification, and balance tracking automatically.

Who is this for?

• Instagram Creators looking to grow their follower count organically
• Social Media Managers bootstrapping new accounts
• Community Builders creating engagement groups
• Growth Hackers experimenting with follow-for-follow strategies
• Developers learning Telegram bot development with Python

Key Features

• Telegram Bot Interface - Users interact via Telegram commands
• Instagram Integration - Automated follow actions via instagrapi
• SQLite Database - Persistent user data and action tracking
• Balance System - Fair exchange — follow others to earn follows back
• Admin Panel - Bot owner can manage users and settings
• Configurable - Settings via bot_settings.ini
• Cross-Platform - Works on Windows, macOS, and Linux
• Free & Open Source - MIT license

---

Quick Start

Prerequisites

Requirement	Details
Python	Version 3.8 or higher (Download)
Telegram Bot Token	Create one via @BotFather
Instagram Account	A valid Instagram account for the bot

Installation

# 1. Clone the repository
git clone https://github.com/SoCloseSociety/BoosterBot.git
cd BoosterBot

# 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 python-telegram-bot instagrapi

Configure

Edit bot_settings.ini with your bot token and Instagram credentials:

[BOT]
token = YOUR_TELEGRAM_BOT_TOKEN
owner_id = YOUR_TELEGRAM_USER_ID
ig_username = YOUR_INSTAGRAM_USERNAME
ig_password = YOUR_INSTAGRAM_PASSWORD

Run

python main.py

---

How It Works

Telegram Group
       │
       ▼
┌─────────────────────────────┐
│        BoosterBot           │
│                             │
│  1. User joins via Telegram │
│  2. Submits Instagram link  │
│  3. Bot pairs with others   │
│  4. User follows partner    │
│  5. Bot verifies & credits  │
│  6. Balance updated in DB   │
└─────────────────────────────┘
       │
       ▼
SQLite Database (bot_data.db)

---

Configuration

Setting	Description
token	Telegram bot token from @BotFather
owner_id	Your Telegram user ID (for admin commands)
ig_username	Instagram username for the bot
ig_password	Instagram password for the bot

---

Project Structure

BoosterBot/
├── main.py              # Bot logic and handlers
├── bot_settings.ini     # Bot configuration
├── bot_data.db          # SQLite database
├── assets/
│   └── banner.svg       # Project banner
├── CONTRIBUTING.md      # Contribution guidelines
├── LICENSE              # MIT License
├── README.md            # This file
└── .gitignore           # Git ignore rules

---

Troubleshooting

Bot doesn't start

1. Check your bot_settings.ini — make sure the token is correct
2. Make sure python-telegram-bot and instagrapi are installed
3. Check the console for error messages

Instagram login fails

1. Your account may require 2FA — disable it for the bot account
2. Instagram may have rate-limited the account — wait a few hours
3. Try logging in manually first to clear any security challenges

Follow actions fail

1. Instagram may have restricted the bot account — wait before retrying
2. The target profile may be private or have follow restrictions
3. Check the logs for specific error messages

---

FAQ

Q: Is this free? A: Yes. BoosterBot is 100% free and open source under the MIT license.

Q: Do I need an API key? A: You need a Telegram bot token (free from @BotFather). No paid APIs required.

Q: Is this safe for my Instagram account? A: Use reasonable limits. Aggressive follow/unfollow patterns can trigger Instagram restrictions.

Q: Can I run multiple instances? A: Yes, with different bot tokens and Instagram accounts.

Q: Does it work on Mac / Linux? A: Yes. Fully cross-platform.

---

Alternatives Comparison

Feature	BoosterBot	Manual F4F	Paid Growth Services
Price	Free	Free	$20-100/mo
Automated	Yes	No	Yes
Fair exchange	Yes (balance system)	Trust-based	N/A
Open source	Yes	N/A	No
Telegram integration	Yes	Manual	No

---

Contributing

Contributions are welcome! Please read the Contributing Guide before submitting a pull request.

---

License

This project is licensed under the MIT License.

---

Disclaimer

This tool is provided for educational purposes only. Automated following may violate Instagram's Terms of Service. Use responsibly and at your own risk. The authors are not responsible for any account restrictions or consequences.

---

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}