Gorse v0.5.4

Features

• Add OpenAI configuration environment variables (#1159).

Fix

• Fetch from recommender if no ranker (#1156).
• Fix GetUserFeedback on ClickHouse with HAVING clause (#1157).
• Fix failed to verify certificate in Docker images (#1161).

Gorse v0.5.3

Features

• Support large language model based ranker (#1129).
• Support RecFlow without ranker node (#1148).
• Support external recommender in RecFlow (#1146).
• Support start master without config file (#1150).
• Add Azure Blob Storage support (#1152).

Fix

• Delete stale recommendations from cache before setting new ones (#1145).

BREAK CHANGES

• Type of collaborative filtering is required.

[recommend.collaborative]

# The type of collaborative filtering. Supported values:
#   none: disable collaborative filtering.
#   mf: matrix factorization.
type = "mf"

Gorse v0.5.2

Features

• Restart task after data imported automatically (#1130).
• Support edit recommend pipeline via LogicFlow (#1131).
• Support offset and user-id on latest items API (#1136).
• Support return recommendation scores by X-API-Version: 2 header (#1140).
• Add MySQL connection pool configuration (#1141) by @slaout.
• Add Postgres connection pool configuration (#1142) by @slaout.
• Support multimodal click-throught rate prediction via embedding (#1134).
• Support disable optimize by set optimize_period = "0" (#1144).

BREAK CHANGES

• Ranker type is required in the config file otherwise no ranker will be used.

[recommend.ranker]

# The type of the ranker. There are two types:
#   none: no ranking (default).
#   fm: factorization machines.
type = "fm"

Gorse v0.5.1

Fix

• Fix blob client init (#1128).

Gorse v0.5.0

Features

• Support Google Cloud Storage (#1123).

Fix

• Fix typo of return type in API docs (#1108).
• Fix GET user neighbors APIs (#1110).

BREAK CHANGES

• Add last updated timestamp to feedback (#1114).
• Add fit and optimize config to [recommend.ranker] (#1124).

Upgrade Guide: Gorse v0.5 Has been Released

Gorse v0.5.0-rc

Warning This is a release candidate version of the Gorse recommender system. It means:

1. Don't use the pre-release version in production unless you can afford the risks.
2. APIs, configurations, and data storage might be changed between pre-release versions.
3. Clear local caches and cache databases after the upgrade.

Fix

• Remove feedback overwrite support in ClickHouse (#1103).
• Fix decode empty categories from Redis (#1104).
• Add readiness check endpoint on workers (#1105).
• Fix zero datetime value on MySQL (#1106).

Gorse v0.5.0-alpha.8

Warning This is a pre-release version of the Gorse recommender system. It means:

1. Don't use the pre-release version in production unless you can afford the risks.
2. APIs, configurations, and data storage might be changed between pre-release versions.
3. Clear local caches and cache databases after the upgrade.

Performance

• Fix CPU contention of gorse-in-one (#1092).
• Cache items for workers on demand (#1093).
• Skip cold-start users in offline recommendation (#1095).

Fix

• Add non-persoanlized recommendation digest (#1086).
• Return zero values instead of errors when cache values don't exist (#1088).
• Fix import feedback with value (#1090).

BREAK CHANGES

• Implement new multi-way ranker (#1077).
• Convert euclidean distance to similarity (#1091).
• Load playground data from binary dump (#1100).

Gorse v0.5.0-alpha.7

Warning This is a pre-release version of the Gorse recommender system. It means:

1. Don't use the pre-release version in production unless you can afford the risks.
2. APIs, configurations, and data storage might be changed between pre-release versions.
3. Clear local caches and cache databases after the upgrade.

Features

• Implement external recommenders (#1068).
• Support early stop training (#1074).
• Sort user feedback by timestamp on dashboard (#1076).

Performance

• Support OpenBLAS by default (#1066).
• Release dataset after training (#1075).
• Get latest items from database instead of cache (#1078).

Fix

• Fix panic on loading empty dataset (#1069).
• Fix PostgreSQL initialization by downgrading gorm (#1071).

BREAK CHANGES

• Remove useless Subscribe field of User (#1072).
• Remove popular recommender (#1080).

Gorse v0.5.0-alpha.6

Warning This is a pre-release version of the Gorse recommender system. It means:

1. Don't use the pre-release version in production unless you can afford the risks.
2. APIs, configurations, and data storage might be changed between pre-release versions.
3. Clear local caches and cache databases after the upgrade.

Performance

• Dump matrix factorization to HNSW index (#1051).
• Optimze hyperparameter via optuna (#1002).
• Release memory of models after dump (#1053).
• Support Intel® OneAPI Math Kernel Library (#1058).

Fix

• Fix user-to-user recommendation preview (#1054).

Gorse v0.5.0-alpha.5

Warning This is a pre-release version of the Gorse recommender system. It means:

1. Don't use the pre-release version in production unless you can afford the risks.
2. APIs, configurations, and data storage might be changed between pre-release versions.
3. Clear local caches and cache databases after the upgrade.

Features

• Support Apache Kvrocks (#1034).

Fix

• Fix broken item neighbors API (#1040).
• Fix user avatar in dashboard (#1048).

BREAK CHANGES

• Name workers and servers by hostname and port (#1046).
• Replace /api/intermediate/recommend/* with /api/collaborative-filtering/* (#1047).