https://github.com/markdouthwaite/xanthus

Neural recommendation models in Python, using Tensorflow 2.0 & Keras.
https://github.com/markdouthwaite/xanthus

data-science deep-learning keras neural-collaborative-filtering neural-networks python recommendation-system recommender-system tensorflow

Last synced: 27 days ago
JSON representation

Neural recommendation models in Python, using Tensorflow 2.0 & Keras.

• Host: GitHub
• URL: https://github.com/markdouthwaite/xanthus
• Owner: markdouthwaite
• License: mit
• Created: 2020-06-03T15:49:40.000Z (over 4 years ago)
• Default Branch: 0.1.0
• Last Pushed: 2023-05-22T23:33:05.000Z (over 1 year ago)
• Last Synced: 2024-09-27T13:41:02.301Z (about 1 month ago)
• Topics: data-science, deep-learning, keras, neural-collaborative-filtering, neural-networks, python, recommendation-system, recommender-system, tensorflow
• Language: Python
• Homepage:
• Size: 204 KB
• Stars: 4
• Watchers: 4
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
Xanthus: Neural Recommendation Models in Python










[**Quickstart**](#quickstart)

| [**Install guide**](#installation)

## What is Xanthus?

Xanthus is a package that was started as personal project to translate an academic ML paper into a 'production ready' software package. It provides the tools and model architectures necessary to utilise the techniques outlined in [He et al's work](https://dl.acm.org/doi/10.1145/3038912.3052569) on Neural Collaborative Filtering in your own projects. Over time, you'll find work from other research finding it's way in here. The aim of this package is to make state-of-the-art research into neural recommenders accessible and ultimately ready for deployment. You might find that it's not quite there yet on that latter point, but sit tight, it will be.

Sound good? Great, here goes.

## Quickstart

Want to get straight into the code? Here's an [introductory notebook](docs/getting-started.ipynb) just for you.

You can also find some examples of how to use Xanthus with sample datasets in this

repo's docs. These include:

* [A minimal example using the Movielens (100k) dataset.](docs/getting-started.ipynb)

* [An example using the meta-data features of Xanthus on the Movielens (100k) dataset.](examples/metadata.py)

If you're interested in seeing the results of benchmarking of Xanthus' models against 'classic' 

collaborative filtering models, you'll have to sit tight. But rest assured: benchmarks are on their way.

## Installation

Xanthus is a pure Python package, and you'll need Python 3.6 or greater to use Xanthus.

To install, simply run:

```bash

pip install xanthus

```

That's it, you're good to go. Well, except for one thing...

The package makes extensive use of [Tensorflow 2.0](https://www.tensorflow.org/tutorials/quickstart/beginner) and the [Keras](https://keras.io/) API. If

you want to make use of the GPU acceleration provided by Tensorflow, you'll need to 

follow the [Tensorflow team's guide](https://www.tensorflow.org/install/gpu) for setting that up. If you don't need GPUs

right now, then great, you _really_ are all set.