davidssmith / finch

A proof-of-concept for enhancing and organising an image collection using Google's Vision API

Finch

What is it?

Are you an image hoarder? Couldn't resist saving that Zuckerberg meme, or cat chasing a laser beam? It's unlikely those images were in their original, high resolution glory.

Finch uses Google's Vision API to automatically reverse image search images in your collection. If it finds a higher resolution version, it will automatically download and replace the saved version!

How can I use it?

To use Finch, you'll need a Vision API key, which you can get by registering for Google Cloud Platform. They offer 1,000 free Vision API calls per month.

• Clone this repository
• Run cargo install
• Run finch -h for a list of parameters

Notes.

• Finch still has a fairly primitive user interface. It may not exit immediately if it encounters a problem, making unnecessary calls to the Vision API.
• Finch makes calls in parallel rather than asynchronously. This can cause performance issues.
• It may work intermittently on slow connections.
• Issues with the Vision API reduce quality of results.