# psycho-prince/instagram-osint architecture

> Architecture diagram of the GitHub repository psycho-prince/instagram-osint, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/psycho-prince/instagram-osint
- Repository: https://github.com/psycho-prince/instagram-osint

## Overview

yesitsme is an async Instagram and cross-platform OSINT framework. Its principal workflow accepts a target and session cookies, checks cookie health, resolves and enriches the Instagram profile, gathers username and platform signals, then assembles timeline, leak, search, confidence, and risk findings into reports. The README also describes batch investigations and Reddit intelligence; these are retained as documented capabilities, though the sampled entry-point excerpt does not show their wiring. Edges use explicit calls in excerpts or README statements; unsampled implementation relationships are omitted.

Main entry points: [`main.py`](https://github.com/psycho-prince/instagram-osint/blob/main/main.py) (CLI workflow), [`utils/scoring.py`](https://github.com/psycho-prince/instagram-osint/blob/main/utils/scoring.py) (Scoring API), [`utils/cookies.py`](https://github.com/psycho-prince/instagram-osint/blob/main/utils/cookies.py) (Cookie health), [`core/instagram.py`](https://github.com/psycho-prince/instagram-osint/blob/main/core/instagram.py) (Instagram profile)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Investigation entry"]
  node_cli["CLI workflow<br/>[main.py]"]
  node_cookie_loader["Cookie loading<br/>[cookies.py]"]
  node_cookie_check["Cookie health<br/>[cookies.py]"]
end

subgraph group_instagram["Instagram intelligence"]
  node_instagram_api["Instagram profile<br/>[instagram.py]"]
  node_exposure_check["Exposure checks<br/>[instagram.py]"]
end

subgraph group_enrichment["Cross-platform enrichment"]
  node_variants["Username variants<br/>[usernames.py]"]
  node_platform_presence["Platform presence<br/>[usernames.py]"]
  node_profile_parsers["Profile analysis<br/>[usernames.py]"]
  node_twitter_osint["Twitter/X OSINT<br/>[twitter.py]"]
  node_leak_search["Leak signals<br/>[leaks.py]"]
end

subgraph group_analysis["Analysis and reporting"]
  node_timeline["Timeline consistency<br/>[instagram.py]"]
  node_history["Username history"]
  node_avatar_history["Avatar analysis<br/>[avatar.py]"]
  node_search_dorks["Search dorks<br/>[dorks.py]"]
  node_confidence["Confidence scoring<br/>[confidence.py]"]
  node_risk["Risk grading<br/>[risk.py]"]
  node_scoring_api["Scoring API<br/>[scoring.py]"]
  node_reporting["Report export<br/>[render.py]"]
end

node_investigator(("Investigator"))
node_instagram_service(("Instagram"))
node_web_search(("Web search"))
node_social_platforms(("Social platforms"))
node_report_files["JSON and Markdown"]

node_investigator -->|"runs"| node_cli
node_cli -->|"loads cookies"| node_cookie_loader
node_cli -->|"checks health"| node_cookie_check
node_cookie_check -->|"checks session"| node_instagram_service
node_cli -->|"resolves and fetches"| node_instagram_api
node_instagram_api -->|"requests profile"| node_instagram_service
node_cli -->|"checks exposure"| node_exposure_check
node_exposure_check -->|"tests endpoints"| node_instagram_service
node_cli -->|"generates variants"| node_variants
node_cli -->|"checks usernames"| node_platform_presence
node_platform_presence -->|"checks profiles"| node_social_platforms
node_cli -->|"checks advanced profiles"| node_profile_parsers
node_profile_parsers -->|"fetches profiles"| node_social_platforms
node_cli -->|"runs when present"| node_twitter_osint
node_twitter_osint -->|"fetches X profile"| node_social_platforms
node_cli -->|"checks leak signals"| node_leak_search
node_leak_search -->|"searches Bing"| node_web_search
node_cli -->|"infers consistency"| node_timeline
node_cli -->|"generates dorks"| node_search_dorks
node_cli -->|"scores report"| node_scoring_api
node_scoring_api -->|"calculates confidence"| node_confidence
node_scoring_api -->|"grades risk"| node_risk
node_cli -->|"saves reports"| node_reporting
node_reporting -->|"writes JSON or Markdown"| node_report_files

click node_cli "https://github.com/psycho-prince/instagram-osint/blob/main/main.py"
click node_cookie_loader "https://github.com/psycho-prince/instagram-osint/blob/main/utils/cookies.py"
click node_cookie_check "https://github.com/psycho-prince/instagram-osint/blob/main/utils/cookies.py"
click node_instagram_api "https://github.com/psycho-prince/instagram-osint/blob/main/core/instagram.py"
click node_exposure_check "https://github.com/psycho-prince/instagram-osint/blob/main/core/instagram.py"
click node_variants "https://github.com/psycho-prince/instagram-osint/blob/main/enrich/usernames.py"
click node_platform_presence "https://github.com/psycho-prince/instagram-osint/blob/main/enrich/usernames.py"
click node_profile_parsers "https://github.com/psycho-prince/instagram-osint/blob/main/enrich/usernames.py"
click node_twitter_osint "https://github.com/psycho-prince/instagram-osint/blob/main/enrich/twitter.py"
click node_leak_search "https://github.com/psycho-prince/instagram-osint/blob/main/enrich/leaks.py"
click node_timeline "https://github.com/psycho-prince/instagram-osint/blob/main/core/instagram.py"
click node_history "https://github.com/psycho-prince/instagram-osint/blob/main/utils/username_history.py"
click node_avatar_history "https://github.com/psycho-prince/instagram-osint/blob/main/utils/avatar.py"
click node_search_dorks "https://github.com/psycho-prince/instagram-osint/blob/main/enrich/dorks.py"
click node_confidence "https://github.com/psycho-prince/instagram-osint/blob/main/utils/confidence.py"
click node_risk "https://github.com/psycho-prince/instagram-osint/blob/main/utils/risk.py"
click node_scoring_api "https://github.com/psycho-prince/instagram-osint/blob/main/utils/scoring.py"
click node_reporting "https://github.com/psycho-prince/instagram-osint/blob/main/reports/render.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_cookie_loader,node_cookie_check toneBlue
class node_instagram_api,node_exposure_check toneAmber
class node_variants,node_platform_presence,node_profile_parsers,node_twitter_osint,node_leak_search toneMint
class node_timeline,node_history,node_avatar_history,node_search_dorks,node_confidence,node_risk,node_scoring_api,node_reporting toneRose
class node_investigator,node_instagram_service,node_web_search,node_social_platforms,node_report_files toneIndigo
```

## Components

### Investigation entry

- [CLI workflow](https://github.com/psycho-prince/instagram-osint/blob/main/main.py): `main.py`
- [Cookie loading](https://github.com/psycho-prince/instagram-osint/blob/main/utils/cookies.py): `utils/cookies.py`
- [Cookie health](https://github.com/psycho-prince/instagram-osint/blob/main/utils/cookies.py): `utils/cookies.py`

### Instagram intelligence

- [Instagram profile](https://github.com/psycho-prince/instagram-osint/blob/main/core/instagram.py): `core/instagram.py`
- [Exposure checks](https://github.com/psycho-prince/instagram-osint/blob/main/core/instagram.py): `core/instagram.py`

### Cross-platform enrichment

- [Username variants](https://github.com/psycho-prince/instagram-osint/blob/main/enrich/usernames.py): `enrich/usernames.py`
- [Platform presence](https://github.com/psycho-prince/instagram-osint/blob/main/enrich/usernames.py): `enrich/usernames.py`
- [Profile analysis](https://github.com/psycho-prince/instagram-osint/blob/main/enrich/usernames.py): `enrich/usernames.py`
- [Twitter/X OSINT](https://github.com/psycho-prince/instagram-osint/blob/main/enrich/twitter.py): `enrich/twitter.py`
- [Leak signals](https://github.com/psycho-prince/instagram-osint/blob/main/enrich/leaks.py): `enrich/leaks.py`

### Analysis and reporting

- [Timeline consistency](https://github.com/psycho-prince/instagram-osint/blob/main/core/instagram.py): `core/instagram.py`
- [Username history](https://github.com/psycho-prince/instagram-osint/blob/main/utils/username_history.py): `utils/username_history.py`
- [Avatar analysis](https://github.com/psycho-prince/instagram-osint/blob/main/utils/avatar.py): `utils/avatar.py`
- [Search dorks](https://github.com/psycho-prince/instagram-osint/blob/main/enrich/dorks.py): `enrich/dorks.py`
- [Confidence scoring](https://github.com/psycho-prince/instagram-osint/blob/main/utils/confidence.py): `utils/confidence.py`
- [Risk grading](https://github.com/psycho-prince/instagram-osint/blob/main/utils/risk.py): `utils/risk.py`
- [Scoring API](https://github.com/psycho-prince/instagram-osint/blob/main/utils/scoring.py): `utils/scoring.py`
- [Report export](https://github.com/psycho-prince/instagram-osint/blob/main/reports/render.py): `reports/render.py`

### Other components

- **Investigator**
- **Instagram**
- **Web search**
- **Social platforms**
- **JSON and Markdown**

## Connections

- Investigator → CLI workflow: runs (evidence: `README.md`)
- CLI workflow → Cookie loading: loads cookies (evidence: `main.py`)
- CLI workflow → Cookie health: checks health (evidence: `main.py`)
- Cookie health → Instagram: checks session (evidence: `utils/cookies.py`)
- CLI workflow → Instagram profile: resolves and fetches (evidence: `main.py`)
- Instagram profile → Instagram: requests profile (evidence: `core/instagram.py`)
- CLI workflow → Exposure checks: checks exposure (evidence: `main.py`)
- Exposure checks → Instagram: tests endpoints (evidence: `core/instagram.py`)
- CLI workflow → Username variants: generates variants (evidence: `main.py`)
- CLI workflow → Platform presence: checks usernames (evidence: `main.py`)
- Platform presence → Social platforms: checks profiles (evidence: `enrich/usernames.py`)
- CLI workflow → Profile analysis: checks advanced profiles (evidence: `main.py`)
- Profile analysis → Social platforms: fetches profiles (evidence: `enrich/usernames.py`)
- CLI workflow → Twitter/X OSINT: runs when present (evidence: `main.py`)
- Twitter/X OSINT → Social platforms: fetches X profile (evidence: `enrich/twitter.py`)
- CLI workflow → Leak signals: checks leak signals (evidence: `main.py`)
- Leak signals → Web search: searches Bing (evidence: `enrich/leaks.py`)
- CLI workflow → Timeline consistency: infers consistency (evidence: `main.py`)
- CLI workflow → Search dorks: generates dorks (evidence: `main.py`)
- CLI workflow → Scoring API: scores report (evidence: `main.py`)
- Scoring API → Confidence scoring: calculates confidence (evidence: `utils/scoring.py`)
- Scoring API → Risk grading: grades risk (evidence: `utils/scoring.py`)
- CLI workflow → Report export: saves reports (evidence: `main.py`)
- Report export → JSON and Markdown: writes JSON or Markdown (evidence: `reports/render.py`)
