explaingit

saqlvation/instapurge

Analysis updated 2026-05-18

1PythonAudience · generalComplexity · 2/5LicenseSetup · moderate

TLDR

A free local tool that scans your Instagram followers and automatically removes bots and mass-follow accounts.

Mindmap

mindmap
  root((InstaPurge))
    What it does
      Scans followers
      Flags bots
      Removes them
    Tech stack
      Python
      Playwright
      httpx
    Use cases
      Clean bot followers
      Preview before removing
      Resume after rate limit
    Audience
      Instagram users
      No coding needed
    Setup
      Install Playwright
      Add credentials
      Run dry run first

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Clean up an Instagram account with thousands of bot or ghost followers.

USE CASE 2

Preview which followers would be flagged as bots before removing anyone.

USE CASE 3

Run a scheduled cleanup that resumes automatically after Instagram rate limits.

What is it built with?

PythonPlaywrighthttpx

How does it compare?

saqlvation/instapurge0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity2/54/54/5
Audiencegeneraldeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires installing Playwright and Chromium, plus entering your Instagram password into a local config file.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

InstaPurge is a Python tool that cleans up your Instagram followers list by finding and removing bots, mass-followers, and inactive ghost accounts. Instead of scrolling through thousands of followers by hand or paying for a subscription service, you run this on your own computer and it does the work for you. The tool logs into your Instagram account using browser automation (a tool called Playwright that controls a real Chrome browser), then pulls your full follower list by watching the data Instagram's own website loads as you scroll. It then checks each follower against a few simple rules: how many accounts they follow compared to how many follow them back, whether they have a profile picture, whether their account is private with zero posts, and whether their username looks like a randomly generated string. An account gets flagged as suspicious if it matches two or more of these signs, and flagged accounts are removed automatically through the followers screen. For a typical account with 8,000 followers, the whole process (scanning plus removing) takes about 45 minutes. Everything runs locally on your own machine, no data is sent anywhere else, and no Instagram API key is needed. A dry run mode lets you preview what would be removed before doing it for real. Settings like how many accounts to remove per session and the delay between actions can be adjusted in a config file, which helps avoid triggering Instagram's spam protections. If Instagram temporarily blocks the account for doing too many actions too quickly, the tool detects this, saves its progress, and lets you resume the next day without rescanning everything from scratch. It requires entering your Instagram username and password directly into a local config file, since it does not use official API access.

Copy-paste prompts

Prompt 1
Help me set up InstaPurge and configure config.json with safe rate-limit settings.
Prompt 2
Walk me through running InstaPurge in dry run mode to preview flagged followers.
Prompt 3
Explain what each bot-detection rule in InstaPurge checks for and how to tune the thresholds.
Prompt 4
Help me troubleshoot InstaPurge getting stuck on the Instagram login step.

Frequently asked questions

What is instapurge?

A free local tool that scans your Instagram followers and automatically removes bots and mass-follow accounts.

What language is instapurge written in?

Mainly Python. The stack also includes Python, Playwright, httpx.

What license does instapurge use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is instapurge to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is instapurge for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.