Faceapp is neural-network face manipulation application for smartphones.
This gem provides command-line utility and Ruby library to utilize Faceapp API without using smartphone application.
Faceapp Application is available on Google Play and Apple App Store:
- https://play.google.com/store/apps/details?id=io.faceapp
- https://itunes.apple.com/us/app/faceapp-free-neural-face-transformations/id1180884341
faceapp [options] <filter> <input> [ouput]
<filter> - Faceapp filter name
Possible values: smile, smile_2, hot, old, young, female, male
<input> - Input file name
Use '-' for STDIN
[output] - Optinal, output file name
Do not specify or use '-' for STDOUT
Options:
--help - Display this message
--cropped[=true|false] - Crop output image to face region. Enabled by default.
--api_host=<api_host> - Faceapp API host
--device_id=<device_id> - DeviceId for Faceapp
--user_agent=<user_agent> - User-Agent header for Faceapp API requests
--silent - Keep quiet, it will override `debug`
--debug - Print HTTP requests/responses to STDERR.Example:
$ faceapp female hitler.jpg adolfina.jpg
$ faceapp female - < hitler.jpg > adolfina.jpgrequire 'faceapp'
client = Faceapp::Client.new
file = File.open('hitler.jpg', 'rb')
filter = 'female' # smile, smile_2, hot, old, young, male
# File could be String or IO
code = client.upload_photo(file)
# => "2017blablabla"
# By default it will return StringIO
result = client.apply_filter(code, filter)
# => StringIO
output = File.open('output.jpg', 'wb')
# Third argument might be an IO object
result = client.apply_filter(code, filter, output)
# => File
# Or you may specify block, it will receive response chunks
client.apply_filter(code, filter) do |chunk, cursor, total|
# chunk is String
puts chunk.bytesize
# render fancy progress bar
end
# => 100500 # Returns total bytes countAdd this line to your application's Gemfile:
gem 'faceapp'And then execute:
$ bundle
Or install it yourself as:
$ gem install faceapp
The gem is available as open source under the terms of the MIT License.