PHPackages                             wontonee/laravel-qdrant-sdk - 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. wontonee/laravel-qdrant-sdk

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

wontonee/laravel-qdrant-sdk
===========================

Laravel SDK for Qdrant vector database with embedders like OpenAI and Gemini

1.0.1(1y ago)3125MITPHPPHP ^8.1

Since May 27Pushed 1y agoCompare

[ Source](https://github.com/wontonee/laravel-qdrant-sdk)[ Packagist](https://packagist.org/packages/wontonee/laravel-qdrant-sdk)[ RSS](/packages/wontonee-laravel-qdrant-sdk/feed)WikiDiscussions main Synced today

READMEChangelog (2)Dependencies (2)Versions (3)Used By (0)

Laravel Qdrant SDK: Qdrant Vector Database Integration for Laravel
==================================================================

[](#laravel-qdrant-sdk-qdrant-vector-database-integration-for-laravel)

Laravel Qdrant SDK is a Laravel package that provides a simple, expressive interface for working with the Qdrant vector database. It supports collection management, vector upserts, similarity search, and integration with embedders like OpenAI and Gemini.

Features
--------

[](#features)

- Create, update, delete, and list Qdrant collections
- Upsert and manage vector points
- Perform similarity search and recommendations
- Easily integrate with OpenAI or Gemini for vector embeddings
- Simple trait for adding vector support to Eloquent models

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

[](#installation)

1. **Require the package:**

    ```
    composer require wontonee/laravel-qdrant-sdk
    ```
2. **Publish the config:**

    ```
    php artisan vendor:publish --provider="Wontonee\LarQ\Providers\LarQServiceProvider" --tag=larq-config
    ```
3. **Set your .env variables:**

    ```
    LARQ_HOST=http://localhost:6333
    LARQ_API_KEY=
    OPENAI_API_KEY=sk-...
    OPENAI_MODEL=text-embedding-ada-002
    GEMINI_API_KEY=...
    GEMINI_MODEL=models/embedding-001
    ```
4. **Run Qdrant with persistent storage (recommended for local dev):**

    ```
    docker run -p 6333:6333 -v $(pwd)/qdrant_storage:/qdrant/storage qdrant/qdrant
    ```

Usage
-----

[](#usage)

### Creating a Collection

[](#creating-a-collection)

```
use Wontonee\LarQ\Qdrant\Collections\CreateCollection;

$vectorParams = [
    'size' => 3,
    'distance' => 'Cosine',
];
$response = (new CreateCollection())->handle('my_collection', $vectorParams);
```

### Upserting Points

[](#upserting-points)

```
use Wontonee\LarQ\Qdrant\Points\UpsertPoints;

$points = [
    [
        'id' => 1,
        'vector' => [0.1, 0.2, 0.3],
        'payload' => ['label' => 'A'],
    ],
];
$response = (new UpsertPoints())->handle('my_collection', $points);
```

### Scrolling Points

[](#scrolling-points)

```
use Wontonee\LarQ\Qdrant\Points\ScrollPoints;
$response = (new ScrollPoints())->handle('my_collection', 10);
```

### Listing All Collections

[](#listing-all-collections)

```
use Wontonee\LarQ\Qdrant\Collections\ListCollections;
$response = (new ListCollections())->handle();
```

### Using the HasVectors Trait

[](#using-the-hasvectors-trait)

Add vector support to your Eloquent model:

```
use Wontonee\LarQ\Traits\HasVectors;

class Product extends Model {
    use HasVectors;
    // Optionally override vectorText(), vectorPayload(), etc.
}
```

### Example Controller Test

[](#example-controller-test)

See `QdrantDemoController` for a full example of creating a collection, upserting points, and listing them.

Troubleshooting
---------------

[](#troubleshooting)

- **Data disappears after restart:** Make sure Qdrant is running with persistent storage (see above).
- **Connection issues:** Check your `LARQ_HOST` and API key settings in `.env`.

License
-------

[](#license)

MIT

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance46

Moderate activity, may be stable

Popularity17

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

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 ~1 days

Total

2

Last Release

401d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/990964f490e33904da3bcc7f878293090d96ce9f244b4251f3b0b84cf8fc2860?d=identicon)[wontone18](/maintainers/wontone18)

---

Top Contributors

[![wontone18](https://avatars.githubusercontent.com/u/10259774?v=4)](https://github.com/wontone18 "wontone18 (4 commits)")

### Embed Badge

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

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

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[mike-bronner/laravel-model-caching

Automatic caching for Eloquent models.

2.4k91.9k1](/packages/mike-bronner-laravel-model-caching)[illuminate/auth

The Illuminate Auth package.

10528.2M1.2k](/packages/illuminate-auth)[illuminate/routing

The Illuminate Routing package.

1419.2M3.0k](/packages/illuminate-routing)[spatie/laravel-export

Create a static site bundle from a Laravel app

674146.0k6](/packages/spatie-laravel-export)[api-platform/laravel

API Platform support for Laravel

58171.6k14](/packages/api-platform-laravel)

PHPackages © 2026

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