Upload 6 files

.gitignore

@@ -0,0 +1,2 @@
+config/
+.DS_Store

Dockerfile

@@ -0,0 +1,23 @@
+# start with a base image
+FROM ubuntu:16.04
+
+# install dependencies
+RUN apt-get update
+RUN apt-get install -y python python-pip
+RUN apt-get install -y libglib2.0-0
+
+# Copy the current directory contents into the container
+COPY . .
+
+# Install any needed packages specified in requirements.txt
+RUN pip install --trusted-host pypi.python.org -r requirements.txt
+
+# Make port 8000 available outside this container
+EXPOSE 8000
+
+# Set the working directory to /app
+WORKDIR app
+
+# run script to generate image histogram from DB
+# Run app.py when the container launches
+CMD ["gunicorn", "-b", "0.0.0.0:8000", "app:app"]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Kene Udeh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

Procfile

@@ -0,0 +1 @@
+web: cd app && gunicorn app:app

README.md

@@ -1,11 +1,35 @@
----
-title: Image Search Engine
-emoji: 🐨
-colorFrom: purple
-colorTo: blue
-sdk: docker
-pinned: false
-license: other
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Image-Search-Engine
+Content-Based Image Retrieval System Implemented Using Python, Flask And OpenCV.
+* Given a query image, this app returns other images from database in order of similar color content.
+* Uses a color histogram to define the color content of an image, uses chi-squared distance to determine
+how similar two image histograms are.
+
+## Usage Guide
+1. To use a different image dataset (optional)
+    * Populate image DB in `app/static/images`
+    * Then in Terminal: 
+      ```bash
+      >> python3 -m venv venv
+      >> source venv/bin/activate
+      >> pip install -r requirements.txt
+      >> cd app
+      >> python index.py --dataset static/images --index index.csv
+      ```
+
+2. Run locally using Docker
+    * Install [Docker](https://docs.docker.com/install/#supported-platforms)
+    * Then in Terminal:
+      ```bash
+      >> docker build --tag=imagesearch .
+      >> docker run -p 80:8000 imagesearch
+      ```
+* You should be able to access app at `localhost:80` in browser
+
+
+### Sources
+* [pyimagesearch.com](https://www.pyimagesearch.com/start-here-learn-computer-vision-opencv/)
+* [flask docs](http://flask.pocoo.org)
+* [content-based image retrieval](https://en.wikipedia.org/wiki/Content-based_image_retrieval)
+
+
+Project was made possible thanks to the many guides provided by [@Adrian Rosebrock](https://twitter.com/pyimagesearch) on [pyimagesearch.com](https://www.pyimagesearch.com/start-here-learn-computer-vision-opencv/)

requirements.txt

@@ -0,0 +1,28 @@
+appdirs==1.4.0
+certifi==2018.8.24
+click==6.7
+cloudpickle==0.8.0
+cycler==0.10.0
+dask==1.1.4
+decorator==4.0.11
+Flask==1.0.2
+gunicorn==19.7.0
+itsdangerous==0.24
+Jinja2>=2.10.1
+MarkupSafe==1.0
+matplotlib==2.0.0
+networkx==1.11
+numpy==1.12.0
+olefile==0.44
+opencv-contrib-python==3.3.0.9
+packaging==16.8
+Pillow==6.2.0
+pyparsing==2.1.10
+python-dateutil==2.6.0
+pytz==2016.10
+PyWavelets==1.0.2
+scikit-image==0.14.2
+scipy==0.19.0
+six==1.10.0
+toolz==0.8.2
+Werkzeug==0.15.3