Gym-Recsys is a Python-based framework offering OpenAI Gym-compatible environments designed to simulate user-item interactions. It enables researchers and engineers to train and benchmark reinforcement learning recommendation agents using synthetic or real-world datasets, with built-in user behavior models and standard evaluation metrics.
Gym-Recsys is a Python-based framework offering OpenAI Gym-compatible environments designed to simulate user-item interactions. It enables researchers and engineers to train and benchmark reinforcement learning recommendation agents using synthetic or real-world datasets, with built-in user behavior models and standard evaluation metrics.
Gym-Recsys is a toolbox that wraps recommendation tasks into OpenAI Gym environments, allowing reinforcement learning algorithms to interact with simulated user-item matrices step by step. It provides synthetic user behavior generators, supports loading popular datasets, and delivers standard recommendation metrics like Precision@K and NDCG. Users can customize reward functions, user models, and item pools to experiment with different RL-based recommendation strategies in a reproducible manner.
Who will use Gym-Recsys?
Reinforcement learning researchers
Recommender system engineers
Data scientists in personalization
Academic instructors in ML courses
How to use the Gym-Recsys?
Step1: Install via pip install gym-recsys
Step2: Import and load a built‐in or custom dataset
Step3: Create an environment with gym.make('RecSys-v0')
Step4: Define or plug in an RL agent (DQN, Policy Gradient, etc.)
Step5: Train the agent by interacting with the environment
Step6: Evaluate performance using provided metrics and logs
Platform
mac
windows
linux
Gym-Recsys's Core Features & Benefits
The Core Features
OpenAI Gym-compatible recommendation environments
Synthetic and real-world dataset support
User behavior simulation modules
Standard recommendation metrics integration
Customizable reward and observation spaces
The Benefits
Reproducible RL recommendation benchmarks
Easy integration with common RL libraries
Flexible environment configuration
Scalable experiments on various data sizes
Gym-Recsys's Main Use Cases & Applications
Developing and testing RL-based recommender algorithms
Benchmarking recommendation strategies across datasets
Teaching reinforcement learning concepts in personalization
Simulating user engagement and item ranking dynamics