-
Notifications
You must be signed in to change notification settings - Fork 3.1k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Staging to main: LF announcement and GRU update #2006
Merged
Merged
Changes from 25 commits
Commits
Show all changes
38 commits
Select commit
Hold shift + click to select a range
42e6982
Replacing references GRU4Rec to GRU
miguelgfierro b5f0f3b
Replacing references GRU4Rec to GRU
miguelgfierro 4ba66e8
Replacing references GRU4Rec in config files
miguelgfierro efd001a
Update references
miguelgfierro 48ebb26
Merge pull request #2000 from recommenders-team/gru_fix
miguelgfierro 3bb666c
datasets with Sgit st!
miguelgfierro dbbbb8b
Added init to fix import error
miguelgfierro 92eb223
update repo url
miguelgfierro 3738f03
ignore xlearn
miguelgfierro 0ce2c79
Add init files
miguelgfierro 011153d
update info from MS
miguelgfierro d1fb6dc
update info from MS
miguelgfierro dc7f6a7
:memo:
miguelgfierro 457312d
Minor syntax in README
anargyri ff4634d
:memo:
miguelgfierro ccb7b75
Announcement LF
miguelgfierro bfe470c
Update email
miguelgfierro b7ee345
Update README.md
anargyri 33104a1
Merge branch 'staging' into lf
miguelgfierro 4a76743
security
miguelgfierro dc459bb
license and contribution notice
miguelgfierro 6de8ce9
update author link
miguelgfierro 63b352b
Add new code of conduct from LF
miguelgfierro 89cbebb
Merge branch 'lf' of github.com:recommenders-team/recommenders into lf
miguelgfierro 3643818
Merge pull request #2003 from recommenders-team/lf
miguelgfierro 2576273
Delete conda.md
miguelgfierro 17516c8
Merge pull request #2007 from recommenders-team/miguelgfierro-patch-1
miguelgfierro 79e61ca
Update readme LF feedback @wutaomsft
miguelgfierro 1b6ca64
Update NEWS.md
miguelgfierro 0a40ee0
Update README.md
miguelgfierro 793ef41
Merge pull request #2008 from recommenders-team/miguel/readme_ms
miguelgfierro 2beb9dd
:memo:
miguelgfierro 2036105
remove unused input
miguelgfierro 512581c
:memo:
miguelgfierro 6a8d770
no need to output the logs twice
miguelgfierro 6af75fd
packages
miguelgfierro a1a1785
skipping flaky test
miguelgfierro d3da0fe
Merge pull request #2009 from recommenders-team/miguel/review_azureml…
miguelgfierro File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,9 +1,42 @@ | ||
# Microsoft Open Source Code of Conduct | ||
<!-- | ||
Copyright (c) Recommenders contributors. | ||
Licensed under the MIT License. | ||
--> | ||
|
||
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). | ||
# Recommenders Code of Conduct | ||
|
||
Resources: | ||
This code of conduct outlines expectations for participation in the Recommenders open source community, as well as steps for reporting unacceptable behavior. We are committed to providing a welcoming and inspiring community for all. People violating this code of conduct may be banned from the community. Our open source community strives to: | ||
|
||
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) | ||
- [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) | ||
- Contact [[email protected]](mailto:[email protected]) with any additional questions or comments. | ||
* **Be friendly and patient**: Remember you might not be communicating in someone else's primary spoken or programming language, and others may not have your level of understanding. | ||
|
||
* **Be welcoming**: Our community welcomes and supports people of all backgrounds and identities. This includes, but is not limited to members of any race, ethnicity, culture, national origin, color, immigration status, social and economic class, educational level, sex, sexual orientation, gender identity and expression, age, size, family status, political belief, religion, and mental and physical ability. | ||
|
||
* **Be respectful**: We are a world-wide community of professionals, and we conduct ourselves professionally. Disagreement is no excuse for poor behavior and poor manners. Disrespectful and unacceptable behavior includes, but is not limited to: | ||
1. Violent threats or language. | ||
1. Discriminatory or derogatory jokes and language. | ||
1. Posting sexually explicit or violent material. | ||
1. Posting, or threatening to post, people's personally identifying information ("doxing"). | ||
1. Insults, especially those using discriminatory terms or slurs. | ||
1. Behavior that could be perceived as sexual attention. | ||
1. Advocating for or encouraging any of the above behaviors. | ||
|
||
* **Understand disagreements**: Disagreements, both social and technical, are useful learning opportunities. Seek to understand the other viewpoints and resolve differences constructively. | ||
|
||
* **Remember that we’re different**. The strength of our community comes from its diversity, people from a wide range of backgrounds. Different people have different perspectives on issues. Being unable to understand why someone holds a viewpoint doesn’t mean that they’re wrong. Focus on helping to resolve issues and learning from mistakes. | ||
|
||
* This code is not exhaustive or complete. It serves to capture our common understanding of a productive, collaborative environment. We expect the code to be followed in spirit as much as in the letter. | ||
|
||
## Reporting Code of Conduct Issues | ||
|
||
We encourage all communities to resolve issues on their own whenever possible. This builds a broader and deeper understanding and ultimately a healthier interaction. In the event that an issue cannot be resolved locally, please feel free to report your concerns by contacting [email protected]. In your report please include: | ||
|
||
1. Your contact information. | ||
1. Names (real, usernames or pseudonyms) of any individuals involved. If there are additional witnesses, please include them as well. | ||
1. Your account of what occurred, and if you believe the incident is ongoing. If there is a publicly available record (e.g. a mailing list archive or a public chat log), please include a link or attachment. | ||
1. Any additional information that may be helpful. | ||
|
||
All reports will be reviewed by a multi-person team and will result in a response that is deemed necessary and appropriate to the circumstances. Where additional perspectives are needed, the team may seek insight from others with relevant expertise or experience. The confidentiality of the person reporting the incident will be kept at all times. Involved parties are never part of the review team. | ||
|
||
Anyone asked to stop unacceptable behavior is expected to comply immediately. If an individual engages in unacceptable behavior, the review team may take any action they deem appropriate, including a permanent ban from the community. | ||
|
||
*This code of conduct is based on the [template](http://todogroup.org/opencodeofconduct) established by the [TODO Group](http://todogroup.org/) and used by numerous other large communities and the Scope section from the [Contributor Covenant version 1.4](http://contributor-covenant.org/version/1/4/).* |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,20 +1,25 @@ | ||
<!-- | ||
Copyright (c) Recommenders contributors. | ||
Licensed under the MIT License. | ||
--> | ||
|
||
# Recommenders | ||
|
||
[![Documentation Status](https://readthedocs.org/projects/microsoft-recommenders/badge/?version=latest)](https://microsoft-recommenders.readthedocs.io/en/latest/?badge=latest) | ||
|
||
<img src="https://raw.githubusercontent.com/recommenders-team/artwork/main/color/recommenders_color.svg" width="800"> | ||
|
||
## What's New (August, 2023) | ||
## What's New (October, 2023) | ||
|
||
We moved to a new organization! Now to access the repo, instead of going to https://github.com/microsoft/recommenders, you need to go to https://github.com/recommenders-team/recommenders. The old URL will still resolve to the new one, but we recommend that you update your bookmarks. | ||
We are pleased to announced that we have joined the [Linux Foundation of AI and Data](https://lfaidata.foundation/) (LF AI & Data). With this move, our objective is to keep building an ecosystem to sustain open source innovation and collaboration in recommendation systems. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Same comment as above. There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. PR here: #2008 |
||
|
||
Starting with release 0.6.0, Recommenders has been available on PyPI and can be installed using pip! | ||
We moved to a new organization! Now to access the repo, instead of going to https://github.com/microsoft/recommenders, you need to go to https://github.com/recommenders-team/recommenders. The old URL will still resolve to the new one, but we recommend that you update your bookmarks. | ||
|
||
Here you can find the PyPi page: https://pypi.org/project/recommenders/ | ||
## Introduction | ||
|
||
Here you can find the package documentation: https://microsoft-recommenders.readthedocs.io/en/latest/ | ||
Recommenders objective is to assist researchers, developers and enthusiasts in prototyping, experimenting with and bringing to production a range of classic and state-of-the-art recommendation systems. | ||
|
||
## Introduction | ||
Recommenders is a project under the [Linux Foundation of AI and Data](https://lfaidata.foundation/projects/). | ||
|
||
This repository contains examples and best practices for building recommendation systems, provided as Jupyter notebooks. The examples detail our learnings on five key tasks: | ||
|
||
|
@@ -82,7 +87,7 @@ The table below lists the recommender algorithms currently available in the repo | |
| LightGBM/Gradient Boosting Tree<sup>*</sup> | Content-Based Filtering | Gradient Boosting Tree algorithm for fast training and low memory usage in content-based problems. It works in the CPU/GPU/PySpark environments. | [Quick start in CPU](examples/00_quick_start/lightgbm_tinycriteo.ipynb) / [Deep dive in PySpark](examples/02_model_content_based_filtering/mmlspark_lightgbm_criteo.ipynb) | | ||
| LightGCN | Collaborative Filtering | Deep learning algorithm which simplifies the design of GCN for predicting implicit feedback. It works in the CPU/GPU environment. | [Deep dive](examples/02_model_collaborative_filtering/lightgcn_deep_dive.ipynb) | | ||
| GeoIMC<sup>*</sup> | Hybrid | Matrix completion algorithm that has into account user and item features using Riemannian conjugate gradients optimization and following a geometric approach. It works in the CPU environment. | [Quick start](examples/00_quick_start/geoimc_movielens.ipynb) | | ||
| GRU4Rec | Collaborative Filtering | Sequential-based algorithm that aims to capture both long and short-term user preferences using recurrent neural networks. It works in the CPU/GPU environment. | [Quick start](examples/00_quick_start/sequential_recsys_amazondataset.ipynb) | | ||
| GRU | Collaborative Filtering | Sequential-based algorithm that aims to capture both long and short-term user preferences using recurrent neural networks. It works in the CPU/GPU environment. | [Quick start](examples/00_quick_start/sequential_recsys_amazondataset.ipynb) | | ||
| Multinomial VAE | Collaborative Filtering | Generative model for predicting user/item interactions. It works in the CPU/GPU environment. | [Deep dive](examples/02_model_collaborative_filtering/multi_vae_deep_dive.ipynb) | | ||
| Neural Recommendation with Long- and Short-term User Representations (LSTUR)<sup>*</sup> | Content-Based Filtering | Neural recommendation algorithm for recommending news articles with long- and short-term user interest modeling. It works in the CPU/GPU environment. | [Quick start](examples/00_quick_start/lstur_MIND.ipynb) | | ||
| Neural Recommendation with Attentive Multi-View Learning (NAML)<sup>*</sup> | Content-Based Filtering | Neural recommendation algorithm for recommending news articles with attentive multi-view learning. It works in the CPU/GPU environment. | [Quick start](examples/00_quick_start/naml_MIND.ipynb) | | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,18 @@ | ||
<!-- | ||
Copyright (c) Recommenders contributors. | ||
Licensed under the MIT License. | ||
--> | ||
|
||
# Security Policy | ||
|
||
## Reporting a Vulnerability | ||
If you think you have found a security vulnerability, please send a report to [email protected]. | ||
|
||
We don't currently have a PGP key, unfortunately. | ||
|
||
A Recommenders committer will send you a response indicating the next steps in handling your report. After the initial reply to your report, the committer will keep you informed of the progress towards a fix and full announcement, and may ask for additional information or guidance. | ||
|
||
Important: Please don't disclose the vulnerability before it has been fixed and announced, to protect our users. | ||
|
||
## Security announcements | ||
Please subscribe to the [announcements mailing list](https://lists.lfaidata.foundation/g/recommenders-announce), where we post notifications and remediation details for security vulnerabilities. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think it is important to note prominently in the home page that that this repo used to be "Microsoft Recommenders", so people are sure that they don't get redirected by malware, etc.
Suggest to change the Update to be: "We are pleased to announce that this repository (formerly known as Microsoft Recommenders, https://github.com/microsoft/recommenders)", has joined the Linux Foundation of AI and Data (LF AI & Data)! The new organization, recommenders-team, reflects this change.
We hope this move makes it easy for anyone to contribute! Our objective continues to be building an ecosystem and a community to sustain open source innovations and collaborations in recommendation systems. "
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It may be good to add a few words about the active work going on at the repo, e.g., support of newer version of python, etc.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@miguelgfierro did you see these comments?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@wutaomsft new PR: #2008 please review