CoreRec

CoreRec#

CoreRec

Production-grade recommendation systems framework. 57+ models, unified API, multi-stage pipelines -- from research to deployment.

pip install corerec
57+Models
5Categories
3Pipeline Stages
TypedProduction API

Get Started

Installation

System requirements, pip install, optional dependencies, and verifying your setup.

Installation Guide
QuickStart Guide

Train your first model in under 5 minutes with a worked DCN example on MovieLens.

QuickStart Guide
Core Concepts

Architecture overview – engines, pipelines, retrieval/ranking/reranking stages.

Core Concepts

Capabilities

Unified Model API

Every model shares fit(), predict(), recommend(), save(), load(). Swap models without changing your code.

BaseRecommender API
Multi-Stage Pipeline

Retrieval, ranking, reranking – compose retrieval sources, scoring models, and post-processing in a single pipeline.

Pipeline System
Retrieval Layer

Collaborative, semantic, and popularity retrievers with ensemble fusion (RRF, weighted, union).

Retrieval
Ranking & Reranking

Pointwise, pairwise, and feature-cross rankers. Diversity, fairness, and business-rule rerankers.

Ranking
Model Serving

Batch inference, model loading, and a lightweight model server for production deployment.

Model Serving

Model Categories

Deep Learning

29 models – DCN, DeepFM, DIEN, DIN, DLRM, Wide&Deep, and more.

Deep Learning Models
Matrix Factorization

9 models – SVD, ALS, NMF, and advanced variants.

Matrix Factorization & Collaborative Filtering
Graph-Based

6 models – GNNRec, LightGCN, graph neural networks.

Graph-Based Models
Sequential

6 models – SASRec, MIND, Caser, NextItNet.

Sequential Models
Bayesian

3 models – BPR, BPRMF, VMF.

Bayesian Models

Quick Example

from corerec.engines.dcn import DCN
from cr_learn import ml_1m
from sklearn.model_selection import train_test_split

# pip install "corerec[datasets]" first
data = ml_1m.load()
train_df, _ = train_test_split(data['ratings'], test_size=0.2, random_state=42)

model = DCN(embedding_dim=64, epochs=20, verbose=True)
model.fit(user_ids=train_df['user_id'].values, item_ids=train_df['movie_id'].values,
          ratings=train_df['rating'].values)

recs = model.recommend(user_id=1, top_k=10)
model.save('artifacts/dcn')

Learn More

Tutorials

Step-by-step tutorials for every model – DCN, DeepFM, SASRec, LightGCN, and 50+ more.

Tutorial Index
User Guide

Data preparation, training, predictions, persistence, and best practices.

Data Preparation
API Reference

Full API documentation for all modules – engines, pipelines, retrieval, ranking, evaluation.

Engines

Index – Module Index – Search Page