BIRDY-EDWARDS 2.0

Infiltrer & Exposer

Outil automatisé d'intelligence Facebook propulsé par l'IA pour le profilage de cibles, l'analyse de réseaux et le reporting de menaces. Fonctionne entièrement sur l'appareil via Ollama. Plateforme SOCMINT Facebook propulsée par l'IA — 100 % locale, zéro dépendance au cloud. Pour la version lite, consultez ce dépôt cliquez ici

Installation · Dépannage · Avertissement · Contribution

Documentation

Des guides d'utilisation complets pour les deux modes d'investigation sont disponibles sur le site web du projet :

• Cliquez ici

Comment ça fonctionne

Nouveautés de la v2.0

• 🗽 Flexibilité — Vous pouvez désormais arrêter une investigation à n'importe quelle phase et générer un rapport PDF
• 🎬 Intelligence des reels — L'IA extrait un résumé contextuel, le sujet, les entités nommées et les hashtags de chaque légende de reel
• 🔗 Matrice de coordination des co-commentateurs — Carte thermique des personnes qui commentent aux côtés de qui. Cliquez sur n'importe quelle cellule pour voir les publications partagées
• 👤 Détection faciale hybride HOG + CNN — Sélection automatique du modèle selon la taille de l'image avec repli CNN→HOG. La détection faciale s'exécute désormais aussi sur les captures d'écran de publications textuelles
• 📬 Notifications Telegram — Le rapport PDF est automatiquement envoyé à votre chat Telegram configuré à la fin
• 📄 Suite PDF complète — Ajout des sections intelligence d'images, intelligence des reels, galerie de visages, chronologie des publications, paires de co-commentateurs. Le bengali, l'hindi, l'arabe et l'ourdou s'affichent correctement
• ⚙️ File d'attente d'investigations — Jusqu'à 5 investigations mises en file d'attente et exécutées automatiquement en séquence
• 🔄 Page de progression en temps réel — Les compteurs de statistiques en direct se débloquent à mesure que les données arrivent pendant le pipeline
• 📅 Modification de la date et de l'heure — Pendant le scraping, il est possible que nous ne recueillions que la date et non l'horodatage exact. En tant qu'enquêteur, si vous souhaitez modifier cela en un horodatage exact, c'est désormais possible.

Fonctionnalités

• 🔍 Collecte de profils — Collecte automatisée des données des publications, photos, reels, informations « À propos », commentaires, liens et noms des profils de commentateurs avec extraction de dates sur 9 stratégies
• 🗂️ Investigation par lots — Soumettez jusqu'à 10 URL de publications mixtes et exécutez le pipeline IA complet sur toutes
• 🧠 Intelligence des interactions — Analyse IA de sentiment, de position, d'émotion et de langue par interaction dans plus de 140 langues, dont le bengali, l'hindi, l'arabe, l'ourdou et le kuki
• 📊 Score des acteurs — Score composite pondéré avec classification en 5 niveaux. Les 14 principaux profils secondaires sont analysés lors des analyses moyennes et approfondies
• 🌍 Détection de pays — Le LLM identifie le pays d'origine à partir des signaux du profil avec un badge de pourcentage de confiance et une détection à la demande par commentateur
• 🔬 Intelligence d'images — LLM de vision par photo pour la scène, la foule, les symboles, les armes, l'OCR et l'estimation de localisation
• 🎬 Intelligence des reels et des publications textuelles — L'IA extrait les entités, les sujets, les types de récits et les indicateurs de menace des légendes et des publications
• 👤 Intelligence faciale — Détection hybride HOG + CNN, encodage 128D, regroupement d'identités, visualisation d'arbre facial D3
• 🕸️ Graphes de réseau — Graphe de force D3 interactif, matrice thermique des co-commentateurs avec publications partagées au clic, arêtes de regroupement par nom de famille
• 📄 Rapports PDF — Rapport d'intelligence complet avec intelligence d'images, intelligence des reels, galerie de visages, chronologie des publications, analyse des co-commentateurs et rendu multilingue des scripts
• 📬 Livraison Telegram — Le rapport PDF est envoyé automatiquement au chat configuré à la fin de l'investigation
• 🤖 IA locale — Propulsé par Ollama, gemma4:e2b / e4b / 12b et autres modèles, fonctionne sur GPU ou CPU
• 🐳 Prêt pour Docker — Déploiement en une commande sur Linux et Windows

⚠️ Avertissement

BIRDY-EDWARDS est développé strictement pour des fins autorisées d'intelligence, d'application de la loi et de recherche académique uniquement.

Portée de l'accès aux données :

• Cet outil fonctionne exclusivement avec une session Facebook valide authentifiée par l'opérateur
• Il n'accède qu'aux données de profil, publications, photos, reels et commentaires visibles publiquement
• Il n'accède pas aux messages privés, aux profils verrouillés, au contenu restreint, ni à aucune donnée non visible par un utilisateur connecté
• Il n'utilise pas de bots, de faux comptes ou de création automatisée de comptes — l'opérateur fournit sa propre session authentifiée

Responsabilité légale :

• Cet outil ne doit être utilisé que sur des profils et contenus pour lesquels vous disposez d'une autorisation légale explicite de collecter et d'analyser des données
• Une utilisation sans autorisation peut violer les Conditions d'utilisation de Facebook, les lois applicables sur la protection des données (RGPD, IT Act, DPDP Act) et les réglementations locales
• Le développeur décline toute responsabilité en cas d'utilisation abusive, de collecte non autorisée de données ou de tout préjudice causé par une utilisation inappropriée
• Toutes les investigations relèvent de la seule responsabilité de l'opérateur

En utilisant BIRDY-EDWARDS, vous confirmez que votre utilisation est légale, autorisée et conforme à toutes les lois applicables dans votre juridiction.

Configuration système requise

Installation

Prérequis

Étape 1 — Installer Docker

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

Étape 2 — Installer Ollama

• Linux :

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

• Windows : Téléchargez le programme d'installation depuis https://ollama.com/download

Étape 3 — Démarrer Ollama lié à toutes les interfaces

• Linux :

OLLAMA_HOST=0.0.0.0:11434 ollama serve

Pour rendre cela permanent :

sudo systemctl edit ollama

Ajoutez :

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

sudo systemctl daemon-reload && sudo systemctl restart ollama

• Windows : Ollama écoute sur toutes les interfaces par défaut — aucune configuration supplémentaire n'est nécessaire. Si ce n'est pas le cas,

$env:OLLAMA_HOST="0.0.0.0"
ollama serve

Démarrage rapide

Étape 1 — Cloner le dépôt

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

Étape 2 — Créer les fichiers et répertoires requis

• 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

Étape 3 — Construire l'image Docker

⚠️ La première construction prend 15 à 25 minutes — dlib compile à partir du code source. Les constructions suivantes sont rapides (couches mises en cache).

docker compose build

Étape 4 — Démarrer le conteneur

docker compose up -d

docker compose logs -f

Étape 5 — Ouvrir l'interface web

http://localhost:5000

Étape 6 — Importer les cookies de session

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

Télécharger un modèle IA

Téléchargez un modèle sur votre machine hôte :

ollama pull gemma4:e2b

Ou utilisez le panneau Modèles IA de l'interface web — sélectionnez un modèle et cliquez sur Appliquer et télécharger.

Si vous utilisez une machine virtuelle, choisissez un modèle en fonction de la RAM allouée à la machine virtuelle.

Importer les cookies de session

BIRDY-EDWARDS nécessite une session Facebook valide. Utilisez l'extension de navigateur Cookie-Editor — fonctionne sur toutes les plateformes, aucun Selenium requis.

🔒 Sécurité opérationnelle : Il est fortement recommandé d'utiliser un compte factice dédié pour les investigations plutôt que votre compte Facebook personnel. Cela protège votre identité et empêche que votre compte principal soit signalé ou restreint.

1. Installez Cookie-Editor → Chrome · Firefox
2. Connectez-vous à votre compte d'investigation dédié sur Facebook
3. Cliquez sur Cookie-Editor pendant que vous êtes sur facebook.com
4. Cliquez sur Exporter → Exporter au format JSON
5. Allez sur http://localhost:5000/tools/import-cookies et collez

Configurer les notifications Telegram

Recevez automatiquement votre rapport PDF après chaque investigation.

1. Créez un bot Telegram via @BotFather et copiez le jeton du bot
2. Obtenez votre identifiant de chat — envoyez un message à votre bot puis visitez https://api.telegram.org/bot<TOKEN>/getUpdates
3. Allez dans le panneau Telegram de l'interface web
4. Collez votre jeton de bot et votre identifiant de chat, puis cliquez sur Enregistrer
5. Cliquez sur Tester pour vérifier la connexion

À partir de ce moment, chaque investigation terminée envoie automatiquement une notification avec le rapport PDF en pièce jointe.

Comment vous pouvez aider

Si vous trouvez BIRDY-EDWARDS utile ou intéressant, voici quelques façons de soutenir le projet :

• ⭐ Mettez une étoile au dépôt — cela aide d'autres personnes à découvrir l'outil
• 🐛 Signalez des bugs — ouvrez une issue si quelque chose ne fonctionne pas
• 🔧 Contribuez — consultez la section Contribution pour commencer
• 📢 Partagez-le — publiez-le dans les communautés OSINT, les forums, sur X ou avec des collègues qui pourraient le trouver utile
• 💬 Donnez votre avis — les suggestions de nouvelles fonctionnalités ou d'améliorations sont toujours les bienvenues

Chaque contribution, grande ou petite, aide à créer de meilleurs outils pour la communauté OSINT et du renseignement sur les menaces.

Dépannage

Ollama inaccessible depuis Docker

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

Si cela échoue, redémarrez Ollama avec OLLAMA_HOST=0.0.0.0:11434 ollama serve

Erreur de base de données : table inexistante ou autre erreur liée à la base de données
Lancez une nouvelle investigation — le schéma est créé automatiquement lors de la première utilisation. Si vous arrêtez le processus pendant l'analyse, supprimez cette investigation et lancez-en une nouvelle.

Cookies expirés
Allez sur http://localhost:5000/tools/import-cookies et réimportez des cookies frais.

Le port 5000 est déjà utilisé
Modifiez dans docker-compose.yml : "5001:5000" puis accédez à http://localhost:5001

Mémoire insuffisante pendant la construction
Augmentez la mémoire de Docker Desktop à 8 Go ou plus via Paramètres → Ressources → Mémoire

La carte ne se charge pas
Les tuiles Leaflet + ArcGIS nécessitent un accès Internet sur la machine hôte. Si vous fonctionnez entièrement hors ligne, le conteneur de carte apparaîtra vide — toutes les autres fonctionnalités fonctionnent normalement.

Telegram n'envoie pas
Confirmez que votre bot a été démarré en lui envoyant un message /start. Vérifiez que l'identifiant de chat est correct à l'aide de l'URL getUpdates. Vérifiez que le port 443 n'est pas bloqué sur votre réseau.

Contribution

Les contributions sont les bienvenues. Veuillez suivre ces directives pour garder le projet propre et cohérent.

Signaler des bugs

• Ouvrez une issue décrivant le bug, les étapes pour le reproduire et votre environnement (système d'exploitation, RAM, version de Docker)
• Joignez les journaux pertinents de docker compose logs

Demandes de fonctionnalités

• Ouvrez une issue avec une description claire de la fonctionnalité et de son cas d'utilisation
• Discutez avant d'ouvrir une demande de tirage (pull request) pour les changements importants

Soumettre une demande de tirage (pull request)

• Forkez le dépôt
• Créez une branche de fonctionnalité : git checkout -b feature/nom-de-votre-fonctionnalite
• Validez vos modifications : git commit -m "Ajout : courte description"
• Poussez vers votre branche : git push origin feature/nom-de-votre-fonctionnalite
• Ouvrez une demande de tirage vers main

Directives de code

• Suivez le style de code existant — Python 3.12, conventions Flask
• Testez vos modifications localement via Docker avant de soumettre
• Ne validez pas fb_cookies.pkl, les bases de données ni aucune donnée collectée
• Gardez les modifications du scraper minimales — le DOM de Facebook change fréquemment

Ce que nous accueillons favorablement

• Corrections de bugs et améliorations de stabilité
• Prise en charge de nouveaux modèles Ollama
• Améliorations de l'interface utilisateur
• Améliorations de la documentation
• Prise en charge de langues supplémentaires pour l'OCR et l'analyse des commentaires

Ce que nous n'acceptons pas

• Les fonctionnalités qui contournent les contrôles de sécurité des plateformes
• Les modifications qui introduisent des dépendances au cloud
• Le code qui stocke ou transmet des données d'investigation en externe

Remerciements

• Inspiré par Sherlock
• Inspiré par la communauté de recherche OSINT et du renseignement sur les menaces
• SeleniumBase — Automatisation Chrome non détectée
• Ollama — Moteur d'inférence LLM local
• face_recognition — Bibliothèque de détection et d'encodage facial
• Leaflet — Bibliothèque de cartes interactives
• ArcGIS — Tuiles cartographiques avec des frontières constitutionnelles correctes
• pyvis — Visualisation interactive de graphes de réseau
• reportlab — Génération de PDF
• pytesseract — Wrapper du moteur OCR
• D3.js — Visualisation de données et graphes interactifs