bot  by GramAddict

Instagram bot for automating account growth via Android device/emulator

created 4 years ago
1,389 stars

Top 29.8% on sourcepulse

GitHubView on GitHub
Project Summary

GramAddict is a free, open-source Instagram bot designed for users looking to automate account growth and engagement on Android devices. It leverages UIAutomator2 and ADB to simulate human-like interactions, avoiding API-based detection and potential bans.

How It Works

The bot operates by directly controlling an Android device (physical or emulated) via ADB and the UIAutomator2 framework. This approach mimics a user interacting with the Instagram app through touch and gestures, making it less detectable than API-based bots. It includes features like realistic delays, human-like typing, and customizable interaction patterns to further enhance stealth.

Quick Start & Requirements

  • Install: pip3 install GramAddict
  • Prerequisites: Python (>=3.6, excluding 3.10), ADB tools, Android device/emulator (Android 4.4+), Instagram app set to English.
  • Setup: Requires configuring ADB environment variables and device settings (developer options, USB debugging). Detailed setup guides are available on docs.gramaddict.org.

Highlighted Details

  • Simulates human-like typing with suggestion faking.
  • Supports spintax logic for varied comments and PMs.
  • Offers extensive interaction targets (followers, hashtags, locations, etc.).
  • Includes advanced filtering for target audience selection.
  • Provides Telegram reports for bot activity.

Maintenance & Community

The project is actively maintained by its original developer and has a community on Discord. Financial support is accepted via Open Collective.

Licensing & Compatibility

The project is licensed under the MIT License, allowing for commercial use and integration with closed-source projects.

Limitations & Caveats

The bot's effectiveness and safety depend heavily on user configuration to mimic human behavior; aggressive or non-customized actions can still lead to account bans. Python 3.10 is not supported.

Health Check
Last commit

5 months ago

Responsiveness

1 day

Pull Requests (30d)
1
Issues (30d)
2
Star History
71 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.