/libris

Java library for reverse image search

Primary LanguageJavaGNU Lesser General Public License v3.0LGPL-3.0

libris - Reverse Image Search Library

Java library for reverse image search. This library gives the possibility to use Google, Azure, Watson and Imagga image recognition services to perform reverse image search and optical character recognition (OCR).

Continuous Integration

Travis-CI is used to perform builds on every commit. The library is tested against:

  • openjdk7
  • oraclejdk8
  • oraclejdk7
Branch Build Status
Master Build Status
Dev Build Status

Compilation

This project uses Maven as dependency manager. On the project root in order to compile you need to type:

mvn compile

N.B.: libris needs at least Java v7! Previous versions won't work.

Testing

To run the unit tests:

mvn test

Please note that you need valid keys to perform some of the unit-tests (currently for Azure, Watson, Imagga).

Install the .jar

To install the jar you need to give this command:

mvn install

Setup

It's very easy to import libris in your project! Just follow these instruction..

Manven

Maven configuration:

<repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
</repository>

<dependency>
    <groupId>com.github.Polpetta</groupId>
    <artifactId>libris</artifactId>
    <version>v1.0.0</version>
</dependency>

Grandle

Gradle configuration:

repositories {
    maven {
        url "https://jitpack.io"
    }
}

dependencies {
    compile 'com.github.Augugrumi:libris:v1.0.0'
}

License

This library is licensed under GNU LGPLv3. Credit goes to Davide Polonio, Marco Zanella and Federico Tavella.