ecsnavarretemit / cmsc265-image-search-engine-skin

CMSC 265 Exercise 8 written in Python, Flask, and OpenCV

CMSC 265 Exercise 8 - Image Search Engine (Skin)

Requirements

1. Python 2.7.x
2. OpenCV 3.x

Note: Make sure that Python is compiled with framework enabled when installing on macOS systems.

Installing dependencies

This project requires a working installation of OpenCV 3. Please install this first before installing the project dependencies.

Dependencies of this project can be installed via PIP.

Follow these steps to install the setup the application:

1. Run the command virtualenv venv to setup a Python 2 virtual environment.

2. Activate the virtual environment by running source venv/bin/activate

3. Install the project dependencies by running pip install -r requirements.txt

4. Locate your OpenCV Python bindings and type the command echo <Python OpenCV bindings path> >> ./venv/lib/<python version>/site-packages/opencv3.pth.

   Where:

   1. <Python CV bindings path>: is the site-packages folder inside the OpenCV installation. Please make sure you select the appropriate version of bindings that matches the Python version declared in the requirements.

   2. <python version>: is the version under your venv virtual environment folder

5. Create the folder assets/img inside the root of the project directory and place the input images inside the newly created folder.

Running the Program

You can run the program by invoking python run.py or ./run.py to start the Flask application provided that the images have been already processed. If the images are not yet processed, execute the image processing script using the command python bootstrap.py or ./bootstrap.py. This will take time depending on the number of images to be processed so please be patient.

License

MIT