PHPackages                             phpsrprogrammer/bagisto-vector-search - 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. [Search & Filtering](/categories/search)
4. /
5. phpsrprogrammer/bagisto-vector-search

ActiveLibrary[Search & Filtering](/categories/search)

phpsrprogrammer/bagisto-vector-search
=====================================

Open-source semantic (vector) search, autosuggest, and related/up-sell fallback for Bagisto using Qdrant + fastembed (all self-hosted, no paid APIs).

v0.1.0(1mo ago)00MITPHPPHP ^8.2

Since Jul 8Pushed 1mo agoCompare

[ Source](https://github.com/phpsrprogrammer/bagisto-vector-searc)[ Packagist](https://packagist.org/packages/phpsrprogrammer/bagisto-vector-search)[ RSS](/packages/phpsrprogrammer-bagisto-vector-search/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependenciesVersions (2)Used By (0)

Rbk Vector Search for Bagisto
=============================

[](#rbk-vector-search-for-bagisto)

Open-source semantic (vector) search for Bagisto — 100% self-hosted, no paid APIs.

**Stack:** [Qdrant](https://qdrant.tech) (vector DB, Apache-2.0) + [fastembed](https://github.com/qdrant/fastembed) running `BAAI/bge-small-en-v1.5` (ONNX, CPU) as a small local embedding service.

Features
--------

[](#features)

- **Semantic product search** — overrides `ProductRepository::getAll()` for the storefront search box (query is embedded → nearest vectors → results in relevance order, with category/price filters preserved). Falls back to Bagisto's DB search if the vector service is down.
- **Category-grouped autosuggest** — `GET /vector-suggest?query=` returns products grouped by category (name, price, image, attributes) served entirely from the Qdrant payload.
- **Vector-powered related & up-sell** — overrides `/api/products/{id}/related` and `/up-sell`: manual admin relations first, gap filled with vector nearest-neighbours (visibility-filtered).
- **Auto re-index** — listens to `catalog.product.create/update/delete.after`; keeps the index in sync on every product save.

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

[](#requirements)

- Qdrant reachable at `VECTOR_QDRANT_URL` (default `http://127.0.0.1:6333`).
- Embedding service (fastembed FastAPI) at `VECTOR_EMBED_URL` (default `http://127.0.0.1:8500`) exposing `POST /embed {texts, is_query}`.

Install (local package)
-----------------------

[](#install-local-package)

1. Add to root `composer.json` autoload: `"Rbk\\VectorSearch\\": "packages/Rbk/VectorSearch/src"` then `composer dump-autoload`.
2. Register `Rbk\VectorSearch\Providers\VectorSearchServiceProvider::class` in `bootstrap/providers.php`.
3. Add env: ```
    VECTOR_SEARCH_ENABLED=true
    VECTOR_QDRANT_URL=http://127.0.0.1:6333
    VECTOR_EMBED_URL=http://127.0.0.1:8500
    VECTOR_COLLECTION=products
    VECTOR_DIM=384
    VECTOR_LIMIT=80

    ```
4. Create the Qdrant collection (size 384, Cosine), then build the index: ```
    php artisan vector-search:index

    ```

Set `VECTOR_SEARCH_ENABLED=false` to cleanly revert to Bagisto's native search/related.

License
-------

[](#license)

MIT

###  Health Score

34

—

LowBetter than 74% of packages

Maintenance90

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

49d ago

### Community

Maintainers

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

---

Top Contributors

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

---

Tags

qdrantbagistovector-searchsemantic-searchfastembed

### Embed Badge

![Health badge](/badges/phpsrprogrammer-bagisto-vector-search/health.svg)

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

###  Alternatives

[imarc/google-site-search

A PHP Interface to the Google Custom Search API

3011.6k](/packages/imarc-google-site-search)

PHPackages © 2026

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