instagram_monitor

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.

🚀 Quick Install & Run

Python from PyPI

New to Python or unsure what is installed? Follow the Python install walkthrough first.

pip install instagram_monitor

Run setup wizard:

instagram_monitor --setup

Docker image - fastest container setup

macOS or Windows

Use a macOS shell or Windows PowerShell with a Docker-compatible runtime that provides the docker CLI.

docker run --rm --pull=always -it --init -v "${PWD}:/data:z" -v instagram_monitor_session:/home/instagram/.config/instaloader misiektoja/instagram-monitor:latest --setup

In Windows Command Prompt replace ${PWD} with %cd% above.

Linux

Run the container with your numeric user and group IDs (--user "$(id -u):$(id -g)" below). This lets the container write files that your host account can edit.

docker run --rm --pull=always -it --init --user "$(id -u):$(id -g)" -v "$PWD:/data:z" -v instagram_monitor_session:/home/instagram/.config/instaloader misiektoja/instagram-monitor:latest --setup

Docker Compose - shorter recurring commands

Download the Compose file:

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

Linux container engine requires to export your numeric user ID and group ID so files created in the current directory belong to you instead of root.

export INSTAGRAM_MONITOR_UID="$(id -u)"
export INSTAGRAM_MONITOR_GID="$(id -g)"

Docker-compatible runtimes on macOS and Windows normally do not need these values.

Run setup wizard:

docker compose run --rm --pull=always instagram_monitor --setup

For the manual single-file method, optional browser support and upgrade commands for every installation method, see Installation.

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.
• Follow Analysis: Inspect mutual, not-following-back and fan relationships offline from saved lists with --analyze-follows or the Web Dashboard.
• 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.