GramAddict
Looking for Instagram automation? I'm proud to present you a 100% free and open source Instagram bot. This bot will allow you to grow your following and engagement by liking, following, commenting and sending PM automatically with your Android phone/tablet/emulator. No root required.
# 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.
Full documentation available on [docs.gramaddict.org](https://docs.gramaddict.org) ## Telegram reports? What's that? You can get __reports__ through telegram from your bot activities! [Follow this guide to accomplish that](https://docs.gramaddict.org/#/configuration?id=telegram-reports).
> 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](https://docs.gramaddict.org/#/quickstart).
## 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](https://www.python.org/downloads/release/python-397/) for sure.
Failed? [Detailed tutorial here](https://docs.gramaddict.org/#/quickstart?id=step-1-install-python-if-not-installed).
>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!](https://www.google.com/search?q=how+to+install+pip) :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](https://developer.android.com/studio/command-line/adb). 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.com/studio/releases/platform-tools) and unzip it somewhere and remind the path
> __Warning:__ place that where you're sure you won't ever delete it, otherwise the bot won't work anymore!
2. add platform-tools path to the PATH environment variable
- if you're on __Linux/macOS__ that's pretty easy:
- open ~/.bash_profile with any text editor you like
- add the following line with the full path to the platform-tools directory: export PATH=~/Library/Android/sdk/platform-tools/:$PATH. This path may be different depending on the way you installed platform-tools
- save file and restart Terminal
- on __Windows__ there are more steps to accomplish that:
- open Windows Explorer (you can press WINKEY+E) and right-click "My Computer" on left side
- in the pop-up menu, click `Properties`
- in the `System Properties` window, click the `Advanced` tab, and then click `Environment Variables`
- in the `System Variables` window, highlight `Path`, and click `Edit`
- in the `Edit System Variables` window, press on `New`
- enter the full path for the folder platform-tools you unzipped before
- press all the Ok and restart Command Prompt
3. check that everything is fine
- write `adb version`, you should get something like that:
> C:\Users\dedil>adb version
> Android Debug Bridge version 1.0.41
> Version 30.0.5-6877874
### Step 4: Set up the device:
**Physical device**
1. First thing you have to do is to [enable developer options and USB debugging](https://developer.android.com/studio/debug/dev-options#enable).
2. connect your phone to your computer with a USB cable
3. device will ask you to allow connection. Press "Connect"
**Emulator for Mac OS**
1. Install the [Homebrew](https://brew.sh)
2. Install the [Cask](https://cask.readthedocs.io/en/latest/index.html) by running `brew install cask`
3. Add the Cask application folder to your `$PATH`, e.g. `echo 'export PATH="$HOME/.cask/bin:$PATH"' >> ~/.bash_profile` and open a new terminal or reload with `source ~/.bash_profile`
4. Install the [Android Studio](https://formulae.brew.sh/cask/android-studio)
5. Run the Android Studio and click on 'More Actions -> Virtual Device Manager', then select the device and image, I found out that Pixel 2 API 28 combo works well.
6. Run the virtual device and install the Instagram app on it, don't forget to log in.
**Verify the device with adb**
Type `adb devices` in terminal
- a list of devices attached should be displayed, if not you did something wrong
> List of devices attached
> A0B1CD2345678901 device
- this is your device ID, you have to use it only if you have more than one device connected at the same time
### Step 5: Start the bot:
This bot works only if your Instagram is in [English](https://help.instagram.com/111923612310997).
1. initialize uiautomator2: `uiautomator2 init`
2. initialize GramAddict: `gramaddict init your_ig_account_name_here`
> __Warning:__ works only if you installed the bot with pip, if you used git you have to create account folder and youraccountname folder manually.
- that script will crate all the files you need for configure and start this bot
- you will find them inside the folder `accounts/youraccountname/`
```sh
gramaddict/
run.py
accounts/
youraccountname/
config.yml
telegram.yml
filters.yml
whitelist.txt
blacklist.txt
comments_list.txt
pm_list.txt
```
3. now that you have all the requirements you have to configure the whole thing by [following this guide](https://docs.gramaddict.org/#/configuration)
4. now you're done, and you can finally start the bot: `python3 run.py --config accounts/yourusername/config.yml` or `gramaddict run --config accounts/yourusername/config.yml`
Failed? [Check this out!](https://docs.gramaddict.org/#/quickstart?id=troubleshooting)
# Bot crashes, what should I do?
The script isn't perfect and may fail sometimes. If this is the case you can open a ticket on our [discord channel](https://discord.gg/NK8PNEFGFF). In that way you won't share with anyone your Instagram account name 😈. We'll be very happy to help you!
# WOW! You dedicated so much time to this project! Why you did that for free??
Well, we used to be in three a long time ago but suddenly my two friends left. This has been an opportunity for me to improve my skills in Python and that's why I didn't leave the project and keep maintaining it.
But of course donations are very welcome, so if you think I did a great job you can buy me a beer :)
# Can I do something to make this project grown?
On GitHub there is a `star system` which indicates how good a project is. If you like this project it will be amazing if you can press the little star at the top! ⭐
# Contributors
This project exists thanks to all of our Contributors [[Contribute](https://docs.gramaddict.org/#/contributing)].
# Backers Thank you to everyone that supports us financially! 🙏 [[Become a backer](https://opencollective.com/gramaddict#backer)]
# Talk botty with us
