Instabot.py 🤖 🌟

Instabot.py is an extremely light instagram bot that uses the undocumented Web API. Unlike other bots, Instabot.py does not require Selenium or a WebDriver. Instead, it interacts with the API over simple HTTP Requests. It runs on most systems, including Raspberry Pi.

Requirements

• Python v3.6 or greater
• Pip v18 or greater

Quick Start 🚀

• Make sure you have Python 3.6 or above installed

  • python3 --version

On Windows you might have to use python without the version (3) suffix. Experienced users should use virtualenv.

• If your version is below 3.6, we recommend you install the latest Python 3.7 or 3.8

  • Python on Windows
  • Python on Mac
  • Python on Raspberry Raspbian / Debian / Ubuntu

Installation

• From PyPi (Stable):

python3 -m pip install instabot-py

• From sources (Bleeding edge):

python3 -m pip install git+https://github.com/instabot-py/instabot.py

Configuration ⚙️

Run instabot-py --create-config command and a default configuration will be created in your current directory: instabot.config.yml. It should be modified according the needs. You can also run the bot with a different configuration file using -c flag: instabot-py -c myconfiguration.yml

Start the bot 🏁

• instabot-py or python3 -m instabot_py
• instabot-py -c myconfiguration.yml or python3 -m instabot_py -c myconfiguration.yml

The %username%.db file contains records of posts the bot has liked, and the users who has been followed/unfollowed.

The %username%.session file stores your session with Instagram to avoid re-logins each time you start the bot.

Upgrade ⬆️

• python3 -m pip install instabot-py --no-cache-dir --upgrade
• pip3 install instabot-py --no-cache-dir --upgrade

Parameters

Telegram channel for instabot-py's logs

1. Create Telegram bot
2. Add the following settings into the configuration:

---
# Send INFO notification to Telegram channel 
logging.loggers.InstaBot.handlers:
  - telegram
  - console
logging.version: 1
logging.disable_existing_loggers: False
logging.root.level: INFO
logging.formatters.simple: 
  format: '%(asctime)s - {{login}} - %(name)s - %(levelname)s - %(message)s'
logging.handlers.telegram:
  level: INFO
  class: telegram_handler.TelegramHandler
  token: __YOUR__CHANNEL__TOKEN__
  chat_id: __CHAT_ID__
  formatter: simple
logging.handlers.console:
  level: DEBUG
  class: logging.StreamHandler
  formatter: simple
  stream: ext://sys.stdout
logging.loggers.InstaBot.handlers:
  - telegram
  - console

Community

• Telegram Group

Contributing

Please feel free to contribute and submit PR requests. All help is appreciated. Look for issues with the label needs help. If you want to be in the developer team, please email me.