BIRDY-EDWARDS 2.0

घुसपैठ और उजागर करें

लक्ष्य प्रोफाइलिंग, नेटवर्क विश्लेषण और खतरे की रिपोर्टिंग के लिए स्वचालित AI-संचालित Facebook खुफिया उपकरण। पूरी तरह से Ollama के माध्यम से डिवाइस पर चलता है। AI-संचालित Facebook SOCMINT प्लेटफ़ॉर्म — 100% स्थानीय, शून्य क्लाउड निर्भरता। लाइट संस्करण के लिए इस रेपो को देखें यहाँ क्लिक करें

स्थापना · समस्या निवारण · अस्वीकरण · योगदान

दस्तावेज़ीकरण

दोनों जांच मोड के लिए पूर्ण उपयोग गाइड प्रोजेक्ट वेबसाइट पर उपलब्ध हैं:

• यहाँ क्लिक करें

यह कैसे काम करता है

v2.0 में नया क्या है

• 🗽 लचीलापन - अब आप किसी भी चरण में जांच रोक सकते हैं और रिपोर्ट PDF उत्पन्न कर सकते हैं
• 🎬 रील खुफिया — AI हर रील कैप्शन से संदर्भ सारांश, विषय, नामित संस्थाएं और हैशटैग निकालता है
• 🔗 सह-टिप्पणीकार समन्वय मैट्रिक्स — हीटमैप कि कौन किसके साथ टिप्पणी करता है। साझा पोस्ट देखने के लिए किसी भी सेल पर क्लिक करें
• 👤 HOG + CNN हाइब्रिड चेहरा पहचान — CNN→HOG फ़ॉलबैक के साथ छवि आकार द्वारा स्वचालित मॉडल चयन। चेहरा पहचान अब टेक्स्ट पोस्ट स्क्रीनशॉट पर भी चलती है
• 📬 टेलीग्राम सूचनाएं — पूर्ण होने पर PDF रिपोर्ट स्वचालित रूप से आपके कॉन्फ़िगर किए गए टेलीग्राम चैट पर भेजी जाती है
• 📄 पूर्ण PDF सुइट — छवि खुफिया, रील खुफिया, चेहरा गैलरी, पोस्ट टाइमलाइन, सह-टिप्पणीकार जोड़े अनुभाग जोड़े गए। बंगाली, हिंदी, अरबी, उर्दू सही ढंग से प्रस्तुत होते हैं
• ⚙️ जांच कतार — 5 तक जांचें कतारबद्ध और क्रमिक रूप से स्वचालित रूप से निष्पादित होती हैं
• 🔄 रीयल-टाइम प्रगति पृष्ठ — पाइपलाइन के दौरान डेटा आने पर लाइव स्टेट काउंटर अनलॉक होते हैं
• 📅 दिनांक और समय संशोधन - स्क्रैपिंग के दौरान यह संभव है कि हम केवल दिनांक एकत्र करें, सटीक टाइमस्टैम्प नहीं, इसलिए एक जांचकर्ता के रूप में यदि आप इसे सटीक टाइमस्टैम्प में संशोधित करना चाहते हैं तो यह अब संभव है।

विशेषताएं

• 🔍 प्रोफ़ाइल संग्रह — 9-रणनीति दिनांक निष्कर्षण के साथ पोस्ट, फ़ोटो, रील, अबाउट डेटा, टिप्पणियां, टिप्पणीकार प्रोफ़ाइल लिंक और नामों का स्वचालित डेटा संग्रह
• 🗂️ बैच जांच — 10 तक मिश्रित पोस्ट URL जमा करें और उन सभी पर पूर्ण AI पाइपलाइन चलाएं
• 🧠 इंटरैक्शन खुफिया — बंगाली, हिंदी, अरबी, उर्दू, कुकी सहित 140+ भाषाओं में प्रति इंटरैक्शन AI भावना, रुख, भावना और भाषा विश्लेषण
• 📊 अभिनेता स्कोरिंग — 5-स्तरीय वर्गीकरण के साथ भारित समग्र स्कोर। मध्यम और गहन स्कैन में शीर्ष 14 माध्यमिक प्रोफ़ाइल स्क्रैप की जाती हैं
• 🌍 देश पहचान — LLM प्रोफ़ाइल संकेतों से मूल देश की पहचान करता है, विश्वास % बैज और मांग पर प्रति-टिप्पणीकार पहचान के साथ
• 🔬 छवि खुफिया — दृश्य, भीड़, प्रतीक, हथियार, OCR और स्थान अनुमान के लिए प्रति फ़ोटो विज़न LLM
• 🎬 रील + टेक्स्ट पोस्ट खुफिया — AI कैप्शन और पोस्ट से संस्थाएं, विषय, कथा प्रकार और खतरे के संकेतक निकालता है
• 👤 चेहरा खुफिया — HOG + CNN हाइब्रिड पहचान, 128D एन्कोडिंग, पहचान क्लस्टरिंग, D3 चेहरा वृक्ष विज़ुअलाइज़ेशन
• 🕸️ नेटवर्क ग्राफ़ — इंटरैक्टिव D3 फोर्स ग्राफ़, क्लिक पर साझा पोस्ट के साथ सह-टिप्पणीकार हीटमैप मैट्रिक्स, उपनाम क्लस्टर किनारे
• 📄 PDF रिपोर्ट — छवि खुफिया, रील खुफिया, चेहरा गैलरी, पोस्ट टाइमलाइन, सह-टिप्पणीकार विश्लेषण और बहुभाषी स्क्रिप्ट प्रतिपादन के साथ पूर्ण खुफिया रिपोर्ट
• 📬 टेलीग्राम वितरण — जांच पूर्ण होने पर PDF रिपोर्ट स्वचालित रूप से कॉन्फ़िगर किए गए चैट पर भेजी जाती है
• 🤖 स्थानीय AI — Ollama संचालित, gemma4:e2b / e4b / 12b और अन्य मॉडल, GPU या CPU पर चलता है
• 🐳 Docker तैयार — Linux और Windows पर एक कमांड तैनाती

⚠️ अस्वीकरण

BIRDY-EDWARDS को विशेष रूप से अधिकृत खुफिया, कानून प्रवर्तन और शैक्षणिक अनुसंधान उद्देश्यों के लिए विकसित किया गया है।

डेटा पहुंच का दायरा:

• यह उपकरण विशेष रूप से ऑपरेटर द्वारा प्रमाणित एक वैध Facebook सत्र का उपयोग करके संचालित होता है
• यह केवल सार्वजनिक रूप से दृश्यमान प्रोफ़ाइल डेटा, पोस्ट, फ़ोटो, रील और टिप्पणियों तक पहुंचता है
• यह निजी संदेशों, लॉक किए गए प्रोफ़ाइल, प्रतिबंधित सामग्री या किसी भी डेटा तक पहुंच नहीं करता है जो लॉग-इन उपयोगकर्ता को दिखाई नहीं देता है
• यह बॉट, नकली खाते या स्वचालित खाता निर्माण का उपयोग नहीं करता है — ऑपरेटर अपना स्वयं का प्रमाणित सत्र प्रदान करता है

कानूनी जिम्मेदारी:

• इस उपकरण का उपयोग केवल उन प्रोफ़ाइल और सामग्री पर किया जाना चाहिए जहां आपके पास डेटा एकत्र करने और विश्लेषण करने के लिए स्पष्ट कानूनी प्राधिकरण है
• बिना प्राधिकरण के उपयोग Facebook की सेवा की शर्तों, लागू गोपनीयता कानूनों (GDPR, IT Act, DPDP Act) और स्थानीय विनियमों का उल्लंघन कर सकता है
• डेवलपर दुरुपयोग, अनधिकृत डेटा संग्रह या अनुचित उपयोग से होने वाले किसी भी नुकसान के लिए कोई दायित्व नहीं मानता है
• सभी जांचें ऑपरेटर की एकमात्र जिम्मेदारी हैं

BIRDY-EDWARDS का उपयोग करके, आप पुष्टि करते हैं कि आपका उपयोग कानूनी, अधिकृत है और आपके क्षेत्राधिकार में सभी लागू कानूनों के अनुरूप है।

सिस्टम आवश्यकताएं

स्थापना

पूर्वापेक्षाएँ

चरण 1 — Docker स्थापित करें

• Linux: https://docs.docker.com/engine/install/ubuntu/
• Windows: https://docs.docker.com/desktop/install/windows-install/

चरण 2 — Ollama स्थापित करें

• Linux:

curl -fsSL https://ollama.com/install.sh | sh

• Windows: https://ollama.com/download से इंस्टॉलर डाउनलोड करें

चरण 3 — सभी इंटरफेस से बंधा हुआ Ollama प्रारंभ करें

• Linux:

OLLAMA_HOST=0.0.0.0:11434 ollama serve

इसे स्थायी बनाने के लिए:

sudo systemctl edit ollama

जोड़ें:

[Service]
Environment="OLLAMA_HOST=0.0.0.0:11434"

sudo systemctl daemon-reload && sudo systemctl restart ollama

• Windows: Ollama डिफ़ॉल्ट रूप से सभी इंटरफेस पर सुनता है — कोई अतिरिक्त कॉन्फ़िगरेशन आवश्यक नहीं है। यदि नहीं, तो,

$env:OLLAMA_HOST="0.0.0.0"
ollama serve

त्वरित प्रारंभ

चरण 1 — रिपॉजिटरी क्लोन करें

git clone https://github.com/jeet-ganguly/birdy-edwards.git
cd birdy-edwards

चरण 2 — आवश्यक फ़ाइलें और निर्देशिकाएं बनाएं

• Linux:

mkdir -p app/reports app/face_data app/post_screenshots app/status
touch app/fb_cookies.pkl app/socmint.db app/socmint_manual.db app/.ollama_model app/queue.db

• Windows (PowerShell):

New-Item -ItemType Directory app/reports, app/face_data, app/post_screenshots, app/status
New-Item -ItemType File app/fb_cookies.pkl, app/socmint.db, app/socmint_manual.db, app/.ollama_model

चरण 3 — Docker छवि बनाएं

⚠️ पहला बिल्ड 15–25 मिनट लेता है — dlib स्रोत से संकलित होता है। बाद के बिल्ड तेज़ होते हैं (लेयर कैश्ड होती हैं)।

docker compose build

चरण 4 — कंटेनर प्रारंभ करें

docker compose up -d

docker compose logs -f

चरण 5 — वेब UI खोलें

http://localhost:5000

चरण 6 — सत्र कुकीज़ आयात करें

http://localhost:5000/tools/import-cookies

AI मॉडल खींचें

अपने होस्ट मशीन पर एक मॉडल खींचें:

ollama pull gemma4:e2b

या वेब UI में AI मॉडल पैनल का उपयोग करें — एक मॉडल चुनें और Apply & Pull पर क्लिक करें।

यदि आप वर्चुअल मशीन का उपयोग कर रहे हैं, तो VM के आवंटित RAM के अनुसार एक मॉडल चुनें।

सत्र कुकीज़ आयात करें

BIRDY-EDWARDS को एक वैध Facebook सत्र की आवश्यकता होती है। Cookie-Editor ब्राउज़र एक्सटेंशन का उपयोग करें — सभी प्लेटफ़ॉर्म पर काम करता है, Selenium की आवश्यकता नहीं है।

🔒 परिचालन सुरक्षा: दृढ़ता से अनुशंसा की जाती है कि जांच के लिए अपने व्यक्तिगत Facebook खाते के बजाय एक समर्पित सॉक पपेट खाते का उपयोग करें। यह आपकी पहचान की रक्षा करता है और आपके प्राथमिक खाते को फ़्लैग या प्रतिबंधित होने से रोकता है।

1. Cookie-Editor स्थापित करें → Chrome · Firefox
2. Facebook पर अपने समर्पित जांच खाते में लॉग इन करें
3. facebook.com पर रहते हुए Cookie-Editor पर क्लिक करें
4. Export → Export as JSON पर क्लिक करें
5. http://localhost:5000/tools/import-cookies पर जाएं और पेस्ट करें

टेलीग्राम सूचनाएं कॉन्फ़िगर करें

हर जांच के बाद अपनी PDF रिपोर्ट स्वचालित रूप से प्राप्त करें।

1. @BotFather के माध्यम से एक टेलीग्राम बॉट बनाएं और बॉट टोकन कॉपी करें
2. अपना चैट ID प्राप्त करें — अपने बॉट को एक संदेश भेजें फिर https://api.telegram.org/bot<TOKEN>/getUpdates पर जाएं
3. वेब UI में टेलीग्राम पैनल पर जाएं
4. अपना बॉट टोकन और चैट ID पेस्ट करें और Save पर क्लिक करें
5. कनेक्शन सत्यापित करने के लिए Test पर क्लिक करें

इस बिंदु से हर पूर्ण जांच स्वचालित रूप से PDF रिपोर्ट संलग्न के साथ एक सूचना भेजती है।

आप कैसे मदद कर सकते हैं

यदि आपको BIRDY-EDWARDS उपयोगी या दिलचस्प लगता है, तो यहां कुछ तरीके हैं जिनसे आप प्रोजेक्ट का समर्थन कर सकते हैं:

• ⭐ रिपॉजिटरी को स्टार करें — यह दूसरों को उपकरण खोजने में मदद करता है
• 🐛 बग रिपोर्ट करें — यदि कुछ काम नहीं कर रहा है तो एक Issue खोलें
• 🔧 योगदान करें — शुरू करने के लिए Contributing अनुभाग देखें
• 📢 इसे साझा करें — इसे OSINT समुदायों, फ़ोरम, X या सहकर्मियों के साथ पोस्ट करें जिन्हें यह उपयोगी लग सकता है
• 💬 प्रतिक्रिया दें — नई सुविधाओं या सुधारों के लिए सुझाव हमेशा स्वागत योग्य हैं

हर योगदान, बड़ा या छोटा, OSINT और खतरे की खुफिया समुदाय के लिए बेहतर उपकरण बनाने में मदद करता है।

समस्या निवारण

Ollama Docker से पहुंच योग्य नहीं है

docker exec -it birdy-edwards curl http://host.docker.internal:11434/api/tags

यदि यह विफल होता है, तो OLLAMA_HOST=0.0.0.0:11434 ollama serve के साथ Ollama को पुनः प्रारंभ करें

DB त्रुटि: no such table या अन्य DB संबंधित त्रुटि
एक नई जांच शुरू करें — स्कीमा पहले उपयोग पर स्वचालित रूप से बनाई जाती है। यदि आप विश्लेषण के दौरान प्रक्रिया रोकते हैं, तो उस जांच को हटाएं और एक नई शुरू करें।

कुकीज़ समाप्त हो गईं
http://localhost:5000/tools/import-cookies पर जाएं और ताज़ा कुकीज़ पुनः आयात करें।

पोर्ट 5000 पहले से उपयोग में है
docker-compose.yml में बदलें: "5001:5000" फिर http://localhost:5001 पर पहुंचें

बिल्ड के दौरान मेमोरी कम
Settings → Resources → Memory के माध्यम से Docker Desktop मेमोरी को 8 GB+ तक बढ़ाएं

मानचित्र लोड नहीं हो रहा
Leaflet + ArcGIS टाइल्स को होस्ट मशीन पर इंटरनेट एक्सेस की आवश्यकता होती है। यदि पूरी तरह से एयर-गैप्ड चल रहा है, तो मानचित्र कंटेनर खाली दिखाई देगा — अन्य सभी सुविधाएं सामान्य रूप से काम करती हैं।

टेलीग्राम नहीं भेज रहा
पुष्टि करें कि आपका बॉट /start संदेश भेजकर शुरू किया गया है। getUpdates URL का उपयोग करके चैट ID सही है यह सत्यापित करें। जांचें कि आपके नेटवर्क पर पोर्ट 443 अवरुद्ध नहीं है।

योगदान

योगदान स्वागत योग्य हैं। प्रोजेक्ट को स्वच्छ और सुसंगत रखने के लिए कृपया इन दिशानिर्देशों का पालन करें।

बग रिपोर्ट करना

• बग, पुनरुत्पादन के चरण और आपके वातावरण (OS, RAM, Docker संस्करण) का वर्णन करते हुए एक Issue खोलें
• docker compose logs से प्रासंगिक लॉग संलग्न करें

सुविधा अनुरोध

• सुविधा और उसके उपयोग के मामले के स्पष्ट विवरण के साथ एक Issue खोलें
• बड़े परिवर्तनों के लिए Pull Request खोलने से पहले चर्चा करें

Pull Request जमा करना

• रिपॉजिटरी को फोर्क करें
• एक फीचर शाखा बनाएं: git checkout -b feature/your-feature-name
• अपने परिवर्तन कमिट करें: git commit -m "Add: short description"
• अपनी शाखा पर पुश करें: git push origin feature/your-feature-name
• main के विरुद्ध एक Pull Request खोलें

कोड दिशानिर्देश

• मौजूदा कोड शैली का पालन करें — Python 3.12, Flask परंपराएं
• जमा करने से पहले अपने परिवर्तनों को Docker के माध्यम से स्थानीय रूप से परीक्षण करें
• fb_cookies.pkl, डेटाबेस या किसी भी स्क्रैप किए गए डेटा को कमिट न करें
• स्क्रैपर परिवर्तन न्यूनतम रखें — Facebook DOM बार-बार बदलता है

हम क्या स्वागत करते हैं

• बग फिक्स और स्थिरता सुधार
• नया Ollama मॉडल समर्थन
• UI सुधार
• दस्तावेज़ीकरण सुधार
• OCR और टिप्पणी विश्लेषण के लिए अतिरिक्त भाषा समर्थन

हम क्या स्वीकार नहीं करते

• प्लेटफ़ॉर्म सुरक्षा नियंत्रणों को बायपास करने वाली सुविधाएं
• क्लाउड निर्भरताएं पेश करने वाले परिवर्तन
• जांच डेटा को बाहरी रूप से संग्रहीत या प्रसारित करने वाला कोड

आभार

• Sherlock से प्रेरित
• OSINT और खतरे की खुफिया अनुसंधान समुदाय से प्रेरित
• SeleniumBase — अनपहचाना Chrome स्वचालन
• Ollama — स्थानीय LLM अनुमान इंजन
• face_recognition — चेहरा पहचान और एन्कोडिंग लाइब्रेरी
• Leaflet — इंटरैक्टिव मानचित्र लाइब्रेरी
• ArcGIS — सही संवैधानिक सीमाओं के साथ मानचित्र टाइल्स
• pyvis — इंटरैक्टिव नेटवर्क ग्राफ़ विज़ुअलाइज़ेशन
• reportlab — PDF निर्माण
• pytesseract — OCR इंजन रैपर
• D3.js — डेटा विज़ुअलाइज़ेशन और इंटरैक्टिव ग्राफ़