Metadata-Version: 2.4
Name: insight-osint-cli
Version: 1.0.0
Summary: InSight - Instagram Profiling AI CLI
Home-page: https://github.com/yourusername/InSight
Author: InSight Developer
Author-email: developer@example.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Security
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.12.0
Requires-Dist: rich>=13.0.0
Requires-Dist: instagrapi
Requires-Dist: google-genai
Requires-Dist: requests
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# InSight - Instagram Profiling AI

![Python Version](https://img.shields.io/badge/python-3.10+-blue.svg)
![License](https://img.shields.io/badge/license-MIT-green.svg)
![Type](https://img.shields.io/badge/type-OSINT-red.svg)
![Status](https://img.shields.io/badge/status-Active-success.svg)

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:** Add a terminal recording (GIF) demonstrating the Rich TUI, loading states, and the AI analysis loop here to showcase the CLI aesthetic.
> 
> ![InSight Terminal Execution](assets/showcase.gif)

## [ 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:**
```bash
git clone https://github.com/yourusername/InSight.git
cd InSight
```

2. **Install requirements and configure the global CLI:**
```bash
pip install -r requirements.txt
pip install -e .
```

3. **Configuration:**
Configure your API keys and default language directly from the CLI.
```bash
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.
```bash
insight auth login
```

### Deep Persona Profiling
Execute the full AI analysis on a target user to generate a comprehensive intelligence report.
```bash
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.
```bash
insight detailed-info <instagram_username>
```

### Report History
List all generated intelligence reports.
```bash
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.
