Skip to content
πŸ’¨ Simply get InstaPy up and running in minutes.
Python Shell Batchfile
Branch: master
Clone or download
breuerfelix Merge pull request #70 from ishandutta2007/feature_no_comments
distributing no_comments engagement_mode to templates
Latest commit e6d9254 Aug 31, 2019

Instapy Quickstart


Using this repository, you will be able to install and use InstaPy with only very few steps.

  1. Download the zip of this repository by clicking on the green button in the upper right corner Clone or download.
  2. Unzip the folder and open the installation folder
  3. Double click the installation file for your system
  4. If you missed any installation it will tell you what you have to install
  5. Once successfully installed you can edit the quickstart file or use any of the template files from the quickstart_templates folder
  6. Insert your username and password and modify anything you want. Make use of the comprehensive documentation.
  7. The last step is to open the run folder and double click the file that suits your platform, e.g. mac_start.command for MacOS.

If you're using one of the template files, make sure to copy and paste them into the same folder as the file is and then rename it to because that is the name of the file that will be chosen once you double click the run script.

Basic quickstart file

To get started quickly we've prepared a basic quickstart file in which you only have to edit the username and password, inside the single quotes, to make sure you're all set up. After testing your installation by starting InstaPy once, you can go in and use the documentation to configure your personal bot.

The basic quickstart file looks like this:

""" Quickstart script for InstaPy usage """
# imports
from instapy import InstaPy
from instapy import smart_run

# login credentials
insta_username = ''  # <- enter username here
insta_password = ''  # <- enter password here

# get an InstaPy session!
# set headless_browser=True to run InstaPy in the background
session = InstaPy(username=insta_username,

with smart_run(session):
    """ Activity flow """
    # general settings

    session.set_dont_include(["friend1", "friend2", "friend3"])
    session.set_dont_like(["pizza", "#store"])

    # activity
    session.like_by_tags(["natgeo"], amount=10)

When adding lines to the script, make sure to use a code editor which takes care of the indentation. Otherwise you will get an error upon execution.

Already used InstaPy before pip install instapy?

If you've used InstaPy before the update to PyPi that allows installing with pip install instapy, you have to move your database and log files into the new workspace directory.
Check out this very short guide on what to do!

Encountering an issue while installing?

If you should encounter any problem with the installation, please use the main repository InstaPy to report the issue instead of this repository.

Have fun & stay responsible!
You can’t perform that action at this time.