Skip to content

A lightweight Python CLI tool that automatically unfollows accounts and removes followers on Instagram, helping you maintain a clean, engaged audience.

License

Notifications You must be signed in to change notification settings

dev-ggomes/auto-unfollow-and-remove-follower4-instagram

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🇺🇸 English | ᴘᴛ Português | 🇧🇷 Português

🚀 Instagram CLI Manager

:octocat: Follow the step by step guide to run this code the proper way.

⭐ If you liked this project, please give it a star

Sponsor   GitHub Repo stars


✔️ Prerequisites

  • Python 3.8+ installed on your system;
  • A valid Instagram account with username and password;
  • Active internet connection.


🚀 Installation

1. Clone the repository:

  • git clone https://github.com/dev-ggomes/auto-unfollow-and-remove-follower4-instagram.git
  • cd auto-unfollow-and-remove-follower4-instagram

2. Verify Python version:

  • python --version

Important

Ensure the output is 3.8 or higher.

3. Make the script executable on Unix-based systems:

  • chmod +x main.py

⚙️ Configuration

The script will prompt you for your Instagram credentials at runtime.

Note

No hardcoded credentials are stored in this repository.

🏃‍♂️ Usage

Run the script with the desired action and target usernames (without the @ symbol):

  • Unfollow users python main.py unfollow username1 username2 username3

  • Remove followers python main.py remove follower1 follower2 follower3

Example Session

$ python main.py unfollow alice bob
Username Instagram: your_username_here
Password Instagram: your_password_here (the password is not going to be stored at any place)
Login successful.
Unfollowed alice: OK
Unfollowed bob: OK

🛠 Troubleshooting

  • CSRF errors or unexpected responses: Wait a few seconds and retry--Instagram may rate-limit rapid requests;

  • Login failures: Verify that your username and password are correct;

  • Temporary blocks: If Instagram temporarily blocks your IP or account, wait at least 15 minutes before retrying.



Warning

I am NOT responsible for any taken actions by Instagram to your account or your IP, either they are temporarily or permantly. This script was developed to test my knowledge. Use it on your own responsibily and risk.


📄 License

This project is distributed under the MIT License. Check LICENSE for full terms.

About

A lightweight Python CLI tool that automatically unfollows accounts and removes followers on Instagram, helping you maintain a clean, engaged audience.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages