Getting Started

This guide walks you through installing XVector and running your first vector search.

Prerequisites

  • Ubuntu 24.04
  • XCENA SDK — PXL runtime for device offloading

Installation

Download the release tarball and run the included setup script:

wget https://github.com/xcena-dev/public-xvector-suite/releases/download/release-1775552577/xvector-suite-0.1.2-dist.tar.gz
tar xzf xvector-suite-0.1.2-dist.tar.gz
cd xvector-suite-0.1.2
./setup.sh

Manual Installation

The tarball contains individual .deb packages that can be installed directly:

sudo dpkg -i libxvector-dev_0.1.2_amd64.deb

libxvector-dev installs:

Path Contents
/opt/xvector/include/xvector/ Public C headers
/opt/xvector/include/xvector_cpp/ C++ convenience wrapper headers
/opt/xvector/lib/ libxvector.a static library and CMake config
/opt/xvector/bin/ Device kernel binary (xvector_kernel.mubin)

Next Steps

  • XFaiss — Faiss drop-in replacement with MU acceleration
  • Examples — KNN exact search with the XVector C API