HumanDetect Example (Flask server)

A. Run locally

Prerequisites

• Python >= 3.7.0
• pip >= 20.0.0

Setup

• Clone the repository to your system

• Run the following command to install the required libraries:

  pip install -r requirements.txt
  

Add HumanDetect API Key

• Follow the Getting Started Guide to create an account on the Developer Portal.

• Generate an API key using the developer portal.

• Set the API key as an environmental variable.

  UnifyIDAPIKey=[Your API Key]
  export UnifyIDAPIKey
  

Run Flask app

• python wsgi.py will run the Flask app locally.
• You can check that it's up and running by going to http://localhost:5000/ in your browser.

B. Deploy to Heroku

While running the Flask app locally might be great for trying things out, you'll have to deploy it via Heroku if you want to access it outside of your local environment.

Use button below to set up your project in Heroku. Set the "UnifyIDAPIKey" config var as the API key that you previously generated from the developer portal.

C. Run test

• Set the URL of your Heroku project as an environmental variable.

  UnifyIDHerokuURL=[Your Heroku project URL]
  export UnifyIDHerokuURL
  

• Run python test.py

• If everything goes according to plan, the following should be printed: cab: 87.69%, police_van: 5.23%, racer: 1.45%, sports_car: 1.33%, car_wheel: 1.23%

D. Next Steps

Check out the HumanDetect Example iOS App if you want to see how HumanDetect can be implemented end-to-end, and to test the capabilities of HumanDetect in a real-world scenario.