Experimental/two stage

.github/workflows/test.yml

@@ -29,10 +29,10 @@ jobs:
         with:
           path: .venv
           key: venv-lint-${{ runner.os }}-${{ hashFiles('**/poetry.lock') }}
-  
+
       - name: Install dependencies
         if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
-        run: make install 
+        run: make install
 
       - name: Static analysis
         run: make lint
@@ -62,10 +62,10 @@ jobs:
         with:
           path: .venv
           key: venv-test-${{ runner.os }}-${{ matrix.python-version }}-${{ hashFiles('**/poetry.lock') }}
-  
+
       - name: Install dependencies
         if: steps.cached-poetry-dependencies.outputs.cache-hit != 'true'
-        run: make install 
+        run: make install
 
       - name: Run tests
         run: make test

.gitignore

@@ -93,3 +93,6 @@ benchmark_results/
 *.zip
 *.csv
 *.dat
+
+# CatBoost
+catboost_info/

CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+
+## Unreleased
+
+### Added
+- Two-stage candidate ranking system with `CandidateRankingModel` and supporting classes (`CandidateGenerator`, `CandidateFeatureCollector`, `Reranker`, `CatBoostReranker`, `PerUserNegativeSampler`) ([#296](https://github.com/MobileTeleSystems/RecTools/pull/296))
+
+
 ## [0.17.0] - 03.09.2025
 
 ### Added

README.md

@@ -98,6 +98,7 @@ The default version doesn't contain all the dependencies, because some of them a
 - `torch`: adds models based on neural nets,
 - `visuals`: adds visualization tools,
 - `nmslib`: adds fast ANN recommenders.
+- `catboost`: adds CatBoost as a reranker for `CandidateRankingModel`
 
 Install extension:
 ```