gridwb/laravel-mem0

Mem0 API for Laravel

1.1.0 2025-11-24 14:22 UTC

Requires

• php: >=8.2
• guzzlehttp/guzzle: ^7.9.0
• illuminate/contracts: ^10.0||^11.0||^12.0
• spatie/laravel-data: ^4.13
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^2.9|^3.0
• laravel/pint: ^1.14
• orchestra/testbench: ^8.22|^9.0|^10.0
• pestphp/pest: ^2.0|^3.0
• pestphp/pest-plugin-laravel: ^2.0|^3.0

MIT

• gridwb

• laravel
• gridwb
• laravel-mem0

README

Laravel Mem0 is a convenient wrapper for interacting with the Mem0 API in Laravel applications.

Table of Contents

• Installation
• Usage
  • Memories Resource
• Testing
• Changelog
• License

Installation

1. Install the package

   composer require gridwb/laravel-mem0

2. Publish the configuration file

   php artisan vendor:publish --tag="mem0-config"

3. Add environment variables

   MEM0_API_URL=https://api.mem0.ai
   MEM0_API_KEY=your-api-key-here

Usage

Memories Resource

add sync

Add memories via a synchronous request:

<?php

use Gridwb\LaravelMem0\Facades\Mem0;

$response = Mem0::memories()->addSync([
    'user_id' => 'alex',
    'messages' => [
        [
            'role' => 'user',
            'content' => '<user-message>',
        ],
        [
            'role' => 'assistant',
            'content' => '<assistant-message>',
        ],
    ],
]);

foreach ($response->memories as $memory) {
    echo $memory->id;
    echo $memory->memory;
    echo $memory->event->value;
}

add async

Add memories via an asynchronous request:

<?php

use Gridwb\LaravelMem0\Facades\Mem0;

$response = Mem0::memories()->addAsync([
    'user_id' => 'alex',
    'messages' => [
        [
            'role' => 'user',
            'content' => '<user-message>',
        ],
        [
            'role' => 'assistant',
            'content' => '<assistant-message>',
        ],
    ],
]);

foreach ($response->memories as $memory) {
    echo $memory->message;
    echo $memory->status->value;
    echo $memory->eventId;
}

search

Search memories request:

<?php

use Gridwb\LaravelMem0\Facades\Mem0;

$response = Mem0::memories()->search([
    'query' => 'What do you know about me?',
    'filters' => [
        'OR' => [
            [
                'user_id' => 'alex',
            ],
            [
                'agent_id' => [
                    'in' => [
                        'travel-assistant',
                        'customer-support',
                    ],
                ],
            ],
        ],
    ],
]);

foreach ($response->memories as $memory) {
    echo $memory->id;
    echo $memory->memory;
    echo $memory->userId;
    // ...
}

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

License

The MIT License (MIT). Please see License File for more information.