Face Detect
A Ruby gem for face detection in images. Also includes detection of facial features/landmarks. The backends are swappable.
While the intention is to support multiple adapters, the only one available for now is the Google Cloud Vision API.
Installation
Requires Ruby 2.x.
Add this line to your application's Gemfile:
gem 'face_detect' gem 'googleauth' gem 'google-api-client'
Execute:
bundle
Usage
The JSON file that you downloaded contains your credentials. Set the full contents as an environment variable.
export GOOGLE_CREDENTIALS_JSON=$(cat <credentials>.json)
Add the following to your code:
require 'face_detect' require 'face_detect/adapter/google' input = File.new('image.png') detector = FaceDetect.new( file: input, adapter: FaceDetect::Adapter::Google ) results = detector.run results #=> [<FaceDetect::Face>, ...] face = results.first face.mouth_left.x #=> 225.06