Skip to main content

The librec-auto project aims to automate recommender system experimens using LibRec.

Project description

============ Librec-auto


librec-auto is a Python tool for running recommender systems experiments. It is built on top of the open-source LibRec_ package, and can take advantage of the many algorithm and metric implementations there.

.. _LibRec:

The basic element of librec-auto execution is the "study", which is a series of experiments carried with a single algorithm, a single data set, and a set of evaluation metrics. The experiments differ from each other by the hyperparameters given to the algorithm. librec-auto allows such studies to be conducted with minimal experimenter intervention, and supports such capabilities as:

  • recommendation result re-ranking
  • re-running evaluations without re-computing results
  • summarizing results in output graphs
  • integration with Slack and Dropbox


The workflow of an study involves identifying appropriate data, creating training / test splits, implementing or choosing algorithms, running experiments (possibly with a range of different parameters), and reporting on the results.


Librec-auto uses an XML-based configuration system similar to Maven or Ant.

Project structure

This directory contains the Python libraries for the librec_auto module. There are two other affiliated respositories:

  • librec-auto-java_: Contains the java source for the wrapper between LibRec and librec-auto, which is implemented in the auto.jar file.
  • librec-auto-sample_: Contains sample data and configuration files that can be used to explore the functionality of librec-auto

.. _librec-auto-java: .. _librec-auto-sample:

Repo structure

  • /jar: Contains the jar files for LibRec and the wrapper.
  • /rules: Contains the rules for translating configuration data to LibRec properties format.
  • /librec_auto: Contains the Python code for the project.
  • /doc: Contains documentation for the project
  • /test: Contains the unit tests (not many right now)

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for librec-auto, version 0.1.54
Filename, size File type Python version Upload date Hashes
Filename, size librec_auto-0.1.54-py3-none-any.whl (42.1 MB) File type Wheel Python version py3 Upload date Hashes View
Filename, size librec-auto-0.1.54.tar.gz (42.1 MB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page