PHPackages                             adrianmtanase/laravel-vector-store - 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 &amp; ORM](/categories/database)
4. /
5. adrianmtanase/laravel-vector-store

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

adrianmtanase/laravel-vector-store
==================================

Vector store abstraction layer for the Laravel framework.

1.0.1(1y ago)67531MITPHPPHP ^8.1

Since Jan 5Pushed 1y ago1 watchersCompare

[ Source](https://github.com/adrianmtanase/laravel-vector-store)[ Packagist](https://packagist.org/packages/adrianmtanase/laravel-vector-store)[ Docs](https://github.com/adrianmtanase/laravel-vector-store)[ Fund](https://github.com/sponsors/adrianmtanase)[ Fund](https://patreon.com/AdrianTanase443)[ RSS](/packages/adrianmtanase-laravel-vector-store/feed)WikiDiscussions main Synced yesterday

READMEChangelog (8)Dependencies (8)Versions (11)Used By (1)

Vector database store for Laravel
=================================

[](#vector-database-store-for-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/c2470719ea21a735e87752bc7fc6ea294f46af82e0e24216fa5744f921ffec66/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f61647269616e6d74616e6173652f6c61726176656c2d766563746f722d73746f72652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/adrianmtanase/laravel-vector-store)[![GitHub Tests Action Status](https://camo.githubusercontent.com/90315af91f05afdf4fd25ea412dab15a4f566c3c713182799c6f8c7d76ff230e/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f61647269616e6d74616e6173652f6c61726176656c2d766563746f722d73746f72652f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/adrianmtanase/laravel-vector-store/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/8ed216ee78b438e5b10de602c0851c2281712909321031e7fd75e59661683328/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f61647269616e6d74616e6173652f6c61726176656c2d766563746f722d73746f72652f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/adrianmtanase/laravel-vector-store/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/bbbcecf517664fbad4ff5fdd8aabfc15438310536467a38bae56a8e3a33cbeaf/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f61647269616e6d74616e6173652f6c61726176656c2d766563746f722d73746f72652e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/adrianmtanase/laravel-vector-store)

This package provides an implementation of multiple vector databases (e.g. [Pinecone.io](https://www.pinecone.io/)).

Support us
----------

[](#support-us)

If this helped you, consider supporting my development over on [Patreon](https://patreon.com/AdrianTanase443) or on [Github](https://github.com/sponsors/adrianmtanase).

### Installation

[](#installation)

`Requires PHP ^8.1`

```
composer require adrianmtanase/laravel-vector-store
```

### Currently supports

[](#currently-supports)

- [Pinecone.io](https://www.pinecone.io/)
- [Weaviate](https://github.com/timkley/weaviate-php)

### Plans to implement

[](#plans-to-implement)

- [MySql](https://planetscale.com/blog/planetscale-is-bringing-vector-search-and-storage-to-mysql) - once it's ready

### ❗ If you're coming from version 0.0.25 ❗

[](#-if-youre-coming-from-version-0025-)

- Coming from version `0.0.25` you'll have to re-publish the config, as the Pinecone environment variable has been replaced with `pinecone_host`

```
php artisan vendor:publish
```

### Usage

[](#usage)

Using the `VectorStore` facade, you can easily access any provider and execute operations.

[![Pinecone indexes](documentation/pinecone_indexes.png "Pinecone indexes")](documentation/pinecone_indexes.png)

```
VectorStore::instance()
           ->namespace('general')
           ->upsert(
               PineconeUpsertRequest::build()
                   ->id('1')
                   ->values([
                       -0.002739503,
                       -0.01970483,
                       -0.011307885,
                       -0.011125952,
                       -0.023119587,
                       0.0016207852,
                       -0.003981551,
                       -0.029249357,
                       0.00983842,
                       -0.023721369
                   ])
                   ->metadata([
                       'text' => 'Vector store is lit!'
                   ])
           );
```

The default provider is `Pinecone.io`, this can be easily switched using the facade `VectorStore::provider(VectorStoreProviderType::PINECONE)`, or directly in the `vector-store` [config](https://github.com/adrianmtanase/laravel-vector-store/blob/main/config/vector-store.php).

### Weaviate

[](#weaviate)

As Weaviate runs through GraphQL, the query language is complex. There are several useful methods in `WeaviateQueryRequest` that will help you query data more efficiently. For example:

```
VectorStore::provider(VectorStoreProviderType::WEAVIATE)
           ->instance()
           ->namespace('general')
           ->query(
               WeaviateQueryRequest::build()
                   ->vector([
                       -0.002739503,
                       -0.01970483,
                       -0.011307885,
                       -0.011125952,
                       -0.023119587,
                       0.0016207852,
                       -0.003981551,
                       -0.029249357,
                       0.00983842,
                       -0.023721369
                   ])
                   ->properties(['text'])
                   ->withId()
                   ->withParameters(WeaviateQueryParameters::build()->group('type: closest, force: 1'))
           );
```

As the system is complex, the package also supports a `rawQuery` form, or even getting access to the underlying client.

#### Weaviate raw query

[](#weaviate-raw-query)

```
VectorStore::provider(VectorStoreProviderType::WEAVIATE)
           ->instance()
           ->namespace('general')
           ->rawQuery('
               {
                Get {
                  General(nearVector: {
                    vector: [
                        -0.002739503,
                       -0.01970483,
                       -0.011307885,
                       -0.011125952,
                       -0.023119587,
                       0.0016207852,
                       -0.003981551,
                       -0.029249357,
                       0.00983842,
                       -0.023721369
                    ]
                  }) {
                    text
                  }
                }
            }
           ');
```

#### Underlying Weaviate client

[](#underlying-weaviate-client)

```
VectorStore::provider(VectorStoreProviderType::WEAVIATE)
           ->instance()
           ->client()
           ->batchDelete('general')
```

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance31

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 96.7% 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 ~26 days

Recently: every ~42 days

Total

8

Last Release

727d ago

Major Versions

0.0.25 → 1.0.12024-07-07

PHP version history (2 changes)0.0.1PHP ^8.2

0.0.22PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/dab06e0a2249864956960db0315ea60f1d5aa545ec30ea6564dd551905f991da?d=identicon)[adrianmtanase](/maintainers/adrianmtanase)

---

Top Contributors

[![adrianmtanase](https://avatars.githubusercontent.com/u/153947873?v=4)](https://github.com/adrianmtanase "adrianmtanase (29 commits)")[![tntsoft](https://avatars.githubusercontent.com/u/5844176?v=4)](https://github.com/tntsoft "tntsoft (1 commits)")

---

Tags

phplaravelaivectorstoreweaviateadrianadrian tanaseadrianmtanase

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/adrianmtanase-laravel-vector-store/health.svg)

```
[![Health](https://phpackages.com/badges/adrianmtanase-laravel-vector-store/health.svg)](https://phpackages.com/packages/adrianmtanase-laravel-vector-store)
```

###  Alternatives

[wnx/laravel-backup-restore

A package to restore database backups made with spatie/laravel-backup.

213421.0k2](/packages/wnx-laravel-backup-restore)[halilcosdu/laravel-slower

Laravel Slower: Optimize Your DB Queries with AI

41026.2k](/packages/halilcosdu-laravel-slower)[lacodix/laravel-model-filter

A Laravel package to filter, search and sort models with ease while fetching from database.

17558.6k](/packages/lacodix-laravel-model-filter)[relaticle/custom-fields

User Defined Custom Fields for Laravel Filament

16354.2k](/packages/relaticle-custom-fields)[helgesverre/chromadb

PHP Client for the Chromadb Rest API

321.5k](/packages/helgesverre-chromadb)[helgesverre/milvus

PHP Client for the Milvus Rest API

327.2k](/packages/helgesverre-milvus)

PHPackages © 2026

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