InSight - Instagram Profiling AI

InSight is an advanced AI-powered Open Source Intelligence (OSINT) tool designed to deeply analyze Instagram profiles. By utilizing the instagrapi library and Google's Gemini 3.5 Flash AI model, it creates detailed, target-oriented Persona Reports of Instagram users without human intervention.

[ SHOWCASE ]

Note: The terminal execution preview below was automatically generated as an SVG.

[ OVERVIEW ]

• Deep Persona Profiling: Employs AI to estimate age, hometown, education, and workplace based on followers, following, and mutual connections.
• Connection Categorization: Separates connections into verified (celebrity/brands) and personal to understand the target's true social circle and interests.
• Vision Integration: Analyzes profile pictures to extract styling and age estimates using Gemini Vision.
• Smart Quota Management: Automatically rotates through multiple Gemini API keys to avoid rate limit restrictions.
• Local Caching: Stores fetched Instagram data locally (SQLite) for 1 hour to prevent redundant requests and bans.
• Modern CLI: Uses Typer and Rich to provide a robust, interactive Command Line Interface.

[ INSTALLATION ]

1. Clone the repository:

git clone https://github.com/yourusername/InSight.git
cd InSight

2. Install requirements and configure the global CLI:

pip install -r requirements.txt
pip install -e .

3. Configuration: Configure your API keys and default language directly from the CLI.

insight config add-key YOUR_GEMINI_API_KEY
insight config set-credentials
insight config show

[ USAGE ]

InSight operates via a global CLI. You can interact with the agent using the insight command directly from your terminal.

Authentication

Authenticate securely to cache your session and avoid Instagram blocks.

insight auth login

Deep Persona Profiling

Execute the full AI analysis on a target user to generate a comprehensive intelligence report.

insight analyze <instagram_username>

Optional: You can specify the output language using --language "Turkish" (Default is English).

Data Extraction (No AI)

Retrieve raw personal information, media statistics, and network connections in a tabular format without engaging the AI model.

insight detailed-info <instagram_username>

Report History

List all generated intelligence reports.

insight history

[ CONTRIBUTING ]

Contributions are welcome. If you have suggestions for improving the intelligence gathering techniques or fixing bugs, please open an issue or submit a Pull Request.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

[ LICENSE ]

Distributed under the MIT License. See LICENSE for more information.

[ DISCLAIMER ]

This tool is strictly developed for educational and OSINT research purposes. The developers bear no responsibility for any misuse, account suspensions, or privacy infringements. Ensure your actions comply with Instagram's Terms of Service and applicable privacy laws.