pyInstaBot

An Instagram bot and library written in Python to publish content automatically.

Join our community ! Chat with us on Gitter and join the Google Group to collaborate with us.

This repository consists of:

• config : Configuration file management;
• data :
• db : MySQL database management;
• docs : Documentation;
• executor : Function and objects to execute actions;
• filters : Function and objects for image filters ;
• friends : Function and objects to manage friends and followers;
• hashtags : Function and objects to manage hashtags ;
• instagram : Function and objects for Instagram ;
• instagramAPI : The instagram API ;
• learning : Functions and objects for image and text classification ;
• media : Functions and objects to manage medias ;
• patterns : Object patterns ;
• tools : Tools;

Authors

• Nils Schaetti – Initial work – nschaetti

License

This project is licensed under the GPLv3 License – see the LICENSE file for details.

Configuration

Configuration file

pyInstaBot takes its configuration in a JSON file which looks as follow :

{ 
    "database" :
    {
        "host" : "localhost",
	"username" : "",
	"password" : "",
	"database" : ""
    },
    "instagram" :
    {
        "username": "",
        "password": "",
        "data_path": ""
    },
    "scheduler" :
    {
        "sleep": [6, 13]
    },
    "hashtags":
    [
    ],
    "friends" :
    {
        "max_new_followers" : 40,
        "max_new_unfollow" : 40,
        "interval" : [30, 45],
        "ratio" : 0.8
    },
    "post":
    {
        "post_interval": [30, 90],
        "like_interval": [0, 4],
        "comment_interval": [0, 8],
        "max_posts": 24,
        "max_likes": 700,
        "max_comments": 300,
        "languages": ["en", "fr"],
        "comments": ["Nice!", "Nice feed!", "Keep going", "Good work", "<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="👊🏻" src="https://s.w.org/images/core/emoji/11/svg/1f44a-1f3fb.svg">" src="https://s.w.org/images/core/emoji/11/svg/1f44a-1f3fb.svg"><img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="😎" src="https://s.w.org/images/core/emoji/11/svg/1f60e.svg">" src="https://s.w.org/images/core/emoji/11/svg/1f60e.svg">", "<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="😅" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg">" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg"><img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="😅" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg">" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg"><img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="😅" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg">" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg">", "<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="❤" src="https://s.w.org/images/core/emoji/11/svg/2764.svg">" src="https://s.w.org/images/core/emoji/11/svg/2764.svg"><img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="❤" src="https://s.w.org/images/core/emoji/11/svg/2764.svg">" src="https://s.w.org/images/core/emoji/11/svg/2764.svg"><img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="❤" src="https://s.w.org/images/core/emoji/11/svg/2764.svg">" src="https://s.w.org/images/core/emoji/11/svg/2764.svg"><img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="❤" src="https://s.w.org/images/core/emoji/11/svg/2764.svg">" src="https://s.w.org/images/core/emoji/11/svg/2764.svg">", "Nice! <img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="😅" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg">" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg"><img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="😅" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg">" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg"><img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="😅" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg">" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg">", "Keep going <img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="😅" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg">" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg"><img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="😅" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg">" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg"><img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="<img draggable="false" data-mce-resize="false" data-mce-placeholder="1" data-wp-emoji="1" class="emoji" alt="😅" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg">" src="https://s.w.org/images/core/emoji/11/svg/1f605.svg">"]
    },
    "forbidden_words" :
    [
    ]
}

Their is two required sections :

• Database : contains the information to connect to the MySQL database (host, username, password, database)
• Instagram : contains the information to access instagram ;

Command line

Launch executors

pyInstaBot launch an executor thread for each action type. You can launch the executor daemon that way :

python -m pyInstaBot execute --session session_public.json --config nilsbot.json

Find post to like

To find post to like :

 
python -m pyInstaBot find-likes --session session_public.json --config nilsbot.json --model .

Find post to comment

To find post to comment :

 
python -m pyInstaBot find-comments --session session_public.json --config nilsbot.json --model .

Find users to follow

To find new users to follow :

 
python -m pyInstaBot find-follows --session session_public.json --config nilsbot.json --model .

Find users to unfollow

To find obsolete users to unfollow :

 
python -m pyInstaBot find-unfollows --session session_public.json --config nilsbot.json --model .

Update friends

To update the list of friends in the database :

 
python -m pyInstaBot friends --session session_public.json --config nilsbot.json --update

Add medias

To add all medias in a directory with a common caption :

 
python -m pyInstaBot medias --session session_public.json --config nilsbot.json --add ~/images/ --caption ~/images/caption --loop

The loop argument will repost the medias multiple time. To add only one image :

 
python -m pyInstaBot medias --session session_public.json --config nilsbot.json --add ~/images/im.jpg --caption ~/images/caption --loop

Development

Files

• pyInstaBot/main.py : Main Python file;
• pyInstaBot/add_medias.py : Add medias to the database ;
• pyInstaBot/apply_filter.py : Apply filter to images ;
• pyInstaBot/clean_medias.py : Clean all medias in the DB ;
• pyInstaBot/create_database.py : Create database structure ;
• pyInstaBot/execute_actions.py : Execute actions from the DB ;
• pyInstaBot/find_follows.py : Find users to follow ;
• pyInstaBot/find_locations.py : Find locations ;
• pyInstaBot/find_medias.py : Find medias to like/comment ;
• pyInstaBot/find_unfollows.py : Find users to unfollow ;
• pyInstaBot/hashtag_analysis.py : Hashtag analysis functions;
• pyInstaBot/setup.py : Installation script ;
• pyInstaBot/update_statistics.py : Update account statistics ;

Related posts