Metarank Docs
  • Introduction
    • What is Metarank?
    • Quickstart
    • Performance
  • Guides
    • Search
      • Reranking with cross-encoders
  • Reference
    • Installation
    • Event Format
      • Timestamp formats
    • API
    • Command-line options
    • Configuration
      • Feature extractors
        • Counters
        • Date and Time
        • Generic
        • Relevancy
        • Scalars
        • Text
        • User Profile
        • Diversification
      • Recommendations
        • Trending items
        • Similar items
        • Semantic similarity
      • Models
      • Data Sources
      • Persistence
    • Deployment
      • Standalone
      • Docker
      • Kubernetes
      • Prometheus metrics export
      • Custom logging
      • Warmup
    • Integrations
      • Snowplow
  • How-to
    • Automated ML model retraining
    • Automatic feature engineering
    • Running in production
  • Development
    • Changelog
    • Building from source
  • Doc versions
    • 0.7.9 (stable)
    • master (unstable)
Powered by GitBook
On this page
  • Docker image
  • JAR File
  • Java
  • Installing on MacOS

Was this helpful?

Edit on GitHub
  1. Reference

Installation

PreviousReranking with cross-encodersNextEvent Format

Last updated 1 year ago

Was this helpful?

Metarank is available as a Docker and JAR packages for MacOS, Windows and Linux.

Docker image

Metarank docker images are published on DockerHub as :

  • official Metarank images are multi-arch and support both amd64 and arm64/v8 (so will natively work on Mac M1/M2 without emulation).

  • latest tag may point to pre-release versions, use an exact pinned version for stability.

  • on Mac M1 you can use x86_64 docker images, or try running the JAR file directly.

To start using metarank with docker, just run:

docker run metarank/metarank:0.7.9 --help

JAR File

Metarank is a JVM application and also available as a JAR application on page. As it bundles a couple of native libraries (interfaces to and ), it supports the following platforms and operating systems:

  • Linux: x86_64/AArch64, JVM 11+

  • Windows: x86_64, Windows 10+, JVM 11+

  • MacOS: x86_64/AArch64, MacOS 11+, JVM 11+

To start metarank JAR file, just run:

java -jar metarank.jar --help

Java

Metarank is tested on JDK 11 and 17, but will probably work on 18+. JDK 8, 9, 10 are not supported.

Installing on MacOS

brew install libomp

Without libomp you may encounter a strange UnsatisfiedLinkError while training the model:

15:32:03.936 INFO  ai.metarank.main.command.Train$ - training model for train=7067 test=1706
Loading native lib osx/x86_64/lib_lightgbm.dylib
Extracting native lib /var/folders/nl/2p5w70jj5_50ztn25q2xll380000gn/T/lib_lightgbm.dylib
Copied 3775632 bytes
Extracted file: exists=true path=/var/folders/nl/2p5w70jj5_50ztn25q2xll380000gn/T/lib_lightgbm.dylib
Cannot load library: java.lang.UnsatisfiedLinkError: Can't load library: /var/folders/nl/2p5w70jj5_50ztn25q2xll380000gn/T/lib_lightgbm.dylib cause: Can't load library: /var/folders/nl/2p5w70jj5_50ztn25q2xll380000gn/T/lib_lightgbm.dylib
Loading native lib osx/x86_64/lib_lightgbm_swig.dylib
Extracting native lib /var/folders/nl/2p5w70jj5_50ztn25q2xll380000gn/T/lib_lightgbm_swig.dylib
Copied 89308 bytes
Extracted file: exists=true path=/var/folders/nl/2p5w70jj5_50ztn25q2xll380000gn/T/lib_lightgbm_swig.dylib
Cannot load library: java.lang.UnsatisfiedLinkError: Can't load library: /var/folders/nl/2p5w70jj5_50ztn25q2xll380000gn/T/lib_lightgbm_swig.dylib cause: Can't load library: /var/folders/nl/2p5w70jj5_50ztn25q2xll380000gn/T/lib_lightgbm_swig.dylib
Exception in thread "io-compute-1" java.lang.UnsatisfiedLinkError: 'long com.microsoft.ml.lightgbm.lightgbmlibJNI.new_voidpp()'

To run JVM applications, you need the JVM itself. If you have no JRE/JDK installed, check out the tutorials for different operating systems.

Metarank JAR app requires a to be installed:

metarank/metarank
Releases
LightGBM
XGBoost
Eclipse Temurin JDK
libomp