Osintgram इंस्टाग्राम पर एक OSINT टूल है। यह किसी भी उपयोगकर्ता के इंस्टाग्राम अकाउंट का उसके उपनाम से विश्लेषण करने के लिए एक इंटरैक्टिव शेल प्रदान करता है।
# Osintgram 🔎📸
[](doc/CHANGELOG.md)
[](LICENSE)
[](https://www.python.org/)
[](.github/workflows/tests.yml)
[](#quick-start)
**इसे किसी Instagram अकाउंट पर लगाइए और पता कीजिए कि इसके पीछे कौन है।** Osintgram
वह सब कुछ इकट्ठा करता है, आपस में मिलाता है और प्रस्तुत करता है जो एक सार्वजनिक प्रोफ़ाइल
दिखा देती है — फ़ॉलोअर्स, कैप्शन, हैशटैग, जियोटैग किए गए स्थान, पोस्टिंग की आदतें, सार्वजनिक
संपर्क विवरण — एक वेब इंटरफ़ेस में जिसे आप अपनी ही मशीन पर चलाते हैं।
सरल भाषा में पूछिए और एक **स्थानीय AI मॉडल** तय करता है कि कौन-सी लुकअप चलानी हैं। या
नहीं भी: कमांड खुद चुनिए और मॉडल को पूरी तरह छोड़ दीजिए।
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/143/d6eaa19d795a604cab713f300cd9b5db4dce554bc604e3436a88d3d63e6f132b/6e4b370c0dd97191375d1281f84ddf2bc1653a0379d942b46787fd1ebe124ba0-display-v1.webp" width="900" alt="Osintgram वेब इंटरफ़ेस: सीमाएँ और लागत दिखाने वाली रन शीट के साथ अनुरोध फ़ॉर्म, लिखित उत्तर, और प्रोफ़ाइल विवरण व हैशटैग के साथ क्रमांकित परिणाम प्रदर्श">
</p>
---
## आपको यह क्यों पसंद आ सकता है
**यह सवालों के जवाब देता है, सिर्फ़ कमांड नहीं।** *"उनके कितने फ़ॉलोअर्स हैं और वे सबसे
ज़्यादा कौन-से हैशटैग इस्तेमाल करते हैं?"* तीन लुकअप चलाता है और एक लिखित उत्तर लेकर आता है —
और नीचे कच्चे परिणाम भी, ताकि आप लिखावट पर भरोसा करने के बजाय काम को जाँच सकें।
**लुकअप के अलावा कुछ भी आपकी मशीन से बाहर नहीं जाता।** AI
[Ollama](https://ollama.com) के ज़रिए स्थानीय रूप से चलता है: कोई OpenAI key नहीं, कोई सदस्यता नहीं, आपका
कोई भी प्रॉम्प्ट किसी को नहीं भेजा जाता। इंटरफ़ेस `127.0.0.1` से सर्व किया जाता है।
**यह आपको बताता है कि चलाने से पहले किसी खोज पर कितना खर्च आएगा।** Instagram डेटा
मुफ़्त नहीं है, और ज़्यादातर टूल आपको महँगे तरीके से यह पता लगाने देते हैं। यह टूल
आपके चयन की कीमत पहले से बताता है, आपका शेष क्रेडिट दिखाता है, हर अनुरोध को कैश करता है ताकि
आप एक ही लुकअप के लिए दो बार भुगतान न करें, और आपको रन को सीमित या रोकने देता है —
सर्वर-साइड, सिर्फ़ ब्राउज़र में नहीं।
**यह जो पाया है उसे ठीक से दिखाता है।** फ़िल्टर करने योग्य ग्रिड में पोस्ट थंबनेल,
मानचित्र पर जियोटैग किए गए स्थान, किसी के पोस्ट करने के समय का सप्ताह-दिन × घंटा हीटमैप,
दो अकाउंट के बीच तुलना। JSON की दीवार नहीं — हालाँकि हर कार्ड पर एक क्लिक दूर JSON भी है।
**आप परिणाम किसी और को सौंप सकते हैं।** एक बटन किसी पूरी हुई खोज को एक स्टैंडअलोन HTML रिपोर्ट
में बदल देता है जो किसी भी ब्राउज़र में खुलती है, बिना किसी सर्वर और बिना
Osintgram के।
---
## इसे चलाने के दो तरीके
<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/143/423f425ac28ff28e4a24bbfa2e327d0d6a7120758dcc141a88a05ee4dc244424/6c18229ce4134dc3117d01b134aab494b5c4e8f6e36d817b4cacd9abababebfc-display-v1.webp" width="860" alt="बेस मोड: दो कॉलमों में 28 कमांड, रंग के अनुसार समूहीकृत और संकुचित करने योग्य, एक सर्च बॉक्स और रन शीट के साथ">
</p>
**AI मोड** — बताइए आपको क्या चाहिए। एक स्थानीय मॉडल कमांड चुनता है, उन्हें चलाता है
और सारांश देता है। यह केवल नीचे दी गई उसी सूची में से चुन सकता है; यह नई लुकअप
नहीं गढ़ सकता और न ही डेटा बना सकता है।
**बेस मोड** — कोई मॉडल नहीं, Ollama की ज़रूरत नहीं। सभी 29 कमांड, एक-एक पंक्ति में,
समूहीकृत और खोजने योग्य। जो चाहिए उस पर टिक लगाइए, पैरामीटर सेट कीजिए, उन्हें
क्रम से चलाइए।
आप AI मोड में उपयोगकर्ता नाम खाली भी छोड़ सकते हैं और सिर्फ़ किसी हैशटैग
या स्थान के बारे में पूछ सकते हैं — वे खोजें किसी अकाउंट की नहीं होतीं।
---
## आप क्या पता कर सकते हैं
| | |
|---|---|
| **प्रोफ़ाइल** | बायो और उसमें मौजूद हर लिंक, फ़ॉलोअर/फ़ॉलोइंग/पोस्ट की संख्या, श्रेणी, सार्वजनिक ईमेल, फ़ोन और व्यावसायिक पता निर्देशांक तक, लिंक किया गया Facebook id — साथ ही Instagram का अपना *About this account*: पंजीकरण का देश, निर्माण तिथि, उपयोगकर्ता नाम कितनी बार बदला गया |
| **नेटवर्क** | फ़ॉलोअर और फ़ॉलोइंग, Instagram द्वारा संबंधित सुझाए गए खाते, किसने उन्हें टैग किया, उन्होंने किसे टैग किया, कौन सबसे ज़्यादा टिप्पणी करता है — और दो खातों के बीच **पारस्परिक कनेक्शन** |
| **सामग्री** | उपयोग के अनुसार क्रमबद्ध हैशटैग, कैप्शन, हर टिप्पणी, लाइक और टिप्पणी के आँकड़े, व्यूज़ और पेड पार्टनरशिप के साथ फ़ोटो/वीडियो/कैरोसेल का विवरण, **पोस्टिंग-टाइम्स हीटमैप**, **मानचित्र पर** जियोटैग किए गए स्थान, फ़ोटो का alt टेक्स्ट |
| **संपर्क** | किसी लक्ष्य के फ़ॉलोअर या फ़ॉलोइंग के बीच सार्वजनिक ईमेल और फ़ोन नंबर |
| **लक्ष्य की आवश्यकता नहीं** | **हैशटैग** (टॉप या रीसेंट) या किसी **स्थान** से प्रकाशित पोस्ट, और उन्हें किसने प्रकाशित किया — साथ ही किसी विशिष्ट **पोस्ट या रील पर हर टिप्पणी**, उसका URL, शॉर्टकोड या id दिए जाने पर |
स्टोरीज़, हाइलाइट्स और प्रोफ़ाइल चित्र सीधे CDN लिंक के रूप में वापस आते हैं — और
मीडिया वाला कोई भी कार्ड ओरिजिनल्स का एक-क्लिक ज़िप प्रदान करता है।
---
## त्वरित शुरुआत
```bash
pip install -r requirements.txt
uvicorn src.web.app:app --host 127.0.0.1 --port 8000 --reload # or: make run
```
**<http://127.0.0.1:8000>** खोलें।
आपको एक डेटा बैकएंड की आवश्यकता होगी। पेज एक पैनल पर खुलता है जहाँ आप सीधे
[HikerAPI](https://hikerapi.com) कुंजी पेस्ट कर सकते हैं — इसे स्वीकार करने से
पहले सत्यापित किया जाता है, और अगली बार के लिए सहेजा जा सकता है। (एक मुफ़्त
[instagrapi](https://github.com/subzeroid/instagrapi) लॉगिन भी काम करता है, अपने
स्वयं के Instagram खाते का उपयोग करके — ट्रेड-ऑफ़ के लिए गाइड देखें।)
AI मोड के लिए, [Ollama](https://ollama.com/download) इंस्टॉल करें और एक
टूल-कॉलिंग सक्षम मॉडल पुल करें:
```bash
ollama pull llama3.1:8b # ~4.7 GB, the default
```
आधार मोड इसके बिना काम करता है।
कंटेनर पसंद हैं?
```bash
docker compose up --build # or: make docker
```
वही पता, वही व्यवहार — केवल `127.0.0.1` पर प्रकाशित। आपकी कुंजी, कैश
और सहेजी गई खोजें होस्ट पर `config/`, `cache/` और `dossier/` में रहती हैं,
कभी भी इमेज के अंदर नहीं। AI मोड आपके होस्ट पर चल रहे Ollama तक पहुँचता है।
> $${\color{red}Warning:}$$ यह `127.0.0.1` पर **बिना किसी प्रमाणीकरण** के चलता है। इसे आपकी अपनी मशीन पर चलाने के लिए बनाया गया है — पहले सामने कोई प्रमाणीकरण परत लगाए बिना इसे localhost से बाहर उजागर न करें।
### 📖 [पूरी गाइड पढ़ें → `doc/web-ui.md`](https://github.com/datalux/osintgram/blob/master/doc/web-ui.md)
दोनों बैकएंड के लिए सेटअप, प्रत्येक कमांड उसके पैरामीटर और लागत के साथ, खर्च
कम कैसे रखें, परिणाम निर्यात और साझा कैसे करें, सभी कॉन्फ़िगरेशन विकल्प,
और समस्या निवारण।
---
## इसका उपयोग करने से पहले
**केवल शैक्षिक उद्देश्य के लिए।** योगदानकर्ता इस टूल के उपयोग के लिए कोई
भी ज़िम्मेदारी नहीं लेते हैं।
- इसके साथ **अपने स्वयं के या प्राथमिक Instagram खाते का उपयोग न करें**।
- **`config/credentials.ini` को कभी कमिट न करें** — API कुंजियाँ और Instagram
क्रेडेंशियल वहीं रहते हैं। यह git-ignored है; इसे वैसा ही रखें। यदि कोई कुंजी कभी
पुश की गई है, तो उसे रोटेट करें: फ़ाइल हटाने से वह इतिहास से नहीं हटती।
- परिणामों में अन्य लोगों का व्यक्तिगत डेटा होता है। उन्हें
डेटा-संरक्षण कानून (GDPR और समकक्ष) तथा Instagram की उपयोग की शर्तों के अनुरूप संभालें।
- आप निजी प्रोफ़ाइल नहीं देख सकते। कोई नहीं देख सकता। अन्यथा दावा करने वाले टूल
घोटाले हैं।
---
## विकास
```bash
pip install -r requirements-dev.txt
python -m pytest
```
परीक्षण सूट पूरी तरह से सिंथेटिक फ़िक्स्चर के विरुद्ध चलता है — कोई API कुंजी नहीं, कोई कोटा नहीं,
कोई नेटवर्क नहीं। यह यह भी जाँचता है कि दस्तावेज़ीकरण कोड से दूर नहीं हटा है।
फ़ीचर अनुरोध और पुल अनुरोधों का स्वागत है — एक इश्यू खोलें। कोई
सुरक्षा समस्या मिली? कृपया इसके बजाय निजी तौर पर रिपोर्ट करें: देखें [SECURITY.md](https://github.com/datalux/osintgram/blob/master/SECURITY.md)।
---
## श्रेय
Osintgram को **Giuseppe Criscione**
([Datalux](https://github.com/Datalux)) द्वारा लिखा गया है। संस्करण 2.0 इसे एक वेब
इंटरफ़ेस और एक पुन: प्रयोज्य सेवा परत के इर्द-गिर्द पुनर्निर्मित करता है, और AI मोड, लागत नियंत्रण
तथा नए विश्लेषण जोड़ता है — देखें [changelog](https://github.com/datalux/osintgram/blob/master/doc/CHANGELOG.md)।
यह पहली रिलीज़ के बाद से योगदान देने वाले सभी लोगों का बहुत ऋणी है:
<a href="https://github.com/Datalux/Osintgram/graphs/contributors">
<img src="https://contributors-img.web.app/image?repo=Datalux/Osintgram" alt="Osintgram contributors">
</a>
Instagram डेटा [HikerAPI](https://hikerapi.com) या
[instagrapi](https://github.com/subzeroid/instagrapi) से आता है। जियोकोडिंग
[Nominatim](https://nominatim.org) / [OpenStreetMap](https://www.openstreetmap.org/copyright) द्वारा।
मानचित्र [Leaflet](https://leafletjs.com) द्वारा। स्थानीय मॉडल
[Ollama](https://ollama.com) के माध्यम से।
[GPL-3.0](https://github.com/datalux/osintgram/blob/master/LICENSE) लाइसेंस के अंतर्गत जारी।
Instagram, Meta Platforms, Inc. का एक ट्रेडमार्क है। यह प्रोजेक्ट Meta से संबद्ध,
समर्थित या अनुमोदित नहीं है।