Why should I automate my Instagram account?

It's very hard nowadays to grow an account. Have you ever been on the explore page? IG will show your post only to close accounts & accounts you interact most with, you will never be on the explore page. Nobody will see your beautiful photos, your hilarious memes, or whatever you are posting. But now you can do something about that! With GramAddict you can get noticed easily, and if you really deserve it, your account will grow super fast!

So, do I need to publish good content to grow?

Of course you have to! This bot will mainly help you to get the visibility you deserve and which is Instagram not giving you.

Ok but I don't know how to start this journey...

Don't worry about that now, it's not that hard to start botting with GramAddict! I tried to make it as noob-friendly as possible. In any case, if you follow the docs with all the steps provided, you will make it! You are also invited to join our community and ask for any help!

There is a community around this project?

Yes! We are on discord and we count a lot of active users you can ask us whatever you want!

I saw there are a lot of similar projects on GitHub, why should I choose this one?

You're right, there are plenty of other bot solutions. Most of them use API requests. However, you will get your account banned if you use API (1-30 days)! There's also a very similar project to this one, yet it's not free and the dev doesn't care about the community much. They removed few lines from the core and ask you for a subscription plan in order to use those features. Furthermore, you don't even know what's the real code during execution - it's encrypted. And if they are stealing something else? Who knows? I don't. This bot is free to use and open source, you won't get charged for few extra lines, EVER. I'm focused on the community and not on finding ways how to get money out of this project. I really care about the community and every dev should too. 🤗

So this bot does not use API?

No this bot is working through adb and is powered by uiautomator2 which is a testing wrapper for Android devices. In fact, your device (or an emulator) is used for doing the botting sh*it. That's very secure compared to other botting systems around there. I also made it look as much human as possible. You can think about the bot as a stupid friend using your phone and doing things for you. The example bottom is quite old but will show you what we are talking about.

Urra! I'll never get banned anymore with this bot!

No no no, wait! 🤦 You have to configure the bot for doing things as a human would do. Do you really spend all the day scrolling on Instagram? If yes contact a medic :P You don't have to do so many actions or Instagram will block you. That appends even if you do that by your hands.. Have you ever added a lot of people in a row and got blocked for that action? Or spamming people with a link in PM? DON'T F*CKING DO THAT

Be gently and anonymous and nobody will notice that you're botting, trust me.

Do I need a computer for running the bot?

Yes, but you can also run it directly on your phone!!

In any case, you can decide to use a physical device or an emulator. If you're under Windows I suggest you use Memu, under Mac OS we found out that Android studio works well (Installable with homebrew). For hosting the bot you can use:

• your computer (with Windows, macOS, or Linux)
• a Raspberry (which is a cheap little pc Linux based)

Cool! What can I do with this bot?

There are lots of cool features you can use for free!

• Works without rooting

• Works with both emulators and physical devices

• Can be used stand-alone (without the use of a computer)

• Includes realistic random human-like delays and actions

• Can watch stories while interacting

• Comment post with emojis and spintax logic

• Send PM

• Type like a human (letter by letter by faking using suggestions. For example, you won't type H - e - l - l - o letter by letter but something like H - He - Hello)

• Browse carousels and watch their contents

• Watch videos for a specific amount of time

• Scheduler

• Getting tasty telegram reports

• Supports multiple actions in one session

• Lots of customizable limits to keep your account safe from soft bans

• Available interactions

  • interact with a user's followers or following
  • interact with a top or recent hashtag's post likers
  • interact with a top or recent hashtag post
  • interact with a top or recent place's post likers
  • interact with a top or recent place post
  • interact with user's post likers
  • interact with a single blogger
  • interact with your feed
  • interact with users from a list (*.txt)
  • interact with posts from links inside a list (*.txt)
  • unfollow any followers
  • unfollow any followers, followed by bot
  • unfollow any followers, followed by bot, who don't follow you back
  • unfollow from a list (*.txt)
  • scrape mode for collecting usernames instead of interacting with them (you will find more information about that in the doc)

• Lots of available filters to customize who you interact with

  • you can blacklist people to avoid interacting with them
  • you can whitelist people to not remove them when you unfollow people
  • biography main characters and language
  • profile name main characters
  • private / public / business / non business account
  • number of posts / followers / following ... and more!

Full documentation available on docs.gramaddict.org

Telegram reports? What's that?

You can get reports through telegram from your bot activities! Follow this guide to accomplish that.

In this case trends are negative because I use this account only for tuning this bot, and it's private... I didn't accept anyone lately so the trends are meh :P

Cool, isn't it? 💦

Quick start

Now that you're there you still don't know how to install that whole thing. I'll try to help you accomplish that with a short tutorial. The full is available here.

What do you need:

• a computer (with Windows, macOS or Linux)
• Python installed on your machine (with pip)
• Adb tools
• a physical device or an emulator (with Android 4.4+)

Step 1: Install Python (>=3.6):

Python 3.10 is currently not supported!

If you're on Linux or macOS you should have Python and Git installed, just check that your Python version is >= 3.6.

On Windows you have to install it for sure.

Failed? Detailed tutorial here.

A little reminder: we refer to python with python3. You may also have python2 installed if you're on Linux for example. If you're on Windows you can use python instead of python3. Check which python alias you have to use by typing python -V or python3 -V or py -V and use the right one for the rest of the tutorial.

Check that pip3 is installed by typing pip3 -V If that returns an error you have to install it! How? Google is your best friend! :P

Step 2: Install GramAddict:

You can install GramAddict in two ways: with pip or with git. Is good practice creating virtual environments when you install a new package. That will save you from a lot of problems!

Create a virtual environment

We create a virtual environment called .venv and activate it:

• create a directory where you will create the new environment
• write in console: python3 -m venv .venv

  We use venv instead of virtualenv because venv is shipped directly with python3 and you don't have to install anything 🤪

• activate the .venv:
  • source .venv/bin/activate on Linux/macOS
  • .venv\Scripts\activate.bat on Windows cmd
  • .venv\Scripts\activate.ps1 on Windows PowerShell

    If you activate the venv correctly, you will see a little (.venv) on the left side of the command line!

With pip (I suggest you this way):

• install the package: pip3 install GramAddict
• check if it's installed: gramaddict --version
• if everything is fine you will get the GramAddict version installed 🥳

With git:

Warning: console commands like gramaddict init, gramaddict dump and gramaddict run won't work if you installed the bot with git.

• clone the project: git clone https://github.com/GramAddict/bot.git gramaddict
• enter the gramaddict folder: cd gramaddict
• install the requirements: pip3 install -r requirements.txt

Step 3: Install adb:

Adb stands for Android Debug Bridge. It's needed for making this bot working properly. I think this one is the hardest part to accomplish but don't give up! You can do it, with my help. 💪

1. download [this package](https://developer.android