Skip to content

4ngel2769/Intelgram

Repository files navigation

Intelgram 🔎

Python Version License Docker

Intelgram is an Instagram OSINT CLI for profile reconnaissance, media analysis, network mapping, and data export.

⚠️ For educational use. You are responsible for complying with Instagram Terms of Service and applicable laws.

What it does

  • Analyze profiles, followers/following, and engagement
  • Download media, stories, highlights, and profile pictures
  • Run OSINT workflows (taggedin, locationconnect)
  • Switch targets during a live session (target, cleartarget)
  • Export results to JSON/CSV and use output redirection (command >)

Quick start

1) Install

git clone https://github.com/4ngel2769/Intelgram.git
cd Intelgram
python -m venv venv
# Windows: venv\Scripts\activate
# macOS/Linux: source venv/bin/activate
pip install -r requirements.txt

2) Configure credentials

Use either:

  • .env (copy from .env.example), or
  • config/credentials.ini

3) Run

# Interactive mode
python main.py <target_username>

# Single command mode
python main.py <target_username> -c profile

# Enable exports
python main.py <target_username> --json --csv

Command overview

Intelgram v1.2.1 includes 32 commands across 10 categories:

  • Session: target, cleartarget, me, follow, unfollow
  • OSINT: taggedin, locationconnect
  • Profile: profile, bio, contact, verify
  • Network: followers, following, mutual, ratio
  • Media: media, download, captions, mediatypes
  • Engagement: likes, comments, topposts, engagement
  • Analysis: hashtags, mentions, locations, timing
  • Interactions: likers, commenters, tagged, topfans
  • Download: stories, profilepic, highlights
  • Utility: export

General commands: help, man <command>, exit, quit.

Docker

docker build -t intelgram .
docker-compose run --rm intelgram <target_username>

Notes

  • Use a secondary Instagram account for testing/research.
  • Avoid aggressive request volume to reduce challenge/rate-limit issues.
  • Keep credentials and session files private.

Acknowledgements

  • Built with instagrapi
  • Inspired by Osintgram and related OSINT tools

License

MIT — see LICENSE.

About

An OSINT tool for instagram

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Contributors