Registry / database / sqlite-vec-linux-arm64

sqlite-vec-linux-arm64

library0.1.9jsnpmunverified

sqlite-vec is a SQLite extension for vector search, providing fast k-nearest neighbor (k-NN) queries directly within SQLite. The current stable version is 0.1.9. It is released as a series of platform-specific packages (Linux ARM64, Linux x86_64, macOS, Windows). Key differentiators: it is lightweight, has zero external dependencies, supports multiple distance metrics (cosine, Euclidean, dot product), and integrates seamlessly via a single SQL function call. This package is for Linux ARM64 systems only; other platforms require a separate distribution.

database ai-ml

npm install sqlite-vec-linux-arm64

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · SQLITE-VEC-LINUX-A

sqlite-vec-linux-arm64

databasejavascriptv0.1.9

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

sqlite_vec_init

✓ const sqlite3 = require('better-sqlite3'); const init = require('sqlite-vec-linux-arm64'); const db = new sqlite3(':memory:'); db.loadExtension(init.path);

✗ require('sqlite-vec-linux-arm64'); // missing loadExtension call

The extension .so file is bundled; you must load it via loadExtension().

Shows loading the extension and performing a vector search query.

const sqlite3 = require('better-sqlite3'); const init = require('sqlite-vec-linux-arm64'); const db = new sqlite3(':memory:'); db.loadExtension(init.path); db.exec('CREATE VIRTUAL TABLE vec_items USING vec0(embedding float[3]);'); db.exec("INSERT INTO vec_items(rowid, embedding) VALUES (1, '[1.0, 2.0, 3.0]');"); const rows = db.prepare("SELECT rowid, distance FROM vec_items WHERE embedding MATCH '[1.0, 2.0, 3.0]' ORDER BY distance LIMIT 5;").all(); console.log(rows);

Debug

Known issues

breakingExtension path may change between versions; always use init.path.

fix

Use init.path exported by the package, not a hardcoded path.

affects: >=0.1.0

deprecatedPre-0.1.0 API used a different function name (sqlite_vec_init not available).

fix

Upgrade to 0.1.0+ and use init.path.

affects: <0.1.0

gotchaThis package only works on Linux ARM64 (aarch64); will fail on x86_64.

fix

Use sqlite-vec-linux-x64 for x86_64 systems.

affects: all

gotchaRequires Node.js with support for better-sqlite3 or another SQLite binding.

fix

Install better-sqlite3 as a peer dependency.

affects: all

Errors

Common errors & fixes

Error: Cannot find module 'sqlite-vec-linux-arm64'

Package not installed or wrong platform package used.

fix

npm install sqlite-vec-linux-arm64 --save

Error: dlopen failed: cannot locate symbol

Extension not loaded via loadExtension() correctly.

fix

const init = require('sqlite-vec-linux-arm64'); db.loadExtension(init.path);

TypeError: db.loadExtension is not a function

Using a SQLite binding that does not support loadExtension.

fix

Use better-sqlite3 or another compatible binding.

Upgrade

Version history

0.1.9latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

21 hits · last 30 days

node