PHPackages                             claudiogs16/laravel-sdk-qdrant - 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. [Database & ORM](/categories/database)
4. /
5. claudiogs16/laravel-sdk-qdrant

ActiveLibrary[Database & ORM](/categories/database)

claudiogs16/laravel-sdk-qdrant
==============================

Laravel SDK for Qdrant vector database — search, upsert, collections, payload management with OpenAI, Gemini and OpenRouter embedders

v1.1.0(2mo ago)011MITPHPPHP ^8.2

Since May 17Pushed 2mo agoCompare

[ Source](https://github.com/claudiogs16/laravel-sdk-qdrant)[ Packagist](https://packagist.org/packages/claudiogs16/laravel-sdk-qdrant)[ Docs](https://github.com/claudiogs16/laravel-sdk-qdrant)[ RSS](/packages/claudiogs16-laravel-sdk-qdrant/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (4)Versions (3)Used By (0)

Laravel SDK for Qdrant
======================

[](#laravel-sdk-for-qdrant)

[![Latest Version on Packagist](https://camo.githubusercontent.com/18623ecdec2532c41b9e1bad0b5056c3b00ce4384d3be373be751fe32b5253ca/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636c617564696f677331362f6c61726176656c2d73646b2d716472616e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/claudiogs16/laravel-sdk-qdrant)[![License](https://camo.githubusercontent.com/74c231625b433fbfd17b1e23c20bd669318c18d23d9e049c852abb4b6609ee32/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f636c617564696f677331362f6c61726176656c2d73646b2d716472616e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/claudiogs16/laravel-sdk-qdrant)[![PHP Version](https://camo.githubusercontent.com/b502650043850ae2ce404a05d942aef20c72c3208840782433846b8c0a54476b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f636c617564696f677331362f6c61726176656c2d73646b2d716472616e742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/claudiogs16/laravel-sdk-qdrant)[![Laravel](https://camo.githubusercontent.com/1ff150d2f7bd167cba66414811a10f2ce5a22ffb30ef984c96688381d51dfd7a/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31312e7825323025374325323031322e7825323025374325323031332e782d7265643f7374796c653d666c61742d737175617265)](https://laravel.com)

Laravel SDK for [Qdrant](https://qdrant.tech) vector database. Supports collection management, point operations (upsert, search, scroll, recommend, count), payload manipulation, index management, and vector embedding via OpenAI, Gemini, and OpenRouter.

> Forked from [wontonee/laravel-qdrant-sdk](https://github.com/wontonee/laravel-qdrant-sdk) with compatibility for Laravel 11, 12, and 13, re-namespaced to `Claudiogs16\LarQ`, and added OpenRouter embedder support.

---

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

[](#installation)

```
composer require claudiogs16/laravel-sdk-qdrant
```

Laravel auto-discovers the service provider. Publish the config:

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

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

[](#configuration)

Add to your `.env`:

```
LARQ_HOST=http://localhost:6333
LARQ_API_KEY=

# OpenAI
OPENAI_API_KEY=sk-...
OPENAI_MODEL=text-embedding-3-small

# Gemini
GEMINI_API_KEY=
GEMINI_MODEL=models/embedding-001

# OpenRouter (OpenAI-compatible API)
OPENROUTER_API_KEY=sk-or-v1-...
OPENROUTER_MODEL=openai/text-embedding-3-small
# OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
```

The published config is at `config/larq.php`.

Usage
-----

[](#usage)

### Client

[](#client)

```
use Claudiogs16\LarQ\Qdrant\Client;

$client = new Client();

// Raw HTTP calls
$response = $client->get('/collections');
$response = $client->put('/collections/my-collection', [...]);
$response = $client->post('/collections/my-collection/points/search', [...]);
```

### Collections

[](#collections)

```
use Claudiogs16\LarQ\Qdrant\Collections\CreateCollection;
use Claudiogs16\LarQ\Qdrant\Collections\ListCollections;
use Claudiogs16\LarQ\Qdrant\Collections\GetCollection;
use Claudiogs16\LarQ\Qdrant\Collections\UpdateCollection;
use Claudiogs16\LarQ\Qdrant\Collections\DeleteCollection;

CreateCollection::make()->handle('my-collection', [
    'vectors' => ['size' => 1536, 'distance' => 'Cosine'],
]);

$collections = ListCollections::make()->handle();
$info = GetCollection::make()->handle('my-collection');
```

### Points

[](#points)

```
use Claudiogs16\LarQ\Qdrant\Points\UpsertPoints;
use Claudiogs16\LarQ\Qdrant\Points\SearchPoints;
use Claudiogs16\LarQ\Qdrant\Points\ScrollPoints;
use Claudiogs16\LarQ\Qdrant\Points\CountPoints;
use Claudiogs16\LarQ\Qdrant\Points\DeletePoints;
use Claudiogs16\LarQ\Qdrant\Points\RecommendPoints;

// Upsert
UpsertPoints::make()->handle('my-collection', [
    [
        'id' => 1,
        'vector' => [0.1, 0.2, ...],
        'payload' => ['title' => 'Document 1'],
    ],
]);

// Search
$results = SearchPoints::make()->handle('my-collection', [
    'vector' => [0.1, 0.2, ...],
    'limit' => 10,
]);

// Count
$count = CountPoints::make()->handle('my-collection');
```

### Payload

[](#payload)

```
use Claudiogs16\LarQ\Qdrant\Payload\SetPayload;
use Claudiogs16\LarQ\Qdrant\Payload\DeletePayload;
use Claudiogs16\LarQ\Qdrant\Payload\ClearPayload;
```

### Indexes

[](#indexes)

```
use Claudiogs16\LarQ\Qdrant\Index\CreateIndex;
use Claudiogs16\LarQ\Qdrant\Index\DeleteIndex;
```

### Vectors

[](#vectors)

```
use Claudiogs16\LarQ\Qdrant\Vectors\DeleteVector;
```

### Embedders

[](#embedders)

```
use Claudiogs16\LarQ\Embedders\OpenAIEmbedder;
use Claudiogs16\LarQ\Embedders\GeminiEmbedder;
use Claudiogs16\LarQ\Embedders\OpenRouterEmbedder;

// OpenAI
$embedder = new OpenAIEmbedder();
$vector = $embedder->embed('Some text to embed');

// Gemini
$gemini = new GeminiEmbedder();
$vector = $gemini->embed('Some text to embed');

// OpenRouter
$openrouter = new OpenRouterEmbedder();
$vector = $openrouter->embed('Some text to embed');
```

### Eloquent Trait

[](#eloquent-trait)

```
use Claudiogs16\LarQ\Traits\HasVectors;

class Document extends Model
{
    use HasVectors;

    // Optional overrides:
    protected function getVectorText(): string { ... }
    protected function getVectorPayload(): array { ... }
    protected function getVectorId(): string|int { ... }
    protected function getVectorCollection(): string { ... }
    protected function getEmbedder(): EmbedderInterface { ... }
}

$document->upsertToQdrant();
```

Testing
-------

[](#testing)

```
composer test
```

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

[](#requirements)

- PHP 8.2+
- Laravel 11.x | 12.x | 13.x

License
-------

[](#license)

MIT

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance86

Actively maintained with recent releases

Popularity6

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

68d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/15698258?v=4)[claudiogs16](/maintainers/claudiogs16)[@claudiogs16](https://github.com/claudiogs16)

---

Tags

laravelopenaiGeminisimilarity-searchembeddingsqdrantvector-databasevector-searchlaravel-qdrant

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/claudiogs16-laravel-sdk-qdrant/health.svg)

```
[![Health](https://phpackages.com/badges/claudiogs16-laravel-sdk-qdrant/health.svg)](https://phpackages.com/packages/claudiogs16-laravel-sdk-qdrant)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3345.3M347](/packages/psalm-plugin-laravel)[api-platform/laravel

API Platform support for Laravel

58174.6k17](/packages/api-platform-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)