getsimilar 0.0.4

Image search: image/text => images.

Get similar images

This tool is a wrapper over an API that returns URLs and similarity scores for similar images for a given image.

You can find a demo of the tool here.

The description of the API can be found here.

Installation

pip install -U getsimilar

Get an API token

• Log in at: https://ternaus.com/login
• Go to the account page: https://ternaus.com/account
• Generate new token and save json file with it to ~/.ternaus/ternaus.json

Usage

You pass:

• Image in the form of the numpy array or PIL image.
• URL to the image:
• Text query, for example: "Girls in weird hats"

All requests have a parameter num_similar that specifies the number of similar images to return. This number is capped at 20. If you would like to get more similar images per request, please contact us at https://www.ternaus.com/#contact.

From image

from getsimilar.get import from_image

urls = from_image(<numpy or PIL image>, num_similar=<the number of similar images>)

From URL

from getsimilar.get import from_url

urls = from_url(url, num_similar=<the number of similar images>)

From text

from getsimilar.get import from_text

urls = from_text(text, num_similar=<the number of similar images>)