Keep an Eye on Any Instagram Account Without Breaking a Sweat
You've probably been there: you want to track when a competitor posts a story, when a brand changes its bio, or when someone quietly unfollows a bunch of accounts. Manually checking is tedious, and the built-in notifications only cover a fraction of what you actually care about. That's where instagram_monitor steps in—it's a real-time OSINT suite that watches Instagram accounts for you and tells you when things change.
What It Does
instagram_monitor is a Python-based tool that continuously tracks Instagram activity across multiple dimensions: story updates, bio changes, follower shifts, and more. It's built on top of instaloader (which handles the actual Instagram interaction) and provides both a web dashboard for visual monitoring and alerting capabilities to notify you when something happens.
The architecture is straightforward. You configure which accounts you want to monitor, and the tool polls Instagram on a schedule, comparing snapshots to detect changes. When it finds something new—a story posted, a bio edited, a follower count moved—it records the event and surfaces it in the dashboard.
One thing worth noting: this isn't just a simple follower counter. The project bills itself as an OSINT (open-source intelligence) suite, which means it's designed for thorough observation rather than casual checking. The README emphasizes real-time tracking and "instant alerts," so it's built for people who need to know the moment something changes, not the next time they remember to look.
Why It's Cool
The most obvious appeal here is the breadth of what it monitors. Most Instagram tracking tools focus on one metric—followers, usually. This one handles stories, bio changes, and follower shifts in a single tool, which means you get a complete picture of an account's activity without juggling multiple services.
There are a few things that stand out:
- The dashboard matters. A wall of text alerts gets old fast. The project includes a web dashboard that visualizes what's happening, which makes it practical for ongoing monitoring rather than just a notification firehose.
- Setup is genuinely flexible. You've got three distinct paths to get running: a straight PyPI install with a setup wizard, a one-shot Docker container, or Docker Compose for recurring use. That's good engineering—it meets people where they are, whether they're Python-savvy or just want to
docker runand be done. - It respects your filesystem. The Docker setup includes flags like
--user "$(id -u):$(id -g)"and volume mounts with:zlabels, which tells me the author has thought about the real-world pain of containerized tools creating root-owned files you can't edit later. That's a level of care you don't always see. - The session persistence is handled. The Docker commands mount a named volume for
instaloader's config directory, which means you won't have to re-authenticate every time you restart the container. Small detail, huge quality-of-life win.
The project also carries an OpenSSF scorecard badge and an active maintenance indicator, which suggests the author is serious about security and upkeep—not just shipping something and abandoning it.
How to Try It
Getting started is surprisingly painless, especially if you're comfortable with Docker. The fastest path is the container setup:
docker run --rm --pull=always -it --init -v "${PWD}:/data:z" -v instagram_monitor_session:/home/instagram/.config/instaloader misiektoja/instagram-monitor:latest --setup
That command runs the setup wizard interactively, which walks you through configuring which accounts to monitor. On Linux, you'll want to add --user "$(id -u):$(id -g)" so the files created in your current directory belong to you rather than root.
If you prefer Python, install from PyPI and run the same wizard:
pip install instagram_monitor
instagram_monitor --setup
For a more repeatable workflow, there's a Docker Compose file you can grab from the repo:
curl -fsSLO https://raw.githubusercontent.com/misiektoja/instagram_monitor/refs/heads/main/docker-compose.yml
docker compose run --rm --pull=always instagram_monitor --setup
The full installation docs—including manual setup and browser support options—live in the project's installation guide, and the source is on GitHub if you want to poke around.
Final Thoughts
instagram_monitor is a solid pick if you need serious, ongoing observation of Instagram accounts—whether that's for competitive research, brand monitoring, or just keeping tabs on people you care about. It's not a casual "see who unfollowed me" toy; it's a proper tool with a dashboard, alerting, and multiple deployment options. The Docker integration is well thought out, the setup wizard lowers the barrier to entry, and the active maintenance gives you some confidence it won't rot.
If you've been piecing together manual checks or relying on flaky third-party trackers, this is worth a weekend afternoon to get running. You'll probably find that having a real dashboard changes how you think about monitoring—it turns a chore into something you can actually glance at and act on.
Follow @githubprojects for more developer tools and open source projects.