ossycodes/laravel-scout-upstash-search

A Laravel Scout engine for Upstash Search

v1.0.0 2026-08-07 19:20 UTC

Requires

• php: ^8.1
• guzzlehttp/guzzle: ^7.0
• laravel/scout: ^9.0 || ^10.0 || ^11.0

Requires (Dev)

• orchestra/testbench: ^8.0 || ^9.0
• phpunit/phpunit: ^10.0 || ^11.0

MIT

• search
• semantic
• laravel
• vector
• ai
• scout
• upstash

Published on Packagist.org on 2026-08-08 08:06 UTC

README

A Laravel Scout driver for Upstash Search.

Installation

composer require laravel-upstash-search/laravel-scout-upstash-search

Configuration

Add your Upstash Search credentials to your .env:

UPSTASH_SEARCH_URL=https://your-search-url
UPSTASH_SEARCH_TOKEN=your-upstash-token

Publish the config file:

php artisan vendor:publish --provider="LaravelUpstashSearch\Scout\UpstashSearchServiceProvider" --tag="config"

Setup

Configure your model to use the Upstash driver:

use Laravel\Scout\Searchable;

class Post extends Model
{
    use Searchable;

    protected $searchableAs = 'posts';

    public function toSearchableArray()
    {
        return [
            'title' => $this->title,
            'body' => $this->body,
        ];
    }
}

Update config/scout.php:

'driver' => env('SCOUT_DRIVER', 'upstash'),

Usage

// Search
$results = Post::search('laravel')->get();

// Paginate
$results = Post::search('laravel')->paginate(15);

// Import all records
php artisan scout:upstash-import "App\Models\Post"

Documentation

For more information on Upstash Search, visit the Upstash Search Documentation.

License

MIT