Skip to main content

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:

  1. Appium
  2. an Android simulated device (for example using android studio and creating a device)
  3. the app, you can find it on apkpure

Qwick How to

  1. Download and install appium

  2. Download and install Andriod Studio

  3. Download the apk

    Note: make sure to map the correct apk variant with the CPU/ABI flavor of your android device

  4. Start a new Android Studio (AS) project:

    • Launch AS
    • Click "Configure -> AVD Manager"
  5. Create a new emulator in the AVD manager by Click "Create Virtual Device" and follow it steps

  6. 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 the platform-tools folder

  7. Install the apk: adb install [INSERT THE PATH TO YOUR DOWNLOADED INSTAGRAM APK]

  8. 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.

  1. Start your appium server with default settings

  2. Launch the emulator

  3. Give it time for the emulator to setup everything (AS will stop showing messages in the bottom)

  4. 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

  5. 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

instappium-0.0.2.tar.gz (31.9 kB view details)

Uploaded Source

Built Distribution

instappium-0.0.2-py2.py3-none-any.whl (33.7 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file instappium-0.0.2.tar.gz.

File metadata

  • Download URL: instappium-0.0.2.tar.gz
  • Upload date:
  • Size: 31.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.4

File hashes

Hashes for instappium-0.0.2.tar.gz
Algorithm Hash digest
SHA256 6d97f825a3e9c09b261e938c5226759ea34c174133ba6463c40dcfbc541c3c2e
MD5 59cbaf60f71dcc50c2eb9ed93c11bf68
BLAKE2b-256 499d8e7278320f75016d422d83fe99903e87598d35a32909a41a1a2c1b80414e

See more details on using hashes here.

File details

Details for the file instappium-0.0.2-py2.py3-none-any.whl.

File metadata

  • Download URL: instappium-0.0.2-py2.py3-none-any.whl
  • Upload date:
  • Size: 33.7 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/46.1.3 requests-toolbelt/0.9.1 tqdm/4.32.2 CPython/3.7.4

File hashes

Hashes for instappium-0.0.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 8be359c54d742f0b571731b38303887b5b84cc1002c3fa2a850b981e04fa5be8
MD5 f615f04cbb3c112daa5bb90a96b91b9e
BLAKE2b-256 3f9b1b0ece6323b7efc72e38a7cc9c00b9bfb000c23ab654c1504dd477f55821

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page