{ "info": { "author": "Nicolas Hug", "author_email": "nh.nicolas.hug@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "Intended Audience :: Education", "Intended Audience :: Science/Research", "License :: OSI Approved", "Programming Language :: Python :: 3", "Topic :: Scientific/Engineering" ], "description": "[![GitHub version](https://badge.fury.io/gh/Niourf%2Frecsys.svg)](https://badge.fury.io/gh/Niourf%2Frecsys)\n[![Documentation Status](https://readthedocs.org/projects/recsys/badge/?version=latest)](http://recsys.readthedocs.io/en/latest/?badge=latest)\n[![Build Status](https://travis-ci.org/Niourf/RecSys.svg?branch=master)](https://travis-ci.org/Niourf/RecSys)\n[![python_versions](https://img.shields.io/badge/python-2.7%2C%203.4%2C%203.5-blue.svg)]\n(https://pypi.python.org/pypi/recsys/)\n[![license](https://img.shields.io/badge/license-GPLv3-blue.svg)](https://github.com/Niourf/RecSys/blob/master/LICENSE.md)\n\n\nRecSys\n======\n\nauthor: Nicolas Hug\n\nOverview\n--------\n\nRecSys is an open source Python package that provides with tools to build and\nevaluate the performance of many recommender system prediction algorithms. Its\ngoal is to make life easy(-ier) for reseachers and students who want to play\naround with new recommender algorithm ideas.\n\nA strong emphasis is laid on\n[documentation](http://recsys.readthedocs.io/en/latest/index.html), which we\nhave tried to make as clear and precise as possible by pointing out every\ndetail of the algorithms, in order for the practitioner to have perfect\ncontrol over his experiments.\n\nFeatures\n--------\n\n- [Dataset\n handling](http://recsys.readthedocs.io/en/latest/getting_started.html) is made easy.\n- Various ready-to-use [prediction\n algorithms](http://recsys.readthedocs.io/en/latest/prediction_algorithms.html).\n- Easy to implement [new algorithm\n ideas](http://recsys.readthedocs.io/en/latest/building_custom_algo.html).\n- Evaluate,\n [analyse](http://nbviewer.jupyter.org/github/Niourf/RecSys/tree/master/examples/notebooks/KNNBasic_analysis.ipynb/)\n and\n [compare](http://nbviewer.jupyter.org/github/Niourf/RecSys/tree/master/examples/notebooks/Compare.ipynb/) the algorithms performance.\n\nInstallation / Usage\n--------------------\n\nPlease, use a [virtual env](\nhttp://docs.python-guide.org/en/latest/dev/virtualenvs/)\n\nTo install from [PyPI](https://pypi.python.org/pypi/recsys/), use pip\n(recommended):\n\n $ pip install recsys\n\nOr clone the repo and build from the sources (you'll need Cython and numpy\nfirst):\n\n $ git clone https://github.com/Niourf/recsys.git\n $ python setup.py install\n\nExample\n-------\n\n```python\nfrom recsys import SVD\nfrom recsys import Dataset\nfrom recsys import evaluate\n\n\n# Load the movielens-100k dataset and split it into 3 folds for\n# cross-validation.\ndata = Dataset.load_builtin('ml-100k')\ndata.split(n_folds=3)\n\n# We'll use the famous SVD algorithm.\nalgo = SVD()\n\n# Evaluate performances of our algorithm on the dataset.\nperf = evaluate(algo, data, measures=['RMSE', 'MAE'])\n\nprint(perf['RMSE'])\nprint(perf['MAE'])\n```\n\nOutput:\n\n```\n--------------------\nfold 0\nRMSE: 0.9461\nMAE: 0.7471\n--------------------\nfold 1\nRMSE: 0.9485\nMAE: 0.7481\n--------------------\nfold 2\nRMSE: 0.9373\nMAE: 0.7389\n--------------------\nmean RMSE : 0.9440\nmean MAE : 0.7447\n[0.94610849207651793, 0.94851906980098399, 0.93725513525972337]\n[0.74705780800352328, 0.74810449832136583, 0.73891237929484566]\n```\n\nDocumentation, Getting Started\n------------------------------\n\nThe documentation with many usage examples is available\n[online](http://recsys.readthedocs.io/en/latest/index.html) on ReadTheDocs.\n\nLicense\n-------\n\nThis project is licensed under the GPLv3 license - see the LICENSE.md file for\ndetails.\n\nAcknowledgements:\n----------------\n\n- [Pierre-Fran\u00e7ois Gimenez](https://github.com/PFgimenez), for his valuable\n insights on software design.\n\nContributing\n------------\n\nAny kind of feedback would be greatly appreciated (software design,\ndocumentation, improvement ideas, spelling, etc...). Please feel free to\ncontribute!", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/Niourf/recsys/tarball/0.0.4", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/Niourf/recsys", "keywords": "", "license": "GPLv3+", "maintainer": "", "maintainer_email": "", "name": "recsys", "package_url": "https://pypi.org/project/recsys/", "platform": "", "project_url": "https://pypi.org/project/recsys/", "project_urls": { "Download": "https://github.com/Niourf/recsys/tarball/0.0.4", "Homepage": "https://github.com/Niourf/recsys" }, "release_url": "https://pypi.org/project/recsys/0.0.4/", "requires_dist": null, "requires_python": "", "summary": "A recommender system package aimed towards researchers and students.", "version": "0.0.4" }, "last_serial": 2461632, "releases": { "0.0.1": [ { "comment_text": "", "digests": { "md5": "c7fce6f092e22681b8514a988abb1760", "sha256": "9f03d20bbd18b70a14c1f0139ca5c3bcea65838411c73010a073a7d59569ab67" }, "downloads": -1, "filename": "recsys-0.0.1-py3-none-any.whl", "has_sig": false, "md5_digest": "c7fce6f092e22681b8514a988abb1760", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 19856, "upload_time": "2016-10-23T14:37:30", "url": "https://files.pythonhosted.org/packages/75/0b/5b0e581df1675ed57e0f4c0f1405175547e6dc2615aca1cb67be36b7b970/recsys-0.0.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "dcdf88361b8c632c44c7d39679aaf9f1", "sha256": "c16e6b912a0c55a29fd2bcb4a760676a790313c1323a8c6876364a8cb666ded6" }, "downloads": -1, "filename": "recsys-0.0.1.tar.gz", "has_sig": false, "md5_digest": "dcdf88361b8c632c44c7d39679aaf9f1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15349, "upload_time": "2016-10-23T14:37:32", "url": "https://files.pythonhosted.org/packages/92/2e/85bcdabb52f399314ed8fa6c02693abb25bec5e7e98277e8e647c00051da/recsys-0.0.1.tar.gz" } ], "0.0.2": [ { "comment_text": "", "digests": { "md5": "0716b5d88c813f5b3e10899c7b278ecc", "sha256": "7812029ea346d394ba4ca502381654c85fd0291f116fcf175519954e061fa8ec" }, "downloads": -1, "filename": "recsys-0.0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "0716b5d88c813f5b3e10899c7b278ecc", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 22518, "upload_time": "2016-10-23T14:54:33", "url": "https://files.pythonhosted.org/packages/a7/96/ca3440dff6308b2e9d2a2119842d918a830cc54744d04416a7d3520a523c/recsys-0.0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "323a1d92556072aca4b2baa575fce166", "sha256": "d8af15b6f98aca4c41956167cd4f1bf4d29b96346c7c25e2c00f81cd0dd9e3a8" }, "downloads": -1, "filename": "recsys-0.0.2.tar.gz", "has_sig": false, "md5_digest": "323a1d92556072aca4b2baa575fce166", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 17794, "upload_time": "2016-10-23T14:54:36", "url": "https://files.pythonhosted.org/packages/42/42/a9b3a110e48762b906302327aaa779699de26f6dfbb4b78b97ad99173e17/recsys-0.0.2.tar.gz" } ], "0.0.3": [ { "comment_text": "", "digests": { "md5": "09e4453fa7ac7d2b45eb883e4c71823f", "sha256": "612dff7777d890dd5732a28b5b0a2a681cb3a130ebe27db16dd0de8512497d63" }, "downloads": -1, "filename": "recsys-0.0.3-py2.py3-none-any.whl", "has_sig": false, "md5_digest": "09e4453fa7ac7d2b45eb883e4c71823f", "packagetype": "bdist_wheel", "python_version": "py2.py3", "requires_python": null, "size": 23482, "upload_time": "2016-10-25T11:03:34", "url": "https://files.pythonhosted.org/packages/82/f5/f7bc549749713ee02c1b179af36b86983728222efd11ea7f9e00f39b5ffb/recsys-0.0.3-py2.py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "5c8af6502b707d2f00ae7c9db6fb0fe4", "sha256": "f1649a98e42709198ff1f5ae02f9b9fc8085ae8312932157de310ee6ea905bea" }, "downloads": -1, "filename": "recsys-0.0.3.tar.gz", "has_sig": false, "md5_digest": "5c8af6502b707d2f00ae7c9db6fb0fe4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 18219, "upload_time": "2016-10-25T11:03:37", "url": "https://files.pythonhosted.org/packages/a0/4e/bdcd65f9579ff3481b3e5bc4d3dc36da3fc19424ba0edbfcf7f5e3b18f14/recsys-0.0.3.tar.gz" } ], "0.0.4": [ { "comment_text": "", "digests": { "md5": "2a2d3a8431d5e46490e08b594851a8f4", "sha256": "45a29fa726454df7e6dbd8bb1eee2bde657720a1349f2cd1f0cedb383795bd58" }, "downloads": -1, "filename": "recsys-0.0.4.tar.gz", "has_sig": false, "md5_digest": "2a2d3a8431d5e46490e08b594851a8f4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1352476, "upload_time": "2016-11-15T11:27:27", "url": "https://files.pythonhosted.org/packages/e1/d9/cb8bcab9ef4e1ad686b09297c35c685c654ab9f5e8db0295e077ef049db1/recsys-0.0.4.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "2a2d3a8431d5e46490e08b594851a8f4", "sha256": "45a29fa726454df7e6dbd8bb1eee2bde657720a1349f2cd1f0cedb383795bd58" }, "downloads": -1, "filename": "recsys-0.0.4.tar.gz", "has_sig": false, "md5_digest": "2a2d3a8431d5e46490e08b594851a8f4", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 1352476, "upload_time": "2016-11-15T11:27:27", "url": "https://files.pythonhosted.org/packages/e1/d9/cb8bcab9ef4e1ad686b09297c35c685c654ab9f5e8db0295e077ef049db1/recsys-0.0.4.tar.gz" } ] }