Completely free and open-source human-like Instagram bot. Powered by UIAutomator2 and compatible with basically any Android device 5.0+ that can run Instagram - real or emulated.
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.
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!
Of course you have to! This bot will mainly help you to get the visibility you deserve and which is Instagram not giving you.
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!
Yes! We are on discord and we count a lot of active users you can ask us whatever you want!
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. 🤗
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.
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.
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:
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
Lots of available filters to customize who you interact with
Full documentation available on docs.gramaddict.org
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? 💦
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.
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
orpython3 -V
orpy -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
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!
We create a virtual environment called .venv
and activate it:
python3 -m venv .venv
We use
venv
instead ofvirtualenv
becausevenv
is shipped directly with python3 and you don't have to install anything 🤪
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!
pip3 install GramAddict
gramaddict --version
Warning: console commands like
gramaddict init
,gramaddict dump
andgramaddict run
won't work if you installed the bot with git.
git clone https://github.com/GramAddict/bot.git gramaddict
cd gramaddict
pip3 install -r requirements.txt
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. 💪
Warning: place that where you're sure you won't ever delete it, otherwise the bot won't work anymore!
Properties
System Properties
window, click the Advanced
tab, and then click Environment Variables
System Variables
window, highlight Path
, and click Edit
Edit System Variables
window, press on New
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
Physical device
Emulator for Mac OS
brew install cask
$PATH
, e.g. echo 'export PATH="$HOME/.cask/bin:$PATH"' >> ~/.bash_profile
and open a new terminal or reload with source ~/.bash_profile
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
This bot works only if your Instagram is in English.
uiautomator2 init
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.
accounts/youraccountname/
gramaddict/
run.py
accounts/
youraccountname/
config.yml
telegram.yml
filters.yml
whitelist.txt
blacklist.txt
comments_list.txt
pm_list.txt
python3 run.py --config accounts/yourusername/config.yml
or gramaddict run --config accounts/yourusername/config.yml
Failed? Check this out!
The script isn't perfect and may fail sometimes. If this is the case you can open a ticket on our discord channel. In that way you won't share with anyone your Instagram account name 😈. We'll be very happy to help you!
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 :)
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! ⭐
This project exists thanks to all of our Contributors [Contribute].
Thank you to everyone that supports us financially! 🙏 [Become a backer]
Disclaimer: This project comes with no guarantee or warranty. You are responsible for whatever happens from using this project. It is possible to get soft or hard banned by using this project if you are not careful.