Skip to content
FaceSearch: Searches for faces in a given image using the Google Reverse Image Search engine.
Python Shell
Branch: master
Clone or download
IAmSuyogJadhav Merge pull request #1 from ujjawaljaiswal2017/master
Added AGPL licence to the project
Latest commit abd9ce8 Oct 22, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.facesearch Added support for close with [x] Aug 10, 2018
example Update README Jul 11, 2018 Added AGPL licence to the project Oct 22, 2019
Project_Report.pdf Added project report Aug 7, 2018 Updated README Oct 21, 2018 Updated script to install pip3 Oct 20, 2018


   █▀▀ █▀▀█ █▀▀ █▀▀   █▀▀ █▀▀ █▀▀█ █▀▀█ █▀▀ █  █       
   █▀▀ █▄▄█ █   █▀▀   ▀▀█ █▀▀ █▄▄█ █▄▄▀ █   █▀▀█       
   ▀   ▀  ▀ ▀▀▀ ▀▀▀   ▀▀▀ ▀▀▀ ▀  ▀ ▀ ▀▀ ▀▀▀ ▀  ▀       

FaceSearch: Searches for faces in a given image using the Google Reverse Image Search engine.


  1. Directly download the latest release from the releases page.

OR 2. First clone this repo. Now, to install the dependencies and create the alias for FaceSearch, run the



Once it finishes, you can now use the following command on the terminal to detect and search for the faces in any image.

facesearch path/to/Image

Also, note that the path/to/Image can be an internet URL as well! (prefixed with http: or https:) So, you can just drag an image off the internet over the terminal to get its URL pasted over there and search for faces in it using FaceSearch. Really convenient.


Test image:

alt text

On command line:

anon@anon-pc:~/FaceSearch$ facesearch example/test.jpg
[ INFO:0] Initialize OpenCL runtime...
Uploading image..
Thanks for using this tool! Please report any issues to github.
anon@anon-pc:~/FaceSearch$ Created new window in existing browser session.

Output Window:

alt text

In the browser:

alt text

Any feedback, bug reports and issues are welcome here!


  • 05-08-18: A blog post detailing the implementation and working of FaceSearch is live now. Read it here.
  • 07-08-18: The project report is now ready! You can read it here.
  • 10-08-18: Added support for closing the output window by GUI [x] button.
  • 12-10-18: Thanks to Kaj, fixed an easy-to-miss bug. The script previously used the default system python; but, this caused an issue because of the list.copy() method not being defined in Python 2. Changed the script to explicitly use Python 3 now. Also, added a function in to remove any redundant aliases defined by the same name facesearch, to prevent problems occured because of running script multiple times.
  • 18-10-18: Created and released the first release of FaceSearch (v1.0). Now directly downloadable from here.

Image Source: Rediff

You can’t perform that action at this time.