Ecosyste.ms: Awesome

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

https://github.com/jfkirk/tensorrec

A TensorFlow recommendation algorithm and framework in Python.
https://github.com/jfkirk/tensorrec

framework machine-learning python recommendation-algorithm recommendation-system recommender-system tensorflow

Last synced: about 1 month ago
JSON representation

A TensorFlow recommendation algorithm and framework in Python.

Host: GitHub
URL: https://github.com/jfkirk/tensorrec
Owner: jfkirk
License: apache-2.0
Created: 2017-02-28T18:51:11.000Z (over 7 years ago)
Default Branch: master
Last Pushed: 2023-05-22T21:34:54.000Z (about 1 year ago)
Last Synced: 2024-02-29T22:22:23.048Z (3 months ago)
Topics: framework, machine-learning, python, recommendation-algorithm, recommendation-system, recommender-system, tensorflow
Language: Python
Homepage:
Size: 626 KB
Stars: 1,249
Watchers: 64
Forks: 222
Open Issues: 41
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Lists

awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python-cn - tensorrec
Awesome-Python - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - tensorrec - 2.0](https://api.github.com/licenses/apache-2.0)- A TensorFlow recommendation algorithm and framework in Python. (Awesome Python / Recommender Systems)
Python-Awesome - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
python-awesome-case1 - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
fucking-awesome-python - :octocat: tensorrec - :star: 1236 :fork_and_knife: 224 - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python-master - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
my-awesome-stars - jfkirk/tensorrec - A TensorFlow recommendation algorithm and framework in Python. (Python)
awesome_python - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-RecSys - TensorRec
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
join-awesome-python-interview-topics - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python-cn - tensorrec
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python-clone - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python-resources-all - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
fucking-awesome-python - :octocat: tensorrec - :star: 1104 :fork_and_knife: 205 - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python-zh - tensorrec - TensorFlow中的推荐引擎框架。 (推荐系统)
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python-resources - GitHub - 28% open · ⏱️ 04.02.2020): (推荐系统)
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesomePython - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python-master - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome_python_with_star - jfkirk/tensorrec
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
git-github.com-vinta-awesome-python - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
python-awesome - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
Mpaperlee-awesome-python - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python-machine-learning-resources - GitHub - 28% open · ⏱️ 04.02.2020): (推荐系统)
awesome_python - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - TensorRec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)
awesome-python - tensorrec - A Recommendation Engine Framework in TensorFlow. (Recommender Systems)

README

        # TensorRec

A TensorFlow recommendation algorithm and framework in Python.

[![PyPI version](https://badge.fury.io/py/tensorrec.svg)](https://badge.fury.io/py/tensorrec) [![Build Status](https://travis-ci.org/jfkirk/tensorrec.svg?branch=master)](https://travis-ci.org/jfkirk/tensorrec) [![Gitter chat](https://badges.gitter.im/tensorrec/gitter.png)](https://gitter.im/tensorrec)

## NOTE: TensorRec is not under active development

TensorRec will not be receiving any more planned updates. Please feel free to open pull requests -- I am happy to review them.

Thank you for your contributions, support, and usage of TensorRec!

-James Kirk, @jfkirk

For similar tools, check out:

[TensorFlow Ranking](https://github.com/tensorflow/ranking/)

[Spotlight](https://github.com/maciejkula/spotlight)

[LightFM](https://github.com/lyst/lightfm)

## What is TensorRec?

TensorRec is a Python recommendation system that allows you to quickly develop recommendation algorithms and customize them using TensorFlow.

TensorRec lets you to customize your recommendation system's representation/embedding functions and loss functions while TensorRec handles the data manipulation, scoring, and ranking to generate recommendations.

A TensorRec system consumes three pieces of data: `user_features`, `item_features`, and `interactions`. It uses this data to learn to make and rank recommendations.

For an overview of TensorRec and its usage, please see the [wiki.](https://github.com/jfkirk/tensorrec/wiki)

For more information, and for an outline of this project, please read [this blog post.](https://medium.com/@jameskirk1/tensorrec-a-recommendation-engine-framework-in-tensorflow-d85e4f0874e8)

For an introduction to building recommender systems, please see [these slides.](https://www.slideshare.net/JamesKirk58/boston-ml-architecting-recommender-systems)

![TensorRec System Diagram](https://raw.githubusercontent.com/jfkirk/tensorrec/master/examples/system_diagram.png)

### Example: Basic usage

```python

import numpy as np

import tensorrec

# Build the model with default parameters

model = tensorrec.TensorRec()

# Generate some dummy data

interactions, user_features, item_features = tensorrec.util.generate_dummy_data(

    num_users=100,

    num_items=150,

    interaction_density=.05

)

# Fit the model for 5 epochs

model.fit(interactions, user_features, item_features, epochs=5, verbose=True)

# Predict scores and ranks for all users and all items

predictions = model.predict(user_features=user_features,

                            item_features=item_features)

predicted_ranks = model.predict_rank(user_features=user_features,

                                     item_features=item_features)

# Calculate and print the recall at 10

r_at_k = tensorrec.eval.recall_at_k(predicted_ranks, interactions, k=10)

print(np.mean(r_at_k))

```

## Quick Start

TensorRec can be installed via pip:

```pip install tensorrec```