EagleEye | Stalk Your Friends | Find Instagram, FB & Twitter Profiles Using Image Recognition & Reverse Image Search


With technology you can find someone social account with just image, we know face recognition is not just a myth, because with just image of a person you can find anything that assosiated with that.


Stalk your Friends. Find their Instagram, FB and Twitter Profiles using Image Recognition and Reverse Image Search.

With EagleEye you can stalk someone and find their social accounts with deep searching. This tool is also use image to find informations about the target. Eagle Eye is make you more easier to perform information gathering.

You have at least one image of the person you are looking for and a clue about their name. You enter this data into EagleEye and it tries to find Instagram, Youtube, Facebook, and Twitter Profiles of this person.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.


  • A system with a x-server installed (Linux)
  • Firefox installed

When using docker

  • Only docker is required

When you dont use docker

  • Python 3.6 or higher
  • Pythons pip


Docker (Preferred)

Make sure that you have docker installed Make sure that you use a LINUX distribution as the host

  1. Clone the Repository $ git clone https://github.com/ThoughtfulDev/EagleEye
$ cd EagleEye
$ sudo docker build -t eagle-eye - < dockerfile
  1. Now create a known folder and a result folder anywhere on your PC.
  2. Put the images of the known person in the known folder.
  3. Change the name of the person your are searching for in entry.sh
  4. Start the container. Make sure to edit the paths :
sudo docker run -t --net=host --env="DISPLAY" \
                           --volume="$HOME/.Xauthority:/root/.Xauthority:rw"  \
                           -v  /path/to/known:/EagleEye/known \
                           -v  /path/to/result:/result \
                           -v /path/to/EagleEye/Repository/entry.sh:/entry.sh \

The result should now be in /path/to/result

Automated Prequisites Installation (If Docker doesn’t work)

wget https://raw.githubusercontent.com/ThoughtfulDev/EagleEye/master/install.sh && chmod +x install.sh && ./install.sh

Manual Prequisites Installation (If you are hardcore)

For Debian based Distros

$ sudo apt update && sudo apt upgrade -y
$ sudo apt install git python3 python3-pip python3-dev
$ sudo apt install libgtk-3-dev libboost-all-dev build-essential cmake libffi-dev
$ git clone https://github.com/ThoughtfulDev/EagleEye
$ cd EagleEye && sudo pip3 install -r requirements.txt
$ sudo pip3 install --upgrade beautifulsoup4 html5lib spry

For Arch

$ sudo pacman -Syu
$ sudo pacman -S git python python-pip gtk3 boost cmake libffi
$ git clone https://github.com/ThoughtfulDev/EagleEye
$ cd EagleEye && sudo pip3 install -r requirements.txt
$ sudo pip3 install --upgrade beautifulsoup4 html5lib spry

If Firefox is installed, download the latest release of the Geckodriver for you Architecture.

If you get a broken pipe Error use Geckodriver Version 0.19.1.

Note: If you are using Firefox ESR (like Kali does) please use the Geckodriver Version 0.17.

Make the Geckodriver executable:

$ chmod +x /path/to/geckodriver

Note: The geckodriver prefers to be in your path so wherever you do set it up you will likely need to setup a link to somewhere in your PATH (or add it to your PATH).


$ sudo ln -s /path/to/geckodriver /usr/local/bin/geckodriver

:balloon: Usage

Configuration: General

Change the value in config.json to the path of the geckodriver e.g

    "DEFAULTS": {
    "WEBDRIVER": {
        "ENGINE": "firefox",
        "PATH": "/usr/local/bin/geckodriver"
    "FILTER": [

Configuration: Images

Put at least one Image of the Person you want to find in the known folder.

Supported Filetypes are: jpg/JPG, jpeg/JPEG, png/PNG, and bmp/BMP.


Then run the program :wink:

$ python3 eagle-eye.py

To see a list of all available Options just type

$ python3 eagle-eye.py -h

The ImageRaider Reverse Image Search can take some minutes 1-15 Minutes depending on the count of Images


  • Implement the Chrome Webdriver

:pick: Built Using



seems awesome but i think its not suitable for noobs like me.
can we deploy it in heroku?
can you made a tutorial for heroku and usage?