PHPackages                             amranidev/laracombee - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. amranidev/laracombee

ActiveLaravel-package[Utility & Helpers](/categories/utility)

amranidev/laracombee
====================

Recommendation system for laravel

v0.3.1(2mo ago)11538.8k—4.2%91MITPHPPHP ^8.2CI passing

Since Nov 1Pushed 2mo ago4 watchersCompare

[ Source](https://github.com/amranidev/laracombee)[ Packagist](https://packagist.org/packages/amranidev/laracombee)[ RSS](/packages/amranidev-laracombee/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (10)Dependencies (10)Versions (25)Used By (1)

 [![Laracombee](https://camo.githubusercontent.com/d15744fcdf512c9cf02012f49402004aac7d35fe31bf54c642387ae90d84a33a/68747470733a2f2f692e696d6775722e636f6d2f4a4f4e6a6b33372e6a7067)](https://camo.githubusercontent.com/d15744fcdf512c9cf02012f49402004aac7d35fe31bf54c642387ae90d84a33a/68747470733a2f2f692e696d6775722e636f6d2f4a4f4e6a6b33372e6a7067)

 [ ![StyleCI](https://camo.githubusercontent.com/6c098c531bc232c9f5214b2978397da8b7496b15b27b62248d7054ad1eb21203/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3134343333373532332f736869656c643f6272616e63683d6d6173746572) ](https://github.styleci.io/repos/144337523) [ ![Build Status](https://github.com/amranidev/laracombee/actions/workflows/tests.yml/badge.svg) ](https://github.com/amranidev/laracombee/actions/workflows/tests.yml) [ ![Latest Stable Version](https://camo.githubusercontent.com/495be491f8b3e3d352977eff62832f0a2135a66ccd191201c51012aee1970491/68747470733a2f2f706f7365722e707567782e6f72672f616d72616e696465762f6c617261636f6d6265652f762f737461626c65) ](https://packagist.org/packages/amranidev/laracombee) [ ![License](https://camo.githubusercontent.com/cf7e35276195894f77ee6ea0ddf9d9c1f9811edfcd0ce384eeba906707424021/68747470733a2f2f706f7365722e707567782e6f72672f616d72616e696465762f6c617261636f6d6265652f6c6963656e7365) ](https://packagist.org/packages/amranidev/laracombee) [ ![Laravel](https://camo.githubusercontent.com/5dc33dc453936987e8423b2e93ebdb1955ecc7187cc664824ca4a957aecb85c2/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6275696c74253230666f722d6c61726176656c2d626c75652e737667) ](https://laravel.com)

Laracombee
==========

[](#laracombee)

Laracombee is a Laravel package for the [Recombee](https://www.recombee.com/) recommendation API. It provides a simple Laravel-friendly interface for working with users, items, user-item interactions, and recommendations.

This package is useful for applications such as e-commerce platforms, media libraries, and marketplaces where personalized recommendations can improve engagement and retention.

What is Recombee?
-----------------

[](#what-is-recombee)

Recombee is an AI-powered recommendation service with a REST API and SDKs for building personalized recommendation systems.

To learn more about how Recombee works, see the official documentation:

- [Recombee API documentation](https://docs.recombee.com/api.html)

Requirements
------------

[](#requirements)

- PHP 8.2 or later
- Laravel 10, 11, or 12

Installation
------------

[](#installation)

Install the package with Composer:

```
composer require amranidev/laracombee
```

Laravel package discovery will register the service provider automatically.

If you want to publish the configuration file, run:

```
php artisan vendor:publish --tag=laracombee-config
```

Then add your Recombee database ID and private token to `config/laracombee.php`.

Configuration
-------------

[](#configuration)

Set your default user and item models in `config/laracombee.php`:

```
'user' => \App\Models\User::class,
'item' => \App\Models\Book::class,
```

These classes are used by the package commands.

You can also configure:

- `protocol`: the HTTP protocol used for requests. The default is `http`.
- `timeout`: the default request timeout in milliseconds. The default is `2000`.
- `region`: the Recombee region. The default is `eu-west`.

Defining Recombee Properties
----------------------------

[](#defining-recombee-properties)

Each model that should be synchronized with Recombee must define a static `$laracombee` property.

```