Tool for automated Instagram interactions
Project description
Welcome to Instappium
This project is highly inspired and takes some of the code back from instapy (https://github.com/timgrossmann/InstaPy) originally developped by Tim Grossmann and community
The goal of this project is to try to hide the automation behind a legitimate phone app, so it is easier to bypass any "easy" detection algorithm that may be done. It is also an attempt at not having a very detailed script that describe the actions to be done. Ideally we would like to let Instappium choose the actions it wants to do in a random manner and using the exact same flow as the app interface can provide so it is more natural.
Important note: the project is in heavy development at the moment so it is probably not fully usable or will crash a lot. There is no need to open issues/report, what we need is your help in fixing the code. So fork the repo and propose a pull request that fix it. (https://guides.github.com/activities/forking/)
Installation
You will need:
- Appium
- an Android simulated device (for example using android studio and creating a device)
- the app, you can find it on apkpure
Qwick How to
-
Download and install appium
-
Download and install Andriod Studio
-
Download the apk
Note: make sure to map the correct apk variant with the CPU/ABI flavor of your android device
-
Start a new Android Studio (AS) project:
- Launch AS
- Click "Configure -> AVD Manager"
-
Create a new emulator in the AVD manager by Click "Create Virtual Device" and follow it steps
-
Go to the android studio terminal (bottom of the screen):
cd C:\Users\YOUR NAME HERE\AppData\Local\Android\Sdk\platform-tools
or whatever path you have to theplatform-tools
folder -
Install the apk:
adb install [INSERT THE PATH TO YOUR DOWNLOADED INSTAGRAM APK]
-
Add the
ANDROID_HOME
variable to your environment variables with path being the path to[FULL PATH HERE]/Sdk/
mentioned in earlier steps
For Ubuntu: Dont use the symbol '~' in the path, because the appium parser doesnt seem to recognize it.
-
Start your appium server with default settings
-
Launch the emulator
-
Give it time for the emulator to setup everything (AS will stop showing messages in the bottom)
-
Make sure you enter the right device name on your test file (You can find it by running
adb devices
in the android terminal) along with your instagram credentials -
Test your instappium
import instappium
session = instappium.InstAppium(username='xxx', password='yyy', device='emulator-5554', show_logs=True)
session._webdriver.go_search('whoever you want', 'accounts')
# doing one action using the FSM
from instappium.engine import FSMSession
fsm = FSMSession(session._webdriver)
# should respond idle
fsm.state
# let's go to the home page
fsm.go_homepage()
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
Hashes for instappium-0.0.2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8be359c54d742f0b571731b38303887b5b84cc1002c3fa2a850b981e04fa5be8 |
|
MD5 | f615f04cbb3c112daa5bb90a96b91b9e |
|
BLAKE2b-256 | 3f9b1b0ece6323b7efc72e38a7cc9c00b9bfb000c23ab654c1504dd477f55821 |