November 23, 2018

641 words 4 mins read



Instagram Bot - Tool for automated Instagram interactions

repo name timgrossmann/InstaPy
repo link
language Python
size (curr.) 81498 kB
stars (curr.) 9454
created 2016-09-26
license GNU General Public License v3.0

Twitter of InstaPyTwitter of Tim | Discord ChannelHow it works (Medium) |
Talk about automating your Instagram | Talk about doing Open-Source workListen to the “Talk Python to me”-Episode

Newsletter: Sign Up for the Newsletter here!
Official Video Guide: Get it here!

Table of contents


pip install instapy

Important: depending on your system, make sure to use pip3 and python3 instead.

That’s it! 🚀
If you’re on Ubuntu, read the specific guide on Installing on Ubuntu (64-Bit). If you’re on a Raspberry Pi, read the Installing on RaspberryPi guide instead.

If you would like to install a specific version of Instapy you may do so with:

pip install instapy==0.1.1

Running Instapy

To run InstaPy, you’ll need to run the quickstart script you’ve just downloaded.

You can put in your account details now by passing the username and password parameters to the InstaPy() function in your quickstart script, like so:


Or you can pass them using the Command Line Interface (CLI).

If you’ve used InstaPy before installing it by pip, you have to move your old data to the new workspace folder for once. Read how to do this here.

Once you have your quickstart script configured you can execute the script with the following commands.

-- or
python --username abcd --password 1234

InstaPy will now open a browser window and start working.

If want InstaPy to run in the background pass the --headless-browser option when running from the CLI
Or add the headless_browser=True parameter to the InstaPy(headless_browser=True) constructor.

Updating InstaPy

pip install instapy -U


Video tutorials:

Official InstaPy Guide on Udemy

Installation on Windows

Installation on MacOS

Installation on Linux

Installation on DigitalOcean Server

Written Guides:

How to Ubuntu (64-Bit)       

How to RaspberryPi       

External Tools:

InstaPy Dashboard

InstaPy Dashboard is an Open Source project developed by @converge to visualize Instagram accounts progress and real-time InstaPy logs on the browser.

InstaPy GUI

InstaPy GUI is a Graphical User Interface including some useful Analytics developed by @breuerfelix.


All information on how to use InstaPy with Docker can be found in the instapy-docker repository.


A list of all features of InstaPy can be found here.


Do you need help?

If you should encounter any issue, please first search for similar issues and only if you can’t find any, create a new issue or use the discord channel for help.

Do you want to support us?

Help build InstaPy!
Check out this short guide on how to start contributing!.



An active and supportive community is what every open-source project needs to sustain. Together we reached every continent and most of the countries in the world!
Thank you all for being part of the InstaPy community ✌️

InstaPy reach


This project exists thanks to all the people who contribute. [Contribute].


Thank you to all our backers! 🙏 [Become a backer]


Support this project by becoming a sponsor. Your logo will show up here with a link to your website. [Become a sponsor]

Disclaimer: Please Note that this is a research project. I am by no means responsible for any usage of this tool. Use on your own behalf. I’m also not responsible if your accounts get banned due to extensive use of this tool.

comments powered by Disqus