upload

.gitignore

@@ -0,0 +1,108 @@
+# app specific files
+peter*.jpg
+# received_files/
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/

Dockerfile

@@ -0,0 +1,14 @@
+# read the doc: https://huggingface.co/docs/hub/spaces-sdks-docker
+# you will also find guides on how best to write your Dockerfile
+
+FROM python:3.9
+
+WORKDIR /code
+
+COPY ./requirements.txt /code/requirements.txt
+
+RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt
+
+COPY . .
+
+CMD ["uvicorn", "-b", "0.0.0.0:7860", "flask_server:app"]

Info.txt

@@ -0,0 +1,4 @@
+Peter2.jpg file size: 89KB
+Post form data content length: 91162
+Post base64 data content length: 121396 
+(121396 - 91162) / 91162 = 33%

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2019 Peter Jiping Xie
+
+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.

app.py

@@ -0,0 +1,156 @@
+from flask import Flask, request, redirect, jsonify
+from werkzeug.utils import secure_filename
+import os
+import json
+from face_util import compare_faces, face_rec, find_facial_features, find_face_locations
+import re
+import base64
+
+app = Flask(__name__)
+
+UPLOAD_FOLDER = 'received_files'
+ALLOWED_EXTENSIONS = ['png', 'jpg', 'jpeg']
+
+def allowed_file(filename):
+    return '.' in filename and \
+           filename.rsplit('.', 1)[1].lower() in ALLOWED_EXTENSIONS
+
+def print_request(request):
+    # Print request url
+    print(request.url)
+    # print relative headers
+    print('content-type: "%s"' % request.headers.get('content-type'))
+    print('content-length: %s' % request.headers.get('content-length'))
+    # print body content
+    if request.is_json:
+        json_data = request.get_json(cache=True)
+        # replace image_data with '<image base64 data>'
+        if json_data.get('image_data', None) is not None:
+            json_data['image_data'] = '<image base64 data>'
+        else: 
+            print('request image_data is None.')
+        print(json.dumps(json_data,indent=4))
+    else: # form data
+        body_data=request.get_data()
+        # replace image raw data with string '<image raw data>'
+        body_sub_image_data=re.sub(b'(\r\n\r\n)(.*?)(\r\n--)',br'\1<image raw data>\3', body_data,flags=re.DOTALL)
+        print(body_sub_image_data.decode('utf-8'))
+    # print(body_data[0:500] + b'...' + body_data[-500:]) # raw binary
+
+@app.route('/face_rec', methods=['POST', 'GET'])
+def face_recognition():
+    if request.method == 'POST':
+        # Print request url, headers and content
+        print_request(request)
+
+        # JSON data format
+        if request.is_json:
+            """ Sample data
+            {'file_format':'jpg', 'image_data': <base64 ascii string>}
+            """
+            # print('Request is a JSON format.')
+            json_data = request.get_json(cache=False)
+            file_format = json_data.get('file_format', None)
+            image_data = json_data.get('image_data', None)
+            if file_format not in ALLOWED_EXTENSIONS or image_data is None:
+                return '{"error":"Invalid JSON."}'
+
+            file = os.path.join(UPLOAD_FOLDER, 'image.' + file_format)
+            with open(file,'wb') as f:
+                # Note: Convert ascii string to binary string first, e.g. 'abc' to b'abc', before decode as base64 string.
+                f.write(base64.b64decode(image_data.encode('ascii'))) 
+        
+        # form data format
+        else: 
+            # check if the post request has the file part
+            if 'file' not in request.files:
+                print('No file part')
+                return redirect(request.url)
+            file = request.files.get('file')
+            # if user does not select file, browser also submit an empty part without filename
+            if file.filename == '':
+                print('No selected file')
+                return redirect(request.url)
+
+            if not allowed_file(file.filename):
+                return '{"error":"Invalid image file format."}'
+        
+        # Process image file
+        # Note file could be a filename or a file object.
+        name = face_rec(file)
+        resp_data = {'name': name }
+
+        # get parameters from url if any.
+        # facial_features parameter:
+        param_features = request.args.get('facial_features', '')
+        if param_features.lower() == 'true':
+            facial_features = find_facial_features(file)
+            # append facial_features to resp_data
+            resp_data.update({'facial_features': facial_features})
+
+        # face_locations parameter:
+        param_locations = request.args.get('face_locations', '')
+        if param_locations.lower() == 'true':
+            face_locations = find_face_locations(file)
+            resp_data.update({'face_locations': face_locations})
+
+        return json.dumps(resp_data)
+
+    return '''
+    <!doctype html>
+    <title>Face Recognition</title>
+    <h1>Upload an image</h1>
+    <form method=post enctype=multipart/form-data>
+      <input type=file name=file>
+      <input type=submit value=Upload>
+    </form>
+    '''
+
+@app.route('/face_match', methods=['POST', 'GET'])
+def face_match():
+    if request.method == 'POST':
+        # check if the post request has the file part
+        if ('file1' not in request.files) or ('file2' not in request.files):
+            print('No file part')
+            return redirect(request.url)
+
+        file1 = request.files.get('file1')
+        file2 = request.files.get('file2')
+        # if user does not select file, browser also submit an empty part without filename
+        if file1.filename == '' or file2.filename == '':
+            print('No selected file')
+            return redirect(request.url)
+
+        if allowed_file(file1.filename) and allowed_file(file2.filename):
+            file1.save( os.path.join(UPLOAD_FOLDER, secure_filename(file1.filename)) )
+            file2.save( os.path.join(UPLOAD_FOLDER, secure_filename(file2.filename)) )
+            ret = compare_faces(file1, file2)
+            resp_data = {
+                "success": ret[0],
+                "message": ret[1],
+                "data": {
+                    "match": bool(ret[2] < 0.5),
+                    "error_procentage": ret[2],
+                },
+            } # convert ret (numpy._bool) to bool for json.dumps
+            return jsonify(resp_data)
+
+    # Return a demo page for GET request
+    return '''
+    <!doctype html>
+    <title>Face Match</title>
+    <h1>Upload two images</h1>
+    <form method=post enctype=multipart/form-data>
+      <input type=file name=file1>
+      <input type=file name=file2>
+      <input type=submit value=Upload>
+    </form>
+    '''
+
+@app.route('/')
+def hello_world():
+    return 'Hello, World!'
+
+# Run in HTTP
+# When debug = True, code is reloaded on the fly while saved
+app.run(host='0.0.0.0', port='7860', debug=True)

demo_client.py

@@ -0,0 +1,40 @@
+import requests
+import json
+import base64
+# import ipdb
+
+def test_face_match():
+    url = 'http://127.0.0.1:5001/face_match'
+    # open file in binary mode
+    files = {'file1': open('sample_images/obama.jpg', 'rb'),
+             'file2': open('sample_images/obama2.jpg', 'rb')}     
+    resp = requests.post(url, files=files)
+    print( 'face_match response:\n', json.dumps(resp.json()) )
+    
+def test_face_rec():
+    url = 'http://127.0.0.1:5001/face_rec'
+    # open file in binary mode
+    files = {'file': open('sample_images/obama2.jpg', 'rb')} 
+    params = {'facial_features': 'true', 'face_locations':'true'}
+    resp = requests.post(url, files = files, params = params)
+    print( 'face_rec response:\n', json.dumps(resp.json()) )
+
+def test_face_rec_json():
+    url = 'http://127.0.0.1:5001/face_rec'
+    # encode image as base64 text string.
+    # Note: Must convert output bytes string from b64encode to an ascii string to form a JSON, e.g. b'abc' to 'abc'.
+    with open('sample_images/obama2.jpg', 'rb') as f:
+        image_data = base64.b64encode(f.read()).decode('ascii')
+        
+    data = {'file_format':'jpg', 'image_data': image_data}
+    params = {'facial_features': 'true', 'face_locations':'true'}
+    resp = requests.post(url, json = data, params = params)
+    print( 'face_rec response:\n', json.dumps(resp.json()) )
+
+def main():
+    test_face_match()
+    test_face_rec()
+    test_face_rec_json()
+    
+if __name__ == '__main__':
+    main()

face_util.py

@@ -0,0 +1,96 @@
+import face_recognition as fr
+import logging
+import logging.config
+
+def compare_faces(file1, file2):
+    """
+    Compare two images and return True / False for matching.
+    """
+    # Load the jpg files into numpy arrays
+    image1 = fr.load_image_file(file1)
+    image2 = fr.load_image_file(file2)
+    
+    # Get the face encodings for each face in each image file
+    # Assume there is only 1 face in each image, so get 1st face of an image.
+    encoding1 = fr.face_encodings(image1)
+    encoding2 = fr.face_encodings(image2)
+
+    # print(len(encoding1))
+    # print(len(encoding2))
+
+    # Defind response format
+    # [0] = status success or error
+    # [1] = message
+    # [2] = data error procentage
+    
+    res = [bool(1), '', 100]
+    
+    # RESPONSE
+
+    # asd
+    if len(encoding1) > 0:
+        image1_encoding = encoding1[0]
+    else:
+        res[0] = bool(0)
+        res[1] = 'Wajah tidak ditemukan. (E001)'
+        return res
+    
+    if len(encoding2) > 0:
+        image2_encoding = encoding2[0]
+    else:
+        res[0] = bool(0)
+        res[1] = 'Wajah tidak ditemukan. (E002)'
+        return res
+    
+    # results is an array of True/False telling if the unknown face matched anyone in the known_faces array
+    results = fr.face_distance([image1_encoding], image2_encoding)    
+    # print(results[0])
+    # for i, face_distance in enumerate(results):
+    #     print("The test image has a distance of {:.2} from known image #{}".format(face_distance, i))
+    #     print("- With a normal cutoff of 0.6, would the test image match the known image? {}".format(face_distance < 0.6))
+    #     print("- With a very strict cutoff of 0.5, would the test image match the known image? {}".format(face_distance < 0.5))
+    #     print()
+    res[0] = bool(1)
+    res[1] = 'Berhasil mendeteksi wajah'
+    res[2] = results[0]
+    return res
+
+# Each face is tuple of (Name,sample image)    
+known_faces = [('Obama','sample_images/obama.jpg'),
+               ('Peter','sample_images/peter.jpg'),
+              ]
+    
+def face_rec(file):
+    """
+    Return name for a known face, otherwise return 'Unknown'.
+    """
+    for name, known_file in known_faces:
+        if compare_faces(known_file,file):
+            return name
+    return 'Unknown' 
+    
+def find_facial_features(file):
+    # Load the jpg file into a numpy array
+    image = fr.load_image_file(file)
+
+    # Find all facial features in all the faces in the image
+    face_landmarks_list = fr.face_landmarks(image)
+    
+    # return facial features if there is only 1 face in the image
+    if len(face_landmarks_list) != 1:
+        return {}
+    else:
+        return face_landmarks_list[0]
+        
+def find_face_locations(file):
+    # Load the jpg file into a numpy array
+    image = fr.load_image_file(file)
+
+    # Find all face locations for the faces in the image
+    face_locations = fr.face_locations(image)
+    
+    # return facial features if there is only 1 face in the image
+    if len(face_locations) != 1:
+        return []
+    else:
+        return face_locations[0]        

find_facial_features_in_picture_w_api.py

@@ -0,0 +1,47 @@
+from PIL import Image, ImageDraw
+import requests
+import json
+
+image_file = 'sample_images/obama.jpg' 
+
+# call face recognition REST API
+url = 'http://127.0.0.1:5001/face_rec'
+files = {'file': open(image_file, 'rb')} 
+params = {'facial_features': 'true', 'face_locations':'true'}
+resp = requests.post(url, files = files, params = params)
+
+# get facial features
+resp_dict = resp.json() # convert to dict
+facial_features = resp_dict['facial_features']
+face_locations = resp_dict['face_locations']
+
+pil_image = Image.open(image_file)
+d = ImageDraw.Draw(pil_image)
+
+facial_feature_names = [
+    'chin',
+    'left_eyebrow',
+    'right_eyebrow',
+    'nose_bridge',
+    'nose_tip',
+    'left_eye',
+    'right_eye',
+    'top_lip',
+    'bottom_lip'
+]
+
+def convert_list(list_of_list):
+    list_of_tuple = [tuple(i) for i in list_of_list]
+    return list_of_tuple
+
+# Let's trace out each facial feature in the image with a line!
+for feature_name in facial_feature_names:
+    d.line( convert_list(facial_features[feature_name]), width=5)
+
+# draw rectangle for face location:
+top, right, bottom, left = face_locations
+d.rectangle([left,top,right,bottom],outline='red')
+
+# Display drawed image
+pil_image.show()
+pil_image.save('face_makeup.png')

flask_server.py

@@ -0,0 +1,156 @@
+from flask import Flask, request, redirect, jsonify
+from werkzeug.utils import secure_filename
+import os
+import json
+from face_util import compare_faces, face_rec, find_facial_features, find_face_locations
+import re
+import base64
+
+app = Flask(__name__)
+
+UPLOAD_FOLDER = 'received_files'
+ALLOWED_EXTENSIONS = ['png', 'jpg', 'jpeg']
+
+def allowed_file(filename):
+    return '.' in filename and \
+           filename.rsplit('.', 1)[1].lower() in ALLOWED_EXTENSIONS
+
+def print_request(request):
+    # Print request url
+    print(request.url)
+    # print relative headers
+    print('content-type: "%s"' % request.headers.get('content-type'))
+    print('content-length: %s' % request.headers.get('content-length'))
+    # print body content
+    if request.is_json:
+        json_data = request.get_json(cache=True)
+        # replace image_data with '<image base64 data>'
+        if json_data.get('image_data', None) is not None:
+            json_data['image_data'] = '<image base64 data>'
+        else: 
+            print('request image_data is None.')
+        print(json.dumps(json_data,indent=4))
+    else: # form data
+        body_data=request.get_data()
+        # replace image raw data with string '<image raw data>'
+        body_sub_image_data=re.sub(b'(\r\n\r\n)(.*?)(\r\n--)',br'\1<image raw data>\3', body_data,flags=re.DOTALL)
+        print(body_sub_image_data.decode('utf-8'))
+    # print(body_data[0:500] + b'...' + body_data[-500:]) # raw binary
+
+@app.route('/face_rec', methods=['POST', 'GET'])
+def face_recognition():
+    if request.method == 'POST':
+        # Print request url, headers and content
+        print_request(request)
+
+        # JSON data format
+        if request.is_json:
+            """ Sample data
+            {'file_format':'jpg', 'image_data': <base64 ascii string>}
+            """
+            # print('Request is a JSON format.')
+            json_data = request.get_json(cache=False)
+            file_format = json_data.get('file_format', None)
+            image_data = json_data.get('image_data', None)
+            if file_format not in ALLOWED_EXTENSIONS or image_data is None:
+                return '{"error":"Invalid JSON."}'
+
+            file = os.path.join(UPLOAD_FOLDER, 'image.' + file_format)
+            with open(file,'wb') as f:
+                # Note: Convert ascii string to binary string first, e.g. 'abc' to b'abc', before decode as base64 string.
+                f.write(base64.b64decode(image_data.encode('ascii'))) 
+        
+        # form data format
+        else: 
+            # check if the post request has the file part
+            if 'file' not in request.files:
+                print('No file part')
+                return redirect(request.url)
+            file = request.files.get('file')
+            # if user does not select file, browser also submit an empty part without filename
+            if file.filename == '':
+                print('No selected file')
+                return redirect(request.url)
+
+            if not allowed_file(file.filename):
+                return '{"error":"Invalid image file format."}'
+        
+        # Process image file
+        # Note file could be a filename or a file object.
+        name = face_rec(file)
+        resp_data = {'name': name }
+
+        # get parameters from url if any.
+        # facial_features parameter:
+        param_features = request.args.get('facial_features', '')
+        if param_features.lower() == 'true':
+            facial_features = find_facial_features(file)
+            # append facial_features to resp_data
+            resp_data.update({'facial_features': facial_features})
+
+        # face_locations parameter:
+        param_locations = request.args.get('face_locations', '')
+        if param_locations.lower() == 'true':
+            face_locations = find_face_locations(file)
+            resp_data.update({'face_locations': face_locations})
+
+        return json.dumps(resp_data)
+
+    return '''
+    <!doctype html>
+    <title>Face Recognition</title>
+    <h1>Upload an image</h1>
+    <form method=post enctype=multipart/form-data>
+      <input type=file name=file>
+      <input type=submit value=Upload>
+    </form>
+    '''
+
+@app.route('/face_match', methods=['POST', 'GET'])
+def face_match():
+    if request.method == 'POST':
+        # check if the post request has the file part
+        if ('file1' not in request.files) or ('file2' not in request.files):
+            print('No file part')
+            return redirect(request.url)
+
+        file1 = request.files.get('file1')
+        file2 = request.files.get('file2')
+        # if user does not select file, browser also submit an empty part without filename
+        if file1.filename == '' or file2.filename == '':
+            print('No selected file')
+            return redirect(request.url)
+
+        if allowed_file(file1.filename) and allowed_file(file2.filename):
+            file1.save( os.path.join(UPLOAD_FOLDER, secure_filename(file1.filename)) )
+            file2.save( os.path.join(UPLOAD_FOLDER, secure_filename(file2.filename)) )
+            ret = compare_faces(file1, file2)
+            resp_data = {
+                "success": ret[0],
+                "message": ret[1],
+                "data": {
+                    "match": bool(ret[2] < 0.5),
+                    "error_procentage": ret[2],
+                },
+            } # convert ret (numpy._bool) to bool for json.dumps
+            return jsonify(resp_data)
+
+    # Return a demo page for GET request
+    return '''
+    <!doctype html>
+    <title>Face Match</title>
+    <h1>Upload two images</h1>
+    <form method=post enctype=multipart/form-data>
+      <input type=file name=file1>
+      <input type=file name=file2>
+      <input type=submit value=Upload>
+    </form>
+    '''
+
+@app.route('/')
+def hello_world():
+    return 'Hello, World!'
+
+# Run in HTTP
+# When debug = True, code is reloaded on the fly while saved
+app.run(host='0.0.0.0', port='80', debug=True)

gists/demo_client_part1.py

@@ -0,0 +1,13 @@
+import requests
+import json
+
+def test_face_match():
+    url = 'http://127.0.0.1:5001/face_match'
+    # open file in binary mode
+    files = {'file1': open('sample_images/peter.jpg', 'rb'),
+             'file2': open('sample_images/peter2.jpg', 'rb')}     
+    resp = requests.post(url, files=files)
+    print( 'face_match response:\n', json.dumps(resp.json()) )
+    
+if __name__ == '__main__':
+    test_face_match()

gists/demo_client_part2.py

@@ -0,0 +1,13 @@
+import requests
+import json
+    
+def test_face_rec():
+    url = 'http://127.0.0.1:5001/face_rec'
+    # open file in binary mode
+    files = {'file': open('sample_images/peter2.jpg', 'rb')} 
+    params = {'facial_features': 'true', 'face_locations':'true'}
+    resp = requests.post(url, files = files, params = params)
+    print( 'face_rec response:\n', json.dumps(resp.json()) )
+    
+if __name__ == '__main__':
+    test_face_rec()

gists/demo_client_part2_v1.py

@@ -0,0 +1,12 @@
+import requests
+import json
+    
+def test_face_rec():
+    url = 'http://127.0.0.1:5001/face_rec'
+    # open file in binary mode
+    files = {'file': open('sample_images/peter2.jpg', 'rb')} 
+    resp = requests.post(url, files = files)
+    print( 'face_rec response:\n', json.dumps(resp.json()) )
+    
+if __name__ == '__main__':
+    test_face_rec()

gists/demo_client_v1.py

@@ -0,0 +1,22 @@
+import requests
+import json
+
+def test_face_match():
+    url = 'http://127.0.0.1:5001/face_match'
+    # open file in binary mode
+    files = {'file1': open('sample_images/peter.jpg', 'rb'),
+             'file2': open('sample_images/peter2.jpg', 'rb')}     
+    resp = requests.post(url, files=files)
+    print( 'face_match response:\n', json.dumps(resp.json()) )
+    
+def test_face_rec():
+    url = 'http://127.0.0.1:5001/face_rec'
+    # open file in binary mode
+    files = {'file': open('sample_images/peter2.jpg', 'rb')} 
+    params = {'facial_features': 'true', 'face_locations':'true'}
+    resp = requests.post(url, files = files, params = params)
+    print( 'face_rec response:\n', json.dumps(resp.json()) )
+    
+if __name__ == '__main__':
+    test_face_match()
+    # test_face_rec()

gists/demo_client_v3.py

@@ -0,0 +1,39 @@
+import requests
+import json
+import base64
+
+def test_face_match():
+    url = 'http://127.0.0.1:5001/face_match'
+    # open file in binary mode
+    files = {'file1': open('sample_images/obama.jpg', 'rb'),
+             'file2': open('sample_images/obama2.jpg', 'rb')}     
+    resp = requests.post(url, files=files)
+    print( 'face_match response:\n', json.dumps(resp.json()) )
+    
+def test_face_rec():
+    url = 'http://127.0.0.1:5001/face_rec'
+    # open file in binary mode
+    files = {'file': open('sample_images/obama2.jpg', 'rb')} 
+    params = {'facial_features': 'true', 'face_locations':'true'}
+    resp = requests.post(url, files = files, params = params)
+    print( 'face_rec response:\n', json.dumps(resp.json()) )
+
+def test_face_rec_json():
+    url = 'http://127.0.0.1:5001/face_rec'
+    # encode image as base64 text string.
+    # Note: Must convert output bytes string from b64encode to an ascii string to form a JSON, e.g. b'abc' to 'abc'.
+    with open('sample_images/obama2.jpg', 'rb') as f:
+        image_data = base64.b64encode(f.read()).decode('ascii')
+
+    data = {'file_format':'jpg', 'image_data': image_data}
+    params = {'facial_features': 'true', 'face_locations':'true'}
+    resp = requests.post(url, json = data, params = params)
+    print( 'face_rec response:\n', json.dumps(resp.json()) )
+
+def main():
+    test_face_match()
+    test_face_rec()
+    test_face_rec_json()
+    
+if __name__ == '__main__':
+    main()

gists/face_util_part1.py

@@ -0,0 +1,14 @@
+import face_recognition as fr
+
+def compare_faces(file1, file2):
+    # Load the jpg files into numpy arrays
+    image1 = fr.load_image_file(file1)
+    image2 = fr.load_image_file(file2)
+    
+    # Get the face encodings for 1st face in each image file
+    image1_encoding = fr.face_encodings(image1)[0]
+    image2_encoding = fr.face_encodings(image2)[0]
+    
+    # Compare faces and return True / False
+    results = fr.compare_faces([image1_encoding], image2_encoding)    
+    return results[0]     

gists/face_util_part2.py

@@ -0,0 +1,15 @@
+import face_recognition as fr
+
+# Each face is tuple of (Name,sample image)    
+known_faces = [('Obama','sample_images/obama.jpg'),
+               ('Peter','sample_images/peter.jpg'),
+              ]
+    
+def face_rec(file):
+    """
+    Return name for a known face, otherwise return 'Uknown'.
+    """
+    for name, known_file in known_faces:
+        if compare_faces(known_file,file):
+            return name
+    return 'Unknown' 

gists/face_util_part3.py

@@ -0,0 +1,14 @@
+import face_recognition as fr
+        
+def find_face_locations(file):
+    # Load the jpg file into a numpy array
+    image = fr.load_image_file(file)
+
+    # Find all face locations for the faces in the image
+    face_locations = fr.face_locations(image)
+    
+    # return facial features if there is only 1 face in the image
+    if len(face_locations) != 1:
+        return []
+    else:
+        return face_locations[0]        

gists/face_util_part4.py

@@ -0,0 +1,14 @@
+import face_recognition as fr
+    
+def find_facial_features(file):
+    # Load the jpg file into a numpy array
+    image = fr.load_image_file(file)
+
+    # Find all facial features in all the faces in the image
+    face_landmarks_list = fr.face_landmarks(image)
+    
+    # return facial features if there is only 1 face in the image
+    if len(face_landmarks_list) != 1:
+        return {}
+    else:
+        return face_landmarks_list[0]   

gists/flask_server_v1.py

@@ -0,0 +1,30 @@
+from flask import Flask, request
+import os
+import json
+from face_util import compare_faces, face_rec
+
+app = Flask(__name__)
+
+@app.route('/face_match', methods=['POST'])
+def face_match():
+    if request.method == 'POST':
+        # check if the post request has the file part
+        if ('file1' in request.files) and ('file2' in request.files):        
+            file1 = request.files.get('file1')
+            file2 = request.files.get('file2')                         
+            ret = compare_faces(file1, file2)     
+            resp_data = {"match": bool(ret)} # convert numpy._bool to bool for json.dumps
+            return json.dumps(resp_data)
+                                          
+@app.route('/face_rec', methods=['POST'])
+def face_recognition():
+    if request.method == 'POST':
+        # check if the post request has the file part
+        if 'file' in request.files:
+            file = request.files.get('file')                          
+            name = face_rec(file)    
+            resp_data = {'name': name }
+            return json.dumps(resp_data)           
+    
+# When debug = True, code is reloaded on the fly while saved
+app.run(host='0.0.0.0', port='5001', debug=True)

gists/flask_server_v1_part1.py

@@ -0,0 +1,19 @@
+from flask import Flask, request
+import json
+from face_util import compare_faces, face_rec
+
+app = Flask(__name__)
+
+@app.route('/face_match', methods=['POST'])
+def face_match():
+    if request.method == 'POST':
+        # check if the post request has the file part
+        if ('file1' in request.files) and ('file2' in request.files):        
+            file1 = request.files.get('file1')
+            file2 = request.files.get('file2')                         
+            ret = compare_faces(file1, file2)     
+            resp_data = {"match": bool(ret)} # convert numpy._bool to bool for json.dumps
+            return json.dumps(resp_data)         
+    
+# When debug = True, code is reloaded on the fly while saved
+app.run(host='0.0.0.0', port='5001', debug=True)

gists/flask_server_v1_part2.py

@@ -0,0 +1,9 @@
+@app.route('/face_rec', methods=['POST'])
+def face_recognition():
+    if request.method == 'POST':
+        # check if the post request has the file part
+        if 'file' in request.files:
+            file = request.files.get('file')                          
+            name = face_rec(file)    
+            resp_data = {'name': name }
+            return json.dumps(resp_data)

gists/flask_server_v2.py

@@ -0,0 +1,51 @@
+from flask import Flask, request
+import re, json
+from face_util import compare_faces, face_rec
+
+app = Flask(__name__)
+
+@app.route('/face_match', methods=['POST'])
+def face_match():
+    if request.method == 'POST':
+        # check if the post request has the file part
+        if ('file1' in request.files) and ('file2' in request.files):        
+            file1 = request.files.get('file1')
+            file2 = request.files.get('file2')                         
+            ret = compare_faces(file1, file2)     
+            resp_data = {"match": bool(ret)} # convert numpy._bool to bool for json.dumps
+            return json.dumps(resp_data)
+            
+def print_request(request):
+    # Print request url
+    print(request.url)
+    # print relative headers
+    print('content-type: "%s"' % request.headers.get('content-type'))
+    print('content-length: %s' % request.headers.get('content-length'))
+    # print body content
+    body_bytes = request.get_data()
+    # replace image raw data with string '<image raw data>'
+    body_sub = re.sub(b'(\r\n\r\n)(.*?)(\r\n--)',br'\1<image raw data>\3', body_bytes,flags=re.DOTALL)
+    print(body_sub.decode('utf-8'))
+    
+@app.route('/face_rec', methods=['POST', 'GET'])
+def face_recognition():
+    if request.method == 'POST':
+        print_request(request)        
+        # check if the post request has the file part
+        if 'file' in request.files:
+            file = request.files.get('file')                          
+            name = face_rec(file)    
+            resp_data = {'name': name }
+            return json.dumps(resp_data)      
+
+    return '''
+    <!doctype html>
+    <title>Face Recognition</title>
+    <h1>Upload an image</h1>
+    <form method=post enctype=multipart/form-data>
+      <input type=file name=file>
+      <input type=submit value=Upload>
+    </form>
+    '''            
+    
+app.run(host='0.0.0.0', port='5001', debug=True)

gists/flask_server_v2_part1.py

@@ -0,0 +1,17 @@
+from flask import Flask, request
+import re, json
+from face_util import compare_faces, face_rec
+
+app = Flask(__name__)
+                           
+def print_request(request):
+    # Print request url
+    print(request.url)
+    # print relative headers
+    print('content-type: "%s"' % request.headers.get('content-type'))
+    print('content-length: %s' % request.headers.get('content-length'))
+    # print body content
+    body_bytes = request.get_data()
+    # replace image raw data with string '<image raw data>'
+    body_sub = re.sub(b'(\r\n\r\n)(.*?)(\r\n--)',br'\1<image raw data>\3', body_bytes,flags=re.DOTALL)
+    print(body_sub.decode('utf-8'))

gists/flask_server_v2_part2.py

@@ -0,0 +1,22 @@
+@app.route('/face_rec', methods=['POST', 'GET'])
+def face_recognition():
+    if request.method == 'POST':
+        print_request(request)        
+        # check if the post request has the file part
+        if 'file' in request.files:
+            file = request.files.get('file')                          
+            name = face_rec(file)    
+            resp_data = {'name': name }
+            return json.dumps(resp_data)      
+
+    return '''
+    <!doctype html>
+    <title>Face Recognition</title>
+    <h1>Upload an image</h1>
+    <form method=post enctype=multipart/form-data>
+      <input type=file name=file>
+      <input type=submit value=Upload>
+    </form>
+    '''            
+    
+app.run(host='0.0.0.0', port='5001', debug=True)

gists/flask_server_v3.py

@@ -0,0 +1,149 @@
+from flask import Flask, request, redirect
+from werkzeug.utils import secure_filename
+import os
+import json
+from face_util import compare_faces, face_rec, find_facial_features, find_face_locations
+import re
+import base64
+
+app = Flask(__name__)
+
+UPLOAD_FOLDER = 'received_files'
+ALLOWED_EXTENSIONS = ['png', 'jpg', 'jpeg']
+
+def allowed_file(filename):
+    return '.' in filename and \
+           filename.rsplit('.', 1)[1].lower() in ALLOWED_EXTENSIONS
+
+def print_request(request):
+    # Print request url
+    print(request.url)
+    # print relative headers
+    print('content-type: "%s"' % request.headers.get('content-type'))
+    print('content-length: %s' % request.headers.get('content-length'))
+    # print body content
+    if request.is_json:
+        json_data = request.get_json(cache=True)
+        # replace image_data with '<image base64 data>'
+        if json_data.get('image_data', None) is not None:
+            json_data['image_data'] = '<image base64 data>'
+        else: 
+            print('request image_data is None.')
+        print(json.dumps(json_data,indent=4))
+    else: # form data
+        body_data=request.get_data()
+        # replace image raw data with string '<image raw data>'
+        body_sub_image_data=re.sub(b'(\r\n\r\n)(.*?)(\r\n--)',br'\1<image raw data>\3', body_data,flags=re.DOTALL)
+        print(body_sub_image_data.decode('utf-8'))
+    # print(body_data[0:500] + b'...' + body_data[-500:]) # raw binary
+
+@app.route('/face_rec', methods=['POST', 'GET'])
+def face_recognition():
+    if request.method == 'POST':
+        # Print request url, headers and content
+        print_request(request)
+
+        # JSON data format
+        if request.is_json:
+            """ Sample data
+            {'file_format':'jpg', 'image_data': <base64 ascii string>}
+            """
+            # print('Request is a JSON format.')
+            json_data = request.get_json(cache=False)
+            file_format = json_data.get('file_format', None)
+            image_data = json_data.get('image_data', None)
+            if file_format not in ALLOWED_EXTENSIONS or image_data is None:
+                return '{"error":"Invalid JSON."}'
+
+            file = os.path.join(UPLOAD_FOLDER, 'image.' + file_format)
+            with open(file,'wb') as f:
+                # Note: Convert ascii string to bytes string first, e.g. 'abc' to b'abc', before decode as base64 string.
+                f.write(base64.b64decode(image_data.encode('ascii'))) 
+        
+        # form data format
+        else: 
+            # check if the post request has the file part
+            if 'file' not in request.files:
+                print('No file part')
+                return redirect(request.url)
+            file = request.files.get('file')
+            # if user does not select file, browser also submit an empty part without filename
+            if file.filename == '':
+                print('No selected file')
+                return redirect(request.url)
+
+            if not allowed_file(file.filename):
+                return '{"error":"Invalid image file format."}'
+        
+        # Process image file
+        # Note file could be a filename or a file object.
+        name = face_rec(file)
+        resp_data = {'name': name }
+
+        # get parameters from url if any.
+        # facial_features parameter:
+        param_features = request.args.get('facial_features', '')
+        if param_features.lower() == 'true':
+            facial_features = find_facial_features(file)
+            # append facial_features to resp_data
+            resp_data.update({'facial_features': facial_features})
+
+        # face_locations parameter:
+        param_locations = request.args.get('face_locations', '')
+        if param_locations.lower() == 'true':
+            face_locations = find_face_locations(file)
+            resp_data.update({'face_locations': face_locations})
+
+        return json.dumps(resp_data)
+
+    return '''
+    <!doctype html>
+    <title>Face Recognition</title>
+    <h1>Upload an image</h1>
+    <form method=post enctype=multipart/form-data>
+      <input type=file name=file>
+      <input type=submit value=Upload>
+    </form>
+    '''
+
+@app.route('/face_match', methods=['POST', 'GET'])
+def face_match():
+    if request.method == 'POST':
+        # check if the post request has the file part
+        if ('file1' not in request.files) or ('file2' not in request.files):
+            print('No file part')
+            return redirect(request.url)
+
+        file1 = request.files.get('file1')
+        file2 = request.files.get('file2')
+        # if user does not select file, browser also submit an empty part without filename
+        if file1.filename == '' or file2.filename == '':
+            print('No selected file')
+            return redirect(request.url)
+
+        if allowed_file(file1.filename) and allowed_file(file2.filename):
+            #file1.save( os.path.join(UPLOAD_FOLDER, secure_filename(file1.filename)) )
+            #file2.save( os.path.join(UPLOAD_FOLDER, secure_filename(file2.filename)) )
+            ret = compare_faces(file1, file2)
+            resp_data = {"match": bool(ret)} # convert ret (numpy._bool) to bool for json.dumps
+            return json.dumps(resp_data)
+
+    # Return a demo page for GET request
+    return '''
+    <!doctype html>
+    <title>Face Match</title>
+    <h1>Upload two images</h1>
+    <form method=post enctype=multipart/form-data>
+      <input type=file name=file1>
+      <input type=file name=file2>
+      <input type=submit value=Upload>
+    </form>
+    '''
+
+@app.route('/')
+def hello_world():
+    return 'Hello, World!'
+
+# Run in HTTP
+# When debug = True, code is reloaded on the fly while saved
+app.run(host='0.0.0.0', port='5001', debug=True)

gists/form-data_example.txt

@@ -0,0 +1,12 @@
+content-type:"multipart/form-data; boundary=--------------------------706175916610648661144841"
+content-length:278
+
+----------------------------706175916610648661144841
+Content-Disposition: form-data; name="firstname"
+
+Mickey
+----------------------------706175916610648661144841
+Content-Disposition: form-data; name="lastname"
+
+Mouse
+----------------------------706175916610648661144841--

gists/form-data_file.txt

@@ -0,0 +1,9 @@
+http://127.0.0.1:5001/face_rec
+content-type: "multipart/form-data; boundary=---------------------------151482349718403643091396029930"
+content-length: 91238
+-----------------------------151482349718403643091396029930
+Content-Disposition: form-data; name="file"; filename="peter2.jpg"
+Content-Type: image/jpeg
+
+<image raw data>
+-----------------------------151482349718403643091396029930--

requirements.txt

@@ -0,0 +1,7 @@
+cmake
+Werkzeug
+requests
+Flask
+gunicorn
+face_recognition
+Pillow

sample_outputs.txt

@@ -0,0 +1,13 @@
+face_rec response:
+ {"name": "Peter", "face_locations": [206, 526, 527, 205], "facial_features": {"left_eye": [[285, 285], [301, 278], [320, 279], [335, 289], [318, 292], [300, 292]], "nose_bridge": [[376, 277], [377, 304], [377, 328], [378, 354]], "top_lip": [[329, 433], [348, 420], [366, 411], [379, 416], [393, 412], [410, 420], [425, 432], [417, 432], [393, 429], [379, 430], [366, 429], [337, 434]], "left_eyebrow": [[255, 259], [275, 243], [301, 236], [328, 241], [350, 249]], "bottom_lip": [[425, 432], [410, 442], [395, 449], [380, 452], [366, 451], [349, 447], [329, 433], [337, 434], [366, 430], [379, 432], [393, 429], [417, 432]], "nose_tip": [[349, 378], [363, 381], [378, 384], [392, 381], [405, 378]], "right_eyebrow": [[399, 246], [421, 238], [444, 237], [466, 244], [482, 259]], "right_eye": [[411, 290], [428, 280], [446, 281], [458, 289], [446, 295], [429, 294]], "chin": [[228, 301], [229, 338], [237, 377], [246, 414], [261, 445], [282, 475], [311, 498], [344, 515], [381, 518], [415, 512], [441, 493], [462, 468], [477, 440], [488, 408]]}}
+
+
+http://127.0.0.1:5001/face_rec
+content-type: "multipart/form-data; boundary=---------------------------151482349718403643091396029930"
+content-length: 91238
+-----------------------------151482349718403643091396029930
+Content-Disposition: form-data; name="file"; filename="peter2.jpg"
+Content-Type: image/jpeg
+
+<image raw data>
+-----------------------------151482349718403643091396029930--

ssl_keys/gen_ssl_keys.py

@@ -0,0 +1,2 @@
+from werkzeug.serving import make_ssl_devcert
+make_ssl_devcert('key', host='localhost')

ssl_keys/key.crt

@@ -0,0 +1,18 @@
+-----BEGIN CERTIFICATE-----
+MIIC+TCCAeECCBojnT0ZPNwAMA0GCSqGSIb3DQEBCwUAMD8xITAfBgNVBAMMGCou
+bG9jYWxob3N0L0NOPWxvY2FsaG9zdDEaMBgGA1UECgwRRHVtbXkgQ2VydGlmaWNh
+dGUwHhcNMTkwMzIyMDY1MjEyWhcNMjAwMzIxMDY1MjEyWjA/MSEwHwYDVQQDDBgq
+LmxvY2FsaG9zdC9DTj1sb2NhbGhvc3QxGjAYBgNVBAoMEUR1bW15IENlcnRpZmlj
+YXRlMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA5JD+A+MK51iKFKG8
+T+5rWOYWs3i8Z3L/YqjAe4yxS7vWPRmTKgf5B1YIKM8+wSsyX+2sH6iQQtOR8qmr
+4FjY94mGH365GPBVLgvExoGJyoVtdha3c5mkiRufhVxIou8Pss3kaKkRBrlevOaE
+b9f65abeZmazxYTYP/mX201/Z/cLNRP5EaIBL+Ixpxsu19uP1Xhua/p6LF86W6AS
+FhThTKR5/XtCKWxB7RIn2pPsipP51iragAsP1GQ3kX96dZZ9ovkc/Vf4hZdFucgS
+2OucuOJMHG5F80UuNnXlUjVvUTvbcX/0/vCEG2zYvr/qI2km56Qmgei89r7UNc9m
+TD5sgQIDAQABMA0GCSqGSIb3DQEBCwUAA4IBAQDJFD8LplIAdUAbTAoCuuUt+oyl
+zBExrEotUO7xTUqLYCP73dEVb/63Rzoc7CsfZU+Wk3G5d0gTGstr4FThke4tDpE+
+ODyiYNubYb/R55Q25JzeShKptvMcNQyh9G2MCGnCMO3Y//yO37YrUjttv39L4LCO
+tU8EgOr1DsMnKSNUIS0+HEXaRry7QJv2J4jpXufx+UsScAq9yxniPox6SeeyzEqX
+wJwi/uSUi8dxt++JZQOoQ08VVUQzy2cbZO5zDv5KmmQ2EgdQGdfFYly7wT9UIku6
+QocprekLImbV88dOqTf+76V7n7zx02nw+GiP/F8XcW7McZU3NUmx6/kupyjc
+-----END CERTIFICATE-----

ssl_keys/key.key

@@ -0,0 +1,28 @@
+-----BEGIN PRIVATE KEY-----
+MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDkkP4D4wrnWIoU
+obxP7mtY5hazeLxncv9iqMB7jLFLu9Y9GZMqB/kHVggozz7BKzJf7awfqJBC05Hy
+qavgWNj3iYYffrkY8FUuC8TGgYnKhW12FrdzmaSJG5+FXEii7w+yzeRoqREGuV68
+5oRv1/rlpt5mZrPFhNg/+ZfbTX9n9ws1E/kRogEv4jGnGy7X24/VeG5r+nosXzpb
+oBIWFOFMpHn9e0IpbEHtEifak+yKk/nWKtqACw/UZDeRf3p1ln2i+Rz9V/iFl0W5
+yBLY65y44kwcbkXzRS42deVSNW9RO9txf/T+8IQbbNi+v+ojaSbnpCaB6Lz2vtQ1
+z2ZMPmyBAgMBAAECggEBAM9A8jRQEbkJPdvLdFf+VvR7XqZKmnwreIvbfP4K61FC
+99bbc+gu5o7SYf+vPLYoFzuI5gSm8njGI5coZyO9LK/40deJLwoAExz3quxc1bcA
+Get0WdDGxr1UgOeKcIrdvxxhOfX1J+0y9UbQt9I6w9St5QhxpB08gmIwTpSaxyZa
+03d/a/Y/7rzaSFpTbIw+ydc+oyczQ9q9yTFa0WTvQAbsrnLvq4YIjQID9bhzhO7z
+6yLjXZXJrjoXxmlgSMrTyr9m21df564jnEfqRSL2dMRawScM3iaGPsFpMQGEd6HT
+ihKBKciHsHhnnozdXmPaV7VUZ1GGvjmruCz2EiZAGokCgYEA/Tycey0zWX/GosTu
+lZ1muZrNxuBJHc0/IRDIZd2t8k7UGv09Yc6sICQ/GHgv495u7bOuw9MOnZQaPPB3
+1fj0vGJJcQIbZwAMcneuYIDimGh9jYP445J4EMXv+kOLkCCy91L7xxgjp2twoJ+l
+PonKFAsDf63Hr0jtqknGr7Dbe18CgYEA5w93je16r96YCI13DVpa01NU22eVFoYL
+V/4wItfXrw/RXVb53JLN53HaUwZefyDicnyGnXA9VN0fIXSNZI/O2gJcjWlkbdON
+arDYTqDf5R8a1zYrfYmhLYA0OvuMJrDEQQxvZZhbJaDHLS+e9bmMWEwxSBcOWYWO
+TCqtmwJjBB8CgYBKIaEpSd0bWRVb9sxlDfPRZ6jPjD67M6dEVbZkY5WVNlBPKkz6
+wdaPfizeS+ixCx9sBEqn1rQTmxRnPHnIMJ3sO9WF+HjvGQuLws9QPsqWlRgUAkss
+y2bMejU7DOThJ0Fct3UvHjjpvMD2tGVaPlniriqzCLtI689vJzO7oMlPfwKBgDdt
+PWedZQXVJrE+hiV83Da/UabEBT5+7y+veQqSrll/OODkIVHpIV14sT+jUn26fLer
+6XrQ1tWJqZMT62sJGDyxvlPpyT6TNeQ3AdxyuOK0gHLJussFfdV1YJIZj3gkhR95
+hStgzdSL6duMBdy6ItF3jYbWiQmugQECZ9y8SNZPAoGBAMIG5YmMcnRmJLoW1y9h
+RWtJ0HP1hKZpLeWzkjEoRJe6PmVj+W/zmXWynjyLE47QiFsgm0EGCkGMvbBtWgbY
+yM+fjKIPeYGS/zHgK+4TgN6HHM9HxGL76NSH5yzBP0lpxDpiWdEOmYt7ahwiF1ga
+KUZzUGXJ6p9vr4nIIwz3Bd96
+-----END PRIVATE KEY-----

wsgi.py

@@ -0,0 +1,4 @@
+from app import app
+ 
+if __name__ == "__main__":
+        app.run()