timgrossmann/InstaPy

Instagram Bot - Tool for automated Instagram interactions

Twitter of InstaPy | Twitter of Tim | Discord Channel | How it works (Medium) |
Talk about automating your Instagram | Talk about doing Open-Source work | Listen to the “Talk Python to me”-Episode

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

Table of contents

• How to install and run InstaPy
  • Installing InstaPy
  • Running Instapy
  • Updating InstaPy
  • Guides and tutorials
    • Video tutorials
    • Written guides
• Externals and additionals tools
  • Dashboard
  • Web Interface
• Running InstaPy on Docker
• Documentation of all Instapy’s features
• Support
• Credits
• Disclaimer

Installation

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.

• Here is the easiest quickstart script you can use

• And here you can find lots of sophisticated quickstart templates shared by the community!

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:

InstaPy(username="abcd", 
        password="1234")

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.

python quickstart.py
-- or
python quickstart.py --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

Guides

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.

Docker

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

Documentation

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

Support

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

Credits

Community

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 ✌️

Contributors

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

Backers

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

Sponsors

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.