Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/guoguibing/librec

LibRec: A Leading Java Library for Recommender Systems, see
https://github.com/guoguibing/librec

collaborative collaborative-filtering factorization filtering java matrix matrix-factorization probabilistic-graphical-models recommendation-algorithms recommender recommender-systems sparse systems tensor tensor-factorization

Last synced: about 15 hours ago
JSON representation

LibRec: A Leading Java Library for Recommender Systems, see

Host: GitHub
URL: https://github.com/guoguibing/librec
Owner: guoguibing
License: other
Created: 2014-01-09T16:06:11.000Z (almost 11 years ago)
Default Branch: 3.0.0
Last Pushed: 2023-07-13T17:03:11.000Z (over 1 year ago)
Last Synced: 2024-12-05T17:06:00.358Z (8 days ago)
Topics: collaborative, collaborative-filtering, factorization, filtering, java, matrix, matrix-factorization, probabilistic-graphical-models, recommendation-algorithms, recommender, recommender-systems, sparse, systems, tensor, tensor-factorization
Language: Java
Homepage: https://www.librec.net/
Size: 83.6 MB
Stars: 3,240
Watchers: 234
Forks: 1,030
Open Issues: 82
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome - librec - LibRec: A Leading Java Library for Recommender Systems, see (Java)
StarryDivineSky - guoguibing/librec

README

        

**LibRec** (https://guoguibing.github.io/librec/index.html) is a Java library for recommender systems (Java version 1.7 or higher required). It implements a suit of state-of-the-art recommendation algorithms, aiming to resolve two classic recommendation tasks: **rating prediction** and **item ranking**. 

[![Join the chat at https://gitter.im/librec/Lobby](https://badges.gitter.im/librec/Lobby.svg)](https://gitter.im/librec/Lobby?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)[![Build Status](https://travis-ci.org/guoguibing/librec.svg?branch=2.0.0)](https://travis-ci.org/guoguibing/librec)

### LibRec Demo

A movie recommender system is designed and [available here](http://demo.librec.net).

### Documentation

Please refer to [LibRec Documentation](http://wiki.librec.net) and [API Documentation](http://librec.net/doc/librec-v2.0/)

### Authors Words about the NEW Version

It has been a year since the last version was released. In this year, lots of changes have been taken to the LibRec project, and the most significant one is the formulation of the LibRec team. The team pushes forward the development of LibRec with the wisdom of many experts, and the collaboration of experienced and enthusiastic contributors. Without their great efforts and hardworking, it is impossible to reach the state that a single developer may dream of. 

LibRec 2.0 is not the end of our teamwork, but just the begining of greater objectives. We aim to continously provide NEXT versions for better experience and performance. There are many directions and goals in plan, and we will do our best to make them happen. It is always exciting to receive any code contributions, suggestions, comments from all our LibRec users. 

We hope you enjoy the new version!

PS: Follow us on WeChat to have first-hand and up-to-date information about LibRec. 



### Features

* **Rich Algorithms:** More than 70 recommendation algorithms have been implemented, and more will be done.

* **High Modularity:** Six main components including data split, data conversion, similarity, algorithms, evaluators and filters.

* **Great Performance:** More efficient implementations than other counterparts while producing comparable accuracy.

* **Flexible Configuration:** Low coupling, flexible and either external textual or internal API configuration.

* **Simple Usage:** Can get executed in a few lines of codes, and a number of demos are provided for easy start.

* **Easy Expansion:** A set of recommendation interfaces for easy expansion to implement new recommenders.



 


The procedure of LibRec is illustrated as follows. 



 


### Download

by maven

```

    net.librec

    librec-core

    2.0.0

```

by packages

* **[librec-v2.0](https://github.com/guoguibing/librec/archive/librec-src-v2.0.zip)**

* **[librec-v1.3](http://www.librec.net/release/librec-v1.3.zip)**

* **[librec-v1.2](http://www.librec.net/release/librec-v1.2.zip)**

* **[librec-v1.1](http://www.librec.net/release/librec-v1.1.zip)**

* **[librec-v1.0](http://www.librec.net/release/librec-v1.0.zip)**

### Execution 

You can run LibRec with configurations from command arguments:


librec rec -exec -D rec.recommender.class=itemcluster -D rec.pgm.number=10 -D rec.iterator.maximum=20



or from a configuration file:


librec rec -exec -conf itemcluster-test.properties



### Code Snippet

You can use **LibRec** as a part of your projects, and use the following codes to run a recommender. 


public void main(String[] args) throws Exception {

	

	// recommender configuration

	Configuration conf = new Configuration();

	Resource resource = new Resource("rec/cf/userknn-test.properties");

	conf.addResource(resource);

	// build data model

	DataModel dataModel = new TextDataModel(conf);

	dataModel.buildDataModel();

	

	// set recommendation context

	RecommenderContext context = new RecommenderContext(conf, dataModel);

	RecommenderSimilarity similarity = new PCCSimilarity();

	similarity.buildSimilarityMatrix(dataModel, true);

	context.setSimilarity(similarity);

	// training

	Recommender recommender = new UserKNNRecommender();

	recommender.recommend(context);

	// evaluation

	RecommenderEvaluator evaluator = new MAEEvaluator();

	recommender.evaluate(evaluator);

	// recommendation results

	List recommendedItemList = recommender.getRecommendedList();

	RecommendedFilter filter = new GenericRecommendedFilter();

	recommendedItemList = filter.filter(recommendedItemList);

}



### News Report 

* [An Introduction to Open-source Recommendaion Toolkit: LibRec](http://chuansong.me/n/1701947351918) [by ResysChina in Chinese]

* [LibRec: an Open-source and Cross-platform Software for Recommender Systems](http://chuansong.me/n/1751521251128) [by InfoQ in Chinese]

### Acknowledgement

We would like to express our appreciation to the following people for contributing source codes to LibRec, including [Prof. Robin Burke](http://josquin.cti.depaul.edu/~rburke/), [Bin Wu](https://github.com/wubin7019088), [Diego Monti](https://github.com/dmm42), [Ge Zhou](https://github.com/466152112), Li Wenxi, [Marco Mera](https://github.com/mmera), [Ran Locar](https://github.com/ranlocar), [Shawn Rutledge](https://github.com/shawndr), [ShuLong Chen](https://github.com/ChenSuL), [Tao Lian](https://github.com/taolian), [Takuya Kitazawa](https://github.com/takuti), [Zhaohua Hong](mailto:[email protected]), Tan Jiale, [Daniel Velten](https://github.com/dvelten), [Qian Shaofeng](https://github.com/shitou112), etc.  We gratefully thank Mr. Lijun Dai for designing and contributing the logo of LibRec, and also many thanks to [Mr. Jianbin Zhang](http://www.liaotian2020.com/) for implementing and sharing a [LibRec demo](http://demo.librec.net/). 

We also appreciate many others for reporting bugs and issues, and for providing valuable suggestions and support. 

### Publications

Please cite the following papers if LibRec is helpful to your research. 

1. G. Guo, J. Zhang, Z. Sun and N. Yorke-Smith, [LibRec: A Java Library for Recommender Systems](http://ceur-ws.org/Vol-1388/demo_paper1.pdf), in Posters, Demos, Late-breaking Results and Workshop Proceedings of the 23rd Conference on User Modelling, Adaptation and Personalization (UMAP), 2015.

2. G. Guo, J. Zhang and N. Yorke-Smith, TrustSVD: Collaborative Filtering with Both the Explicit and Implicit Influence of User Trust and of Item Ratings, in Proceedings of the 29th AAAI Conference on Artificial Intelligence (AAAI), 2015, 123-129.

3. Z. Sun, G. Guo and J. Zhang, Exploiting Implicit Item Relationships for Recommender Systems, in Proceedings of the 23rd International Conference on User Modeling, Adaptation and Personalization (UMAP), 2015.

### GPL License

LibRec is [free software](http://www.gnu.org/philosophy/free-sw.html): you can redistribute it and/or modify it under the terms of the [GNU General Public License (GPL)](http://www.gnu.org/licenses/gpl.html) as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. LibRec is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. 

You should have received a copy of the GNU General Public License along with LibRec. If not, see http://www.gnu.org/licenses/.