{ "info": { "author": "Criteo AI Lab", "author_email": "", "bugtrack_url": null, "classifiers": [ "License :: OSI Approved :: Apache Software License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.6" ], "description": "# RecoGym\n\nPython code for the RecSys 2018 REVEAL workshop paper entitled 'RecoGym: A Reinforcement Learning Environment for the problem of Product Recommendation in Online Advertising'. A pre-print version of the paper can be found here - https://arxiv.org/abs/1808.00720\n\n_RecoGym_ is a Open-AI gym RL environment for recommendation, which is defined by a model of user traffic patterns on e-commerce and the users response to recommendations on the publisher websites. We hope that _RecoGym_ will be an important step forward for the field of recommendation systems research, that could open up an avenue of collaboration between the recommender systems and reinforcement learning communities and lead to better alignment between offline and online performance metrics.\n\nFor getting starting with _RecoGym_ please view the 'Getting Started' Jupyter Notebook which will explain the functionality of the environment and detail the creation of a simple agent. The 'Compare Agent' notebook compares the recommendation performance of a selection of our included agents. The agent we include with _RecoGym_ can be found in the agents directory of this repository. \n\n## Dependencies and Requirements\nThe code has been designed to support python 3.6+ only. The project has the following dependencies\n and version requirements:\n\n- notebook==6.0.1+\n- matplotlib==3.1.1+\n- intel-numpy==1.15.1+\n- pandas==0.25.1+\n- intel-scipy==1.1.0\n- torch==1.2.0+\n- scikit-learn==0.21.3+\n\nIn this repository we provide a Anaconda environment setup file with all the required python packages and versions all ready configured. You can install it as follows:\n\n```bash\n# install conda env\nconda create -n reco-gym python=3.6\nconda activate reco-gym\n\npip install recogym==0.1.2.3\n```\n\nFor MacOS users, you shall also install _`libomp`_:\n```bash\nbrew install libomp\n```\n\n## Cite\n\nPlease cite the associated paper for this work if you use this code:\n\n```\n@article{rohde2018recogym,\n title={RecoGym: A Reinforcement Learning Environment for the problem of Product Recommendation in Online Advertising},\n author={Rohde, David and Bonner, Stephen and Dunlop, Travis and Vasile, Flavian and Karatzoglou, Alexandros},\n journal={arXiv preprint arXiv:1808.00720},\n year={2018}\n}\n```\n\n## License\n\nCopyright CRITEO\n\nLicensed under the Apache License, Version 2.0 (the \"License\"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software distributed under the License is distributed on an \"AS IS\" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and limitations under the License.\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://github.com/criteo-research/reco-gym", "keywords": "", "license": "Apache License", "maintainer": "", "maintainer_email": "", "name": "recogym", "package_url": "https://pypi.org/project/recogym/", "platform": "", "project_url": "https://pypi.org/project/recogym/", "project_urls": { "Homepage": "https://github.com/criteo-research/reco-gym" }, "release_url": "https://pypi.org/project/recogym/0.1.2.3/", "requires_dist": [ "absl-py", "pandas", "matplotlib", "simplegeneric", "gym", "torch", "numba", "tqdm", "datetime", "jupyter", "intel-scipy", "intel-numpy", "intel-scikit-learn" ], "requires_python": "", "summary": "Open-AI gym reinforcement learning environment for recommendation", "version": "0.1.2.3" }, "last_serial": 5935075, "releases": { "0.1.0.0": [ { "comment_text": "", "digests": { "md5": "43b9d9f6465f2fd466f140f6168f4534", "sha256": "294f277bbe9d810aaf6704a53c89606ee698a896a3486206b41d40600ba2b6f0" }, "downloads": -1, "filename": "recogym-0.1.0.0-py3-none-any.whl", "has_sig": false, "md5_digest": "43b9d9f6465f2fd466f140f6168f4534", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 38168, "upload_time": "2019-06-18T14:20:32", "url": "https://files.pythonhosted.org/packages/88/ae/739f6277dc23a9cc5fd8fa1074b7ee348aa9c167745c20433809bacda5b0/recogym-0.1.0.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "2fa8c5c065578aa179a91a2a29071813", "sha256": "ea5a7e9da509aaaa18b42b3ea13c40d77e52f3f0252508f7d665371f98717ac0" }, "downloads": -1, "filename": "recogym-0.1.0.0.tar.gz", "has_sig": false, "md5_digest": "2fa8c5c065578aa179a91a2a29071813", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24484, "upload_time": "2019-06-18T14:20:34", "url": "https://files.pythonhosted.org/packages/75/a4/dae9f28a6e53575510afdd87b0f8a2346e80e67b1e9b8d9fb3dc578eef43/recogym-0.1.0.0.tar.gz" } ], "0.1.1.0": [ { "comment_text": "", "digests": { "md5": "7f7b39b1b9f0a569d85db43b3b2c734f", "sha256": "dbe7873006a9ec437904ee6a86e502809824cf054173bd3e07a758b35d6cabcb" }, "downloads": -1, "filename": "recogym-0.1.1.0-py3-none-any.whl", "has_sig": false, "md5_digest": "7f7b39b1b9f0a569d85db43b3b2c734f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 38367, "upload_time": "2019-06-18T15:09:13", "url": "https://files.pythonhosted.org/packages/f3/c5/4b43cc3db6d2201b4c95cf8d86b8cd75f3a4ce0ca8479844210764987d00/recogym-0.1.1.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "bc353d5a1d9aebbcf8bc7a3e7eca8540", "sha256": "319b16bc12fe1a63b3f114fbdfbe2f90de65c55a6a56e7fef89843da8f230744" }, "downloads": -1, "filename": "recogym-0.1.1.0.tar.gz", "has_sig": false, "md5_digest": "bc353d5a1d9aebbcf8bc7a3e7eca8540", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 24653, "upload_time": "2019-06-18T15:09:14", "url": "https://files.pythonhosted.org/packages/ab/03/7b330b1712eff975ac0360fbffe69303faa0d902839441ebc2e637f1557b/recogym-0.1.1.0.tar.gz" } ], "0.1.1.1": [ { "comment_text": "", "digests": { "md5": "a83e6094e8cc165b82ad8ae110b2308d", "sha256": "c58dc7a6dcae0b4c74216dcf7535f926bc560a979ed2293a3eb680251639215d" }, "downloads": -1, "filename": "recogym-0.1.1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "a83e6094e8cc165b82ad8ae110b2308d", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 54371, "upload_time": "2019-10-01T14:38:01", "url": "https://files.pythonhosted.org/packages/81/4a/b042d9ab5a1fb4dfe56f510a9736d2ef2a51722218e2e285033d92115094/recogym-0.1.1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "64650c04d7412a6319c43471d82be7a7", "sha256": "8b05f7844429b84ca39bd695884e1954a0ad40bcd2226d237b45ee5b81ca6037" }, "downloads": -1, "filename": "recogym-0.1.1.1.tar.gz", "has_sig": false, "md5_digest": "64650c04d7412a6319c43471d82be7a7", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 38513, "upload_time": "2019-10-01T14:38:04", "url": "https://files.pythonhosted.org/packages/15/06/79ce5c14b0eccf75695a5c9b49287e586a99bea90e45fcdf739dbe5d913d/recogym-0.1.1.1.tar.gz" } ], "0.1.1.2": [ { "comment_text": "", "digests": { "md5": "5121c9a9c17d8771c3f16d182393bc3f", "sha256": "04fa8495c2fd7852deb881e9b086d269bcecc0c6b34f6df0b0ef5134d2f7bebe" }, "downloads": -1, "filename": "recogym-0.1.1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "5121c9a9c17d8771c3f16d182393bc3f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 54355, "upload_time": "2019-10-01T15:01:49", "url": "https://files.pythonhosted.org/packages/40/51/912a73e3a4aba636d216c493081daaa19c9c18a39b419d8a865784ae4a92/recogym-0.1.1.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "abbe4ae807f14696b70ae8108d7a63da", "sha256": "8b05ec33dbd0b163b5a590f1f1f6ae9e625af39349fbfe4a551ebde3e829a30a" }, "downloads": -1, "filename": "recogym-0.1.1.2.tar.gz", "has_sig": false, "md5_digest": "abbe4ae807f14696b70ae8108d7a63da", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 38607, "upload_time": "2019-10-01T15:01:51", "url": "https://files.pythonhosted.org/packages/b7/11/ec33bec3412c67b7f0235377a36e7dbbacde8ca27fd1e86546370e5f4523/recogym-0.1.1.2.tar.gz" } ], "0.1.2.0": [ { "comment_text": "", "digests": { "md5": "5c4f396273d95f8003ec4cdaf11e91eb", "sha256": "73f80e78154792bee4a21516b592aafdaef489f1786661a632a70d0274dc6f47" }, "downloads": -1, "filename": "recogym-0.1.2.0-py3-none-any.whl", "has_sig": false, "md5_digest": "5c4f396273d95f8003ec4cdaf11e91eb", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 39585, "upload_time": "2019-06-26T16:04:00", "url": "https://files.pythonhosted.org/packages/95/72/c0cc3181d159217ceda83dc73e88289e97359aa4b9c7d9c669215b6a6efa/recogym-0.1.2.0-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "d1ed22f2c2354ac7cfb637efaa7fc7e6", "sha256": "2d4b9aa2962587a565112b60688d7af5d8651725badd8e88cf846deca1876cfc" }, "downloads": -1, "filename": "recogym-0.1.2.0.tar.gz", "has_sig": false, "md5_digest": "d1ed22f2c2354ac7cfb637efaa7fc7e6", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 25849, "upload_time": "2019-06-26T16:04:02", "url": "https://files.pythonhosted.org/packages/2a/97/965e7ae476f87c7318dca35b47d2f9f579b75a33a76be2324ec1041ecc4b/recogym-0.1.2.0.tar.gz" } ], "0.1.2.1": [ { "comment_text": "", "digests": { "md5": "159a9b94a7b17aeb217a11d32c60c19e", "sha256": "52d0790fabe59669f1722e07f6f7854d91c2054b936b09d63c000912435e952a" }, "downloads": -1, "filename": "recogym-0.1.2.1-py3-none-any.whl", "has_sig": false, "md5_digest": "159a9b94a7b17aeb217a11d32c60c19e", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 39800, "upload_time": "2019-06-26T17:42:05", "url": "https://files.pythonhosted.org/packages/01/1f/394d0cbb52967a7298e4987a31b560fe864fda3efca1cc134dff1eddf185/recogym-0.1.2.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b43b3e03cd462746d59d524d1a60d341", "sha256": "c7376d8df8832934c85a1cd2432a5b57ed1b398538e1676b4e7446f7a24d9962" }, "downloads": -1, "filename": "recogym-0.1.2.1.tar.gz", "has_sig": false, "md5_digest": "b43b3e03cd462746d59d524d1a60d341", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 26061, "upload_time": "2019-06-26T17:42:06", "url": "https://files.pythonhosted.org/packages/55/11/ac40acebb050d0361b54d3b35d5830e63094a3afdcaa7864d2742088da3d/recogym-0.1.2.1.tar.gz" } ], "0.1.2.2": [ { "comment_text": "", "digests": { "md5": "17bb2145fe92974dddd677fa9183a70d", "sha256": "7d26b384f8e03dc868145ff8d3c6dc84023ee47330a133ac2fde2c2202ef889c" }, "downloads": -1, "filename": "recogym-0.1.2.2-py3-none-any.whl", "has_sig": false, "md5_digest": "17bb2145fe92974dddd677fa9183a70d", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 54405, "upload_time": "2019-10-01T15:26:37", "url": "https://files.pythonhosted.org/packages/af/80/b8a28c2884566701c77e9141bc8c04d8f6d83400b6897522f2fbdc8e6218/recogym-0.1.2.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "823a227254286ff8cd9c807154b8d10f", "sha256": "6f10c541a599b7a73ffedc303ff04d700153753e09225a5f264e017db353dc02" }, "downloads": -1, "filename": "recogym-0.1.2.2.tar.gz", "has_sig": false, "md5_digest": "823a227254286ff8cd9c807154b8d10f", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 38588, "upload_time": "2019-10-01T15:26:51", "url": "https://files.pythonhosted.org/packages/8e/a5/aae0dc5e2628cc85d578868b6ed0f380c21338531beb149d124128ce64de/recogym-0.1.2.2.tar.gz" } ], "0.1.2.3": [ { "comment_text": "", "digests": { "md5": "0c2975f4ffb09005eeaba61d363ead27", "sha256": "c6117cd71a7089b3dcdfeb4b23878ecfd055e5bf5fe28e2880079be2c2465cc2" }, "downloads": -1, "filename": "recogym-0.1.2.3-py3-none-any.whl", "has_sig": false, "md5_digest": "0c2975f4ffb09005eeaba61d363ead27", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 55932, "upload_time": "2019-10-06T14:55:25", "url": "https://files.pythonhosted.org/packages/66/14/28e0fa50aaa063feb16f40f781eb027b50769dd6589f2e84e866497ddfa8/recogym-0.1.2.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "efeb2758a0731da5a5a9f34ccb20a438", "sha256": "26ed16aa598f20fe3cda0beb28690c25b3fb0297e3b191690873a83403d19c28" }, "downloads": -1, "filename": "recogym-0.1.2.3.tar.gz", "has_sig": false, "md5_digest": "efeb2758a0731da5a5a9f34ccb20a438", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 39977, "upload_time": "2019-10-06T14:55:27", "url": "https://files.pythonhosted.org/packages/fa/01/7fe83a251b860d0cec4e26e6e34932ca1a9f83a1afa568e1ca93dddf8bb8/recogym-0.1.2.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "0c2975f4ffb09005eeaba61d363ead27", "sha256": "c6117cd71a7089b3dcdfeb4b23878ecfd055e5bf5fe28e2880079be2c2465cc2" }, "downloads": -1, "filename": "recogym-0.1.2.3-py3-none-any.whl", "has_sig": false, "md5_digest": "0c2975f4ffb09005eeaba61d363ead27", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 55932, "upload_time": "2019-10-06T14:55:25", "url": "https://files.pythonhosted.org/packages/66/14/28e0fa50aaa063feb16f40f781eb027b50769dd6589f2e84e866497ddfa8/recogym-0.1.2.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "efeb2758a0731da5a5a9f34ccb20a438", "sha256": "26ed16aa598f20fe3cda0beb28690c25b3fb0297e3b191690873a83403d19c28" }, "downloads": -1, "filename": "recogym-0.1.2.3.tar.gz", "has_sig": false, "md5_digest": "efeb2758a0731da5a5a9f34ccb20a438", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 39977, "upload_time": "2019-10-06T14:55:27", "url": "https://files.pythonhosted.org/packages/fa/01/7fe83a251b860d0cec4e26e6e34932ca1a9f83a1afa568e1ca93dddf8bb8/recogym-0.1.2.3.tar.gz" } ] }