Instagram Unfollower Bot - Integrated Project Structure

I'll organize the project into a logical folder structure and integrate the direct Instagram login approach with the Telegram bot. Here's a comprehensive overview of the project files and their integration.

Project Overview

I've created a comprehensive solution that integrates direct Instagram API access with your Telegram bot. Here's a breakdown of the key files and their purposes:

Core Files

1. instagram_api.py

   • Direct Instagram API client using HTTP requests
   • Handles login, followers/following retrieval, and follow/unfollow actions
   • Uses the approach from your code snippet with enhanced error handling

2. instagram_bot_direct_login.py

   • Integrates the direct API with the Telegram bot
   • Provides methods for handling login, checking unfollows, and finding non-mutual followers
   • Designed to work alongside your existing bot

3. integration_example.py

   • Shows how to integrate the direct login with your main bot
   • Adds a /direct_login command to use the direct API approach
   • Adds a /check_direct command to check unfollows using the direct API

4. main.py

   • Entry point that initializes both the original bot and the direct login handler
   • Sets up webhook and FastAPI server
   • Handles background tasks like proxy setup

Integration Points

The direct Instagram API login is integrated with your Telegram bot in several ways:

1. Direct Login Command: Users can type /direct_login to use the direct API approach
2. Fallback Mechanism: The bot can use direct API when instaloader fails
3. Shared Data: Both approaches share the same data storage for followers/following

How It Works

1. When a user initiates login via Telegram, they can choose between:

   • Regular login (using instaloader)
   • Direct login (using HTTP requests)

2. The direct login process:

   • Asks for username and password
   • Makes direct HTTP requests to Instagram's login API
   • Retrieves followers and following lists
   • Stores the data in the same format as the original bot

3. For checking unfollows:

   • The bot can use either method
   • Both approaches update the same data storage
   • Results are presented to the user in the same format

This integration provides a more reliable experience, especially when Instagram makes changes that might break the instaloader library.

Instagram Unfollower Bot - Organized Project Structure

I'll organize the project into a logical folder structure, separating the new direct API implementation (version 12) into its own folder. Here's a comprehensive overview of all files and how to run the system.

Folder Structure

File Descriptions

Main Application Files

1. main.py

   • Entry point for the application
   • Initializes both the original bot and the direct API implementation
   • Sets up the FastAPI server and webhook
   • Handles background tasks like proxy setup

2. instagram_bot.py

   • Original bot implementation using the instaloader library
   • Handles Telegram bot commands and callbacks
   • Manages user data, followers, and following lists
   • Includes FastAPI routes for web interface

3. proxy_manager.py

   • Manages proxies for Instagram connections
   • Fetches, validates, and rotates proxies
   • Provides location-based proxy selection

4. language_support.py

   • Provides multilingual support (English and Arabic)
   • Contains text strings for all bot messages

5. setup_proxies.py

   • Script to set up and validate proxies
   • Can be run independently or as part of the main application

Direct API Implementation (Version 12)

6. instagram_api.py

   • Direct Instagram API client using HTTP requests
   • Implements login, followers/following retrieval, and follow/unfollow actions
   • More resilient to Instagram API changes than instaloader

7. instagram_bot_direct_login.py

   • Integrates the direct API with the Telegram bot
   • Provides methods for handling login, checking unfollows, and finding non-mutual followers
   • Designed to work alongside the original bot

8. integration.py

   • Shows how to integrate the direct login with the main bot
   • Adds commands to use the direct API approach
   • Can be used as a standalone example

Web Interface

9. templates/*.html

   • HTML templates for the web interface
   • Includes login, success, challenge, and login process pages

10. static/css/styles.css

    • CSS styles for the web interface

11. static/images/logo.png

    • Logo image for the web interface

Configuration

12. requirements.txt

    • Lists all Python dependencies

13. .env.example

    • Example environment variables needed to run the bot

14. docker/Dockerfile

    • Docker configuration for building the container

15. docker/docker-compose.yml

    • Docker Compose configuration for running the container

How to Run the System

Option 1: Running Directly

1. Set up the environment:

   # Clone the repository git clone https://github.com/yourusername/instagram-unfollower-bot.git cd instagram-unfollower-bot # Create virtual environment python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate # Install dependencies pip install -r requirements.txt # Create .env file from example cp .env.example .env # Edit .env with your credentials

2. Configure environment variables: Edit the .env file with your:

   • TELEGRAM_TOKEN: Your Telegram bot token
   • ADMIN_CHAT_ID: Your Telegram chat ID
   • WEBHOOK_URL: URL for the webhook
   • WEB_INTERFACE_URL: URL for the web interface
   • ENCRYPTION_KEY: Key for encrypting credentials
   • BOT_USERNAME: Your bot's username without @

3. Run the application:

   python app/main.py

Option 2: Running with Docker

1. Set up environment variables:

   cp .env.example .env # Edit .env with your credentials

2. Build and run with Docker Compose:

   cd docker docker-compose up -d

Integration of Direct API with Original Bot

The direct API implementation (Version 12) is designed to work alongside the original bot. Here's how they integrate:

1. In main.py:

   • Both implementations are initialized
   • Handlers for both are added to the Telegram application
   • They share the same data storage

2. Command Integration:

   • /start - Shows the main menu
   • /direct_login - Uses the direct API for login
   • /check_direct - Uses the direct API to check unfollows

3. Data Sharing:

   • Both implementations use the same data files
   • Followers and following lists are stored in the same format
   • Credentials are encrypted and stored securely

Key Features of Direct API Implementation (Version 12)

1. Direct HTTP Requests:

   • Uses the requests library to communicate directly with Instagram
   • No dependency on third-party libraries like instaloader
   • More resilient to Instagram API changes

2. Enhanced Error Handling:

   • Better detection of login issues
   • Handles two-factor authentication
   • Detects and reports checkpoint challenges

3. Proxy Support:

   • Uses the same proxy manager as the original bot
   • Supports location-based proxy selection
   • Automatically rotates proxies on failure

4. Seamless Integration:

   • Works alongside the original bot
   • Shares the same data storage
   • Provides the same user experience

When to Use Which Implementation

• Original Bot (instaloader):

  • For basic functionality
  • When you need detailed profile information
  • For downloading media

• Direct API (Version 12):

  • When instaloader fails due to API changes
  • For more reliable login
  • For faster followers/following retrieval
  • When encountering rate limiting issues

By having both implementations available, your bot becomes more resilient to Instagram's frequent API changes and restrictions.