Insomniac: Instagram bot for automated Instagram interaction using Android device via ADB
Project description
Insomniac
Simple and friendly automation tool which brings more followers to your Instagram account and engages existing audience. Automatic liking, commenting, following/unfollowing, scraping and sending direct messages. Everything works from your own Android phone/tablet/emulator under your full control. No root required.
IMPORTANT NOTICE:
Insomniac is completely free & opensource as of v3.9.0. "Extra features" that used to be paid are now available in this repo for free. But the project is not being actively supported right now. I cannot guarantee its workability for all Instagram and Android versions, since fresh updates require Insomniac code modifications as well. However, the code is well-structured, which makes the repo a good base for adding your changes to adjust Insomniac for your setup.
Why Automating Instagram Activity (Liking, Following, etc.)?
💸 If you want just to increase your followers count or get more likes, there's a bunch of companies that will give you that immediately for a few $$$. But most likely your audience will be merely bots and mass-followers.
🌱 If you want to get engaged followers, that will be interested in your content and probably will pay you for your services, then automation is the right way.
📈 This Instagram bot provides you methods to target on the audience that is most likely interested in you. Generally these methods are (with growing complexity):
- Interact with users who follow specific bloggers or like posts by specific hashtags. Easiest level, just one Insomniac command.
- Same, but from those users interact only with your target audience. Meaning that you can pick users by specific parameters: by gender, by language, by posts count, etc. Still one Insomniac command, but you'll have to add a file with "filtering" parameters.
- Scrape your target audience from other accounts and use your main account only to interact. This reduces the app time-spent of your main account and makes the main account significantly less suspicious to Instagram. You'll have to learn how to use Insomniac "configs" and combine them into an infinite loop – so that everything would work by itself.
Getting Started
We have an awesome documentation where you will find installation instructions for Windows, macOS, Ubuntu and Raspberry Pi.
Basically all you need is a machine with Python 3 and a connected Android phone. In case you don't have a phone, we have posts explaining how to make it work with a free Android emulator: Windows, macOS, Ubuntu.
Please use a specific Instagram app version which you can find in the header (click on the "IG version" badge). That's because Instagram UI gets changed pretty often, so we guarantee a stable work only on versions up to a specific number.
The simplest Insomniac command to start with would be something like this:
python3 start.py --interact @natgeo-followers
But better check the docs.
Filtering
Eventually you will come to the point where you want to avoid accounts with thousands of followings. Or with zero posts. Or with some other red flags which you will choose for yourself. Here's the full list:
Parameter | Value | Description |
---|---|---|
skip_business |
true/false |
skip business accounts if true |
skip_non_business |
true/false |
skip non-business accounts if true |
min_followers |
100 | skip accounts with less followers than given value |
max_followers |
5000 | skip accounts with more followers than given value |
min_followings |
10 | skip accounts with less followings than given value |
max_followings |
1000 | skip accounts with more followings than given value |
min_potency_ratio |
1 | skip accounts with ratio (followers/followings) less than given value (decimal values can be used too) |
max_potency_ratio |
1 | skip accounts with ratio (followers/followings) higher than given value (decimal values can be used too) |
privacy_relation ` |
"only_public" / "only_private" / "private_and_public" |
choose with accounts of which type you want to interact, "only_public" by default |
min_posts |
7 | minimum posts in profile in order to interact |
max_digits_in_profile_name |
4 | maximum amount of digits in profile name (more than that - won't be interacted) |
skip_profiles_without_stories |
true/false |
skip accounts that doesnt have updated story (from last 24 hours) |
blacklist_words |
["word1", "word2", "word3", ...] |
skip accounts that contains one of the words in the list in the profile biography |
mandatory_words |
["word1", "word2", "word3", ...] |
skip accounts that doesn't have one of the words in the list in the profile biography |
specific_alphabet |
["LATIN", "ARABIC", "GREEK", "HEBREW", ...] |
skip accounts that contains text in their biography/username which different than the provided alphabet list |
skip_already_following_profiles |
true/false |
skip accounts that your profile already followed, even if not followed by the bot |
only_profiles_with_faces |
"male"/"female"/"any" |
analyze profile picture and leave only profiles with male/female/any face on the avatar |
You can find how to use them in the documentation. But don't tense up, it's as easy as create a file called "filters.json" and put it into a folder.
Command-Line Arguments vs Configs
At some point we realised that there appeared so many Insomniac command-line arguments that they became difficult to handle.
Tip: by the way, you can see all available commands by running python3 start.py
with no arguments.
What we did is we introduced a concept of "configs". So instead of writing a veeeery long command like this:
python3 start.py --interact @natgeo-followers @natgeo-following amazingtrips-top-likers amazingtrips-recent-likers P-antartica-top-likers P-antartica-recent-likers amazingtrips-top-posts amazingtrips-recent-posts P-antartica-top-posts P-antartica-recent-posts --speed 4 --wait-for-device --likes-count "1-2" --likes-percentage "75" --interactions-limit-per-source "12-16" --successful-interactions-limit-per-source "6-8" --total-interactions-limit "100-200" --total-successful-interactions-limit "50-60" --total-likes-limit "50-60" --total-get-profile-limit "300-400" --session-length-in-mins-limit "50-60"
You can just write this:
python3 start.py --config-file interact-likes-only.json
Where interact-likes-only.json is a config file which you will just put in the folder where you run the command from.
The interesting thing about configs is that you can add a field next_config_file
in any config. So a config will launch another config. You can also specify a sleeping time between them using the repeat
field (in minutes). Using this technique you can create infinite loops of configs, see examples here. Such loops are called flows.
Scraping and Interacting with Targets
Basically to interact with targets you can run
python3 start.py --interact-targets
This means that Insomniac will search for targets either in targets.txt file (if provided) or in the database. The only way for targets to appear in the database is to use scraping. Scraping basically means searching for specific accounts to interact with as the targets for the main account. So when scraping you always have to specify this main account like this: --scrape-for-account username
.
See scraping config examples here.
Extra Features
As you can imagine, this project's development and support takes a lot of energy, so in order to continue working we made part of the features paid. These features are called extra features, because they are not necessary to run the project. But most likely you'd like to have them.
You can find the full list of extra features in the documentation.
As a free bonus you'll get a Telegram bot @your_insomniac_bot which can send you current stats. So you'll be able to monitor your setup health from anywhere. Read more in one of our Patreon posts.
Community
We have a Discord server which is the most convenient place to discuss all bugs, new features, Instagram limits, etc. If you're not familiar with Discord, you can also join our Telegram chat. And finally, all useful info is posted on our Patreon page.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file insomniac-3.9.0.tar.gz
.
File metadata
- Download URL: insomniac-3.9.0.tar.gz
- Upload date:
- Size: 50.0 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d127875cb0ff49928ad0b11aceb69f25448ce70a201fb40e0121ff461db8430d |
|
MD5 | 0e2cabec868650e6a52a5bc17f81c140 |
|
BLAKE2b-256 | b81e29b27068e433ed16b74cfb9cea1ec5d887919e33f594a0aac20c0846b504 |
File details
Details for the file insomniac-3.9.0-py3-none-any.whl
.
File metadata
- Download URL: insomniac-3.9.0-py3-none-any.whl
- Upload date:
- Size: 50.0 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 95642d3ecb49663b0f58584cf173cd42ad108f3a30d443e6bf4789c8298abc31 |
|
MD5 | ba969cebae34a33331d27959676084b5 |
|
BLAKE2b-256 | 68a87e41337bb79672f7b18447e215f2b80351d79a05aa850d201b16039c9090 |