Skip to content

recombee/recsys24-live-paper-recommender

Repository files navigation

RecSys 2024 Live Paper Recommender

Next.js application demonstrating Recombee recommendation capabilities by showcasing research papers from previous RecSys conferences. Created for RecSys '24, this project illustrates how Recombee can be used to build a full-featured recommendation system without additional backend services.

Features

  • Browse and discover RecSys conference papers
  • Personalized paper recommendations
  • Paper bookmarking functionality
  • Similar papers recommendations
  • All powered by Recombee's API

Prerequisites

Before running the application, you'll need:

  1. Docker
  2. Recombee account and database
    • Sign up at admin.recombee.com
    • Create a new database in your desired region
    • Note down your database ID and private token

Environment Setup

  1. Clone the repository:
git clone https://github.com/recombee/explore-papers-demo.git
cd explore-papers-demo
  1. Create an environment file:
cp .env.example .env
  1. Fill in your Recombee credentials in the .env file:
RECOMBEE_DB_NAME=your-database-id
RECOMBEE_DB_PRIVATE_TOKEN=your-private-token
RECOMBEE_DB_REGION=your-database-region

Running the Application

Using Docker

  1. Build the Docker image:
docker build -t explore-papers-demo .
  1. Run the container:
docker run -p 3000:3000 explore-papers-demo

The application will be available at http://localhost:3000

Development Mode

If you prefer to run the application locally for development:

  1. Install dependencies:
pnpm i --frozen-lockfile
  1. Start the development server:
pnpm dev