Cineast is a multi-feature content-based multimedia retrieval engine. It is capable of retrieving images, audio- and video sequences as well as 3d models based on edge or color sketches, sketch-based motion queries and example objects. Cineast is written in Java and uses CottontailDB as a storage backend.
Cineast can be built using Gradle. It needs Java 17+. Building and running it is as easy as
$> git clone https://github.com/vitrivr/cineast.git $> cd cineast $> ./gradlew cineast-runtime:shadowJar $> java -jar cineast-runtime/build/libs/cineast-runtime-x.x-full.jar cineast.json
For more setup information, consult our Wiki
There is a Docker image available on Docker Hub.
You can run the CLI with:
$> docker run vitrivr/cineast cli cineast.json help
To change the configuration you can use a bind mount, e.g. to run the API server with custom configuration file cineast.json in the current directory:
$> docker run \ --mount type=bind,source="$(pwd)"/cineast.json,target=/opt/cineast/cineast.json \ cineast.json vitrivr/cineast api cineast.json
Generate OpenApi Specification
If you need to rebuild the OpenApi Specification (OAS), there is a gradle task for this purpose:
$> ./gradlew -PcineastConfig=<path/to/your/config> generateOpenApiSpecs
You can omit
-PcineastConfig, then the default config (
cineast.json) is used.
As a result, the OAS is stored at
- JDK 17 or higher
For 3D rendering (required in order to support 3D models) you either need a video card or Mesa 3D. The JOGL library supports both. Rendering on Headless devices has been successfully tested with Xvfb. The following steps are required to enable 3D rendering support on a headless device without video card (Ubuntu 16.04.1 LTS)
- Install Mesa 3D (should come pre-installed on Ubuntu). Check with
dpkg -l | grep mesa
- Install Xvfb:
$> sudo apt-get install xvfb
- Start a new screen:
$> sudo Xvfb :1 -ac -screen 0 1024x768x24 &
- Using the new screen, start Cineast:
$> DISPLAY=:1 java -jar cineast.jar -3d
The -3d option will perform a 3D test. If it succeeds, cineast should generate a PNG image depicting two coloured triangles on a black background.
Contributions are always welcome.
Cineast primarily uses the Google Java Styleguide.
Please use the file supplied in the
To automatically apply the styleguide in IntelliJ IDEA go to_File_ -> Settings -> Editor -> Code Style -> Java and import the supplied file via the gear icon.