PHPackages                             upstash/vector - 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. upstash/vector

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

upstash/vector
==============

An HTTP/REST based Vector DB client built on top of Upstash REST API.

v1.2.0(1y ago)512.3k↑766.7%1[4 PRs](https://github.com/upstash/vector-php/pulls)1MITPHPPHP ^8.3CI passing

Since Jan 14Pushed 3mo ago6 watchersCompare

[ Source](https://github.com/upstash/vector-php)[ Packagist](https://packagist.org/packages/upstash/vector)[ Docs](https://github.com/upstash/vector-php)[ RSS](/packages/upstash-vector/feed)WikiDiscussions master Synced yesterday

READMEChangelog (10)Dependencies (15)Versions (27)Used By (1)

Vector Client SDK for PHP
=========================

[](#vector-client-sdk-for-php)

[![Latest Version on Packagist](https://camo.githubusercontent.com/9d4925512d9cfb44d3db6c092208bded496c89bf8621bdbdc5b8ad275078af01/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f757073746173682f766563746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/upstash/vector)[![Tests](https://camo.githubusercontent.com/65741774e794f8ace04d3421e7b9ecad3b5665c89ad1bb3190d2a9f6f460b8c1/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f757073746173682f766563746f722d7068702f72756e2d74657374732e796d6c3f6272616e63683d6d6173746572266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/upstash/vector-php/actions/workflows/run-tests.yml)[![Total Downloads](https://camo.githubusercontent.com/f1ca348c56b99390408e0a2f2ccd7f07921d19a5982d06fa27e16152e871b630/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f757073746173682f766563746f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/upstash/vector)

Upstash Vector is an HTTP serverless Vector Database.

You can store, query, and retrieve vectors from your application, use it to power your search, and more.

You can read more about Upstash Vector [here](https://docs.upstash.com/vector).

Quick Start
-----------

[](#quick-start)

### Installation

[](#installation)

You can install the package via composer:

```
composer require upstash/vector
```

### Create Index

[](#create-index)

Create a new index on [Upstash](https://console.upstash.com/vector)

Usage
-----

[](#usage)

### Initialize the index

[](#initialize-the-index)

```
use Upstash\Vector\Index;

// Initialize the index
$index = new Index(
    url: 'UPSTASH_VECTOR_REST_URL',
    token: 'UPSTASH_VECTOR_REST_TOKEN',
);

// or just to use the environment variables
$index = Index::fromEnv();
```

### Upserting Vectors

[](#upserting-vectors)

```
use Upstash\Vector\Index;
use Upstash\Vector\VectorUpsert;

use function Upstash\Vector\createRandomVector;

$index = new Index(
    url: 'UPSTASH_VECTOR_REST_URL',
    token: 'UPSTASH_VECTOR_REST_TOKEN',
);

$index->upsert(new VectorUpsert(
    id: 'upstash-rocks',
    vector: createRandomVector(dimensions: 1536),
    metadata: ['field' => 'value'],
));
```

### Upserting Data with Embedding Models

[](#upserting-data-with-embedding-models)

```
use Upstash\Vector\Index;
use Upstash\Vector\DataUpsert;

$index = new Index(
    url: 'UPSTASH_VECTOR_REST_URL',
    token: 'UPSTASH_VECTOR_REST_TOKEN',
);

$index->upsertData(new DataUpsert(
    id: 'upstash-vector',
    data: 'Upstash Vector is a serverless vector database.',
    metadata: ['field' => 'value'],
));
```

### Querying Vectors

[](#querying-vectors)

```
use Upstash\Vector\Index;
use Upstash\Vector\VectorQuery;

use function Upstash\Vector\createRandomVector;

$index = new Index(
    url: 'UPSTASH_VECTOR_REST_URL',
    token: 'UPSTASH_VECTOR_REST_TOKEN',
);

$index->query(new VectorQuery(
    vector: createRandomVector(dimensions: 1536),
    topK: 5,
));
```

### Querying Data with Embedding Models

[](#querying-data-with-embedding-models)

```
use Upstash\Vector\Index;
use Upstash\Vector\DataQuery;

$index = new Index(
    url: 'UPSTASH_VECTOR_REST_URL',
    token: 'UPSTASH_VECTOR_REST_TOKEN',
);

$index->queryData(new DataQuery(
    data: 'What is Upstash Vector?',
    topK: 5,
));
```

### Fetch specific vectors

[](#fetch-specific-vectors)

```
use Upstash\Vector\Index;
use Upstash\Vector\VectorFetch;

$index = new Index(
    url: 'UPSTASH_VECTOR_REST_URL',
    token: 'UPSTASH_VECTOR_REST_TOKEN',
);

$index->fetch(new VectorFetch(ids: ['upstash-rocks']));
```

### Delete specific vectors

[](#delete-specific-vectors)

```
use Upstash\Vector\Index;

$index = new Index(
    url: 'UPSTASH_VECTOR_REST_URL',
    token: 'UPSTASH_VECTOR_REST_TOKEN',
);

$index->delete(['upstash-rocks']);
```

Namespaces
----------

[](#namespaces)

Upstash Vector allows you to partition a single index into multiple isolated namespaces. Each namespace functions as a self-contained subset of the index, in which read and write requests are only limited to one namespace. To learn more about it, [see Namespaces](https://upstash.com/docs/vector/features/namespaces).

### Example

[](#example)

```
use Upstash\Vector\Index;
use Upstash\Vector\VectorUpsert;

use function Upstash\Vector\createRandomVector;

$index = new Index(
    url: 'UPSTASH_VECTOR_REST_URL',
    token: 'UPSTASH_VECTOR_REST_TOKEN',
);

// Upsert to namespace
$index->namespace('books')->upsert(new VectorUpsert(
    id: 'upstash-rocks',
    vector: createRandomVector(dimensions: 1536),
    metadata: ['field' => 'value'],
));
```

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

[](#troubleshooting)

We have a [Discord](upstash.com/discord) for common problems. If you can't find a solution, please [open an issue](https://github.com/upstash/vector-js/issues/new).

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

###  Health Score

48

—

FairBetter than 93% of packages

Maintenance64

Regular maintenance activity

Popularity33

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 88% 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 ~3 days

Total

14

Last Release

486d ago

Major Versions

v0.2.1 → v1.0.02025-02-05

### Community

Maintainers

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

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

---

Top Contributors

[![heyjorgedev](https://avatars.githubusercontent.com/u/2780099?v=4)](https://github.com/heyjorgedev "heyjorgedev (81 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (5 commits)")[![CahidArda](https://avatars.githubusercontent.com/u/57228345?v=4)](https://github.com/CahidArda "CahidArda (1 commits)")

---

Tags

aiphpsdksdk-phpsemantic-searchupstashupstash-vectorvectorvector-databasephpsdkaivectorragupstash

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/upstash-vector/health.svg)

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

###  Alternatives

[telnyx/telnyx-php

Official Telnyx PHP SDK — APIs for Voice, SMS, MMS, WhatsApp, Fax, SIP Trunking, Wireless IoT, Call Control, and more. Build global communications on Telnyx's private carrier-grade network.

35789.4k2](/packages/telnyx-telnyx-php)[openai-php/client

OpenAI PHP is a supercharged PHP API client that allows you to interact with the Open AI API

5.8k28.0M318](/packages/openai-php-client)[anthropic-ai/sdk

Anthropic PHP SDK

163583.3k17](/packages/anthropic-ai-sdk)[n1ebieski/ksef-php-client

PHP API client that allows you to interact with the API Krajowego Systemu e-Faktur

9067.8k](/packages/n1ebieski-ksef-php-client)[trycourier/courier

Courier PHP SDK

15660.9k](/packages/trycourier-courier)[getbrevo/brevo-php

Official Brevo provided RESTFul API V3 php library

1003.9M50](/packages/getbrevo-brevo-php)

PHPackages © 2026

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