Metadata-Version: 2.1
Name: deeprecsys
Version: 0.2.7
Summary: deeprecsys is an open tool belt to speed up the development of modern data science projects at an enterprise level
Home-page: https://deeprecsys.com
License: GPL-3.0-or-later
Keywords: machinelearning,reinforcementlearning,recommmendersystems,deeplearning,datascience
Author: Lucas Farris
Author-email: lucas@farris.com.br
Requires-Python: >=3.9,<4
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Provides-Extra: recsys
Requires-Dist: gymnasium (>=0.29.1,<0.30.0) ; extra == "recsys"
Requires-Dist: highway-env (>=1.8.2,<2.0.0) ; extra == "recsys"
Requires-Dist: keras (>=3.3.3,<4.0.0) ; extra == "recsys"
Requires-Dist: pandas (>=2.2.2,<3.0.0)
Requires-Dist: pyarrow (>=16.1.0,<17.0.0)
Requires-Dist: seaborn (>=0.13.2,<0.14.0)
Requires-Dist: tensorboard (>=2.16.2,<3.0.0) ; extra == "recsys"
Requires-Dist: torch (==2.3.0+cpu) ; extra == "recsys"
Requires-Dist: torchviz (>=0.0.2,<0.0.3) ; extra == "recsys"
Project-URL: Documentation, https://deeprecsys.com
Project-URL: Repository, https://github.com/luksfarris/deeprecsys
Description-Content-Type: text/markdown

# Deep RecSys

`deeprecsys` is an <u>open</u> <u>tool belt</u> to speed up the development of <u>modern</u> <u>data science</u> projects at an <u>enterprise</u> level.

These words were chosen very carefully, and by them we mean:
- **Open**: we rely on OSS and distribute openly with [a GNU GPLv3 license](./LICENSE) that won't change in the future. The official distribution channels are pypi ([see deeprecsys at pypi](https://pypi.org/project/deeprecsys/)) and GitHub ([see deeprecsys at Github](https://github.com/luksfarris/deeprecsys)).
- **Tool belt**: this project contains code that may extract, process, analyse, aggregate, test, and present data.
- **Modern**: the code will be updated as much as possible to the newest versions, as long as they are stable and don't break pre-existing functionality.
- **Data Science**: This project will contain a mixture of data engineering, machine learning engineering, data analysis, and data visualization.
- **Enterprise**: The code deployed here will likely have been battle-tested by large organizations with millions of customers. Unless stated, it is production-ready. All code including dependencies is audited and secure.

## Historical Note

If you're here from the research piece [Optimized Recommender Systems with Deep Reinforcement Learning](https://arxiv.org/abs/2110.03039), please checkout the old branch `origin/thesis` for reproducibility. The README should contain instructions to get you started.

## Installation and usage

Installation depends on your framework, so you may need to adapt this. Here's an example using pip:

```
pip install deeprecsys
```

## For Developers

### Source Control

All source control is done in `git`, via GitHub. Make sure you have a modern version of git installed. For instance, you can checkout the project using SSH with:

```
git clone git@github.com:luksfarris/deeprecsys.git
```

### Automation

All scripts are written using Taskfile. You can install it following [Task's instructions](https://taskfile.dev/installation/). The file with all the tasks is `Taskfile.yml`.
