Skip to content

instagram_monitor

GitHub Release PyPI Version GitHub Stars Python Versions Docker Pulls License Last Commit Maintenance

Powerful, real-time OSINT suite for tracking every activity on Instagram - from story updates and bio changes to follower shifts, providing stunning dashboards and instant alerts to keep you in the loop.

instagram_monitor_web_dashboard_screenshot

🚀 Quick Install & Run

Python from PyPI (see also the video below) 

pip install instagram_monitor
instagram_monitor --setup

Docker Compose 

curl -fsSLO https://raw.githubusercontent.com/misiektoja/instagram_monitor/refs/heads/main/docker-compose.yml
docker compose run --rm instagram_monitor --setup
docker compose up

Docker run 

docker pull misiektoja/instagram-monitor:latest
docker run --rm -it --init -v "$PWD:/data" -v instagram_monitor_session:/home/instagram/.config/instaloader -p 8000:8000 misiektoja/instagram-monitor --setup

instagram_monitor demo: install, setup wizard and run

Features

🔍 Real-time Tracking

  • Profile Activity: Monitor new posts, reels and stories in real-time.
  • Private Posts: Detects collab posts leaking from private accounts via public collaborators.
  • Audience Insights: Track changes in followings and followers.
  • Visual Changes: Detect updates to profile pictures and visibility (public/private).
  • Bio Updates: Stay informed about changes to user bio.

📥 Media Download

  • Anonymous Stories: Download story images and videos without leaving traces.
  • High-Quality Media: Save post images, reel videos and profile pictures.
  • Batch Support: Monitor and download media for multiple users simultaneously.

📱 Interactive Dashboards

  • Guided Setup: Interactive wizard writes a ready-to-run config for PyPI, script and Docker workflows.
  • Terminal Dashboard: Beautiful, live-updating CLI interface with real-time stats.
  • Web Dashboard: Modern, local web UI with activity feeds and remote controls.
  • Image Support: View profile pictures and media directly in your terminal (via imgcat).

🔔 Smart Notifications

  • Multi-Channel: Instant alerts via Email and Webhooks (Discord etc.).
  • Rich Alerts: Attached media (profile pics, stories, posts) directly in notifications.
  • Error Reporting: Be notified if the monitoring process hits a snag.

🛡️ Privacy & Detection Avoidance

  • Be Human Mode: Simulates random user actions to blend in.
  • Jitter Mode: Adds human-like delays to HTTP requests.
  • Hour-Range Checking: Limits activity to specific hours of the day.
  • Account Flexibility: Works with or without a logged-in Instagram account.
  • Browser Session Import: Reuse Firefox, Chrome, Brave or Chromium sessions with profile selection.
  • Browser TLS Impersonation: Routes traffic through curl_cffi to mimic a real browser's TLS fingerprint and dodge fingerprint-based blocks.
  • Proxy Support: Route Instagram and webhook traffic through your own proxy.
  • Privacy Substitutions: Mask or rename identities across all output, logs and notifications.
  • Block Awareness: Detects shadowbans and flagged sessions to avoid false alerts.

⚙️ Power Features

  • CSV Logging: Log all activities and profile changes with timestamps.
  • Flexible Config: Support for files, dotenv and environment variables.
  • Follower Churn: Detailed tracking of exactly who followed or unfollowed.
  • Batched Fetching: Throttle follower/following downloads into delayed batches.
  • Remote Control: Manage tracking features via signals or the web UI.
  • Docker Ready: Run via Docker Hub, Docker Compose or local image build with persisted config, dotenv and sessions.

instagram_monitor_terminal_dashboard

instagram_monitor_log_screenshot