Skip to content

Work-in-progress vector search SQLite extension that runs anywhere.

License

Notifications You must be signed in to change notification settings

GrizzZ13/sqlite-vec

 
 

Repository files navigation

sqlite-vec

An extremely small, "fast enough" vector search SQLite extension that runs anywhere! A successor to sqlite-vss

Important

sqlite-vec is a work-in-progress and not ready for general usage! I plan to launch a "beta" version in the next month or so. Watch this repo for updates, and read this blog post for more info.

  • Store and query float, int8, and binary vectors in vec0 virtual tables
  • Pre-filter vectors with rowid IN (...) subqueries
  • Written in pure C, no dependencies, runs anywhere SQLite runs (Linux/MacOS/Windows, in the browser with WASM, Raspberry Pis, etc.)

Sample usage

.load ./vec0

create virtual table vec_examples using vec0(
  sample_embedding float[8]
);

-- vectors can be provided as JSON or in a compact binary format
insert into vec_examples(rowid, sample_embedding)
  values
    (1, '[-0.200, 0.250, 0.341, -0.211, 0.645, 0.935, -0.316, -0.924]'),
    (2, '[0.443, -0.501, 0.355, -0.771, 0.707, -0.708, -0.185, 0.362]'),
    (3, '[0.716, -0.927, 0.134, 0.052, -0.669, 0.793, -0.634, -0.162]'),
    (4, '[-0.710, 0.330, 0.656, 0.041, -0.990, 0.726, 0.385, -0.958]');


-- KNN style query goes brrrr
select
  rowid,
  distance
from vec_examples
where sample_embedding match '[0.890, 0.544, 0.825, 0.961, 0.358, 0.0196, 0.521, 0.175]'
order by distance
limit 2;
/*
┌───────┬──────────────────┐
│ rowid │     distance     │
├───────┼──────────────────┤
│ 2     │ 2.38687372207642 │
│ 1     │ 2.38978505134583 │
└───────┴──────────────────┘
*/

Roadmap

Not currently implemented, but planned in the future (after initial beta version):

  • Approximate nearest neighbors search (IVF and HNSW)
  • Metadata filtering + custom internal partitioning
  • More vector types (float16, int16, sparse, etc.) and distance functions

Additionally, there will be pre-compiled and pre-packaged packages of sqlite-vec for the following platforms:

  • pip for Python
  • npm for Node.js / Deno / Bun
  • gem for Ruby
  • cargo for Rust
  • A single .c and .h amalgammation for C/C++
  • Go module for Golang (requires CGO)
  • Datasette and sqlite-utils plugins
  • Pre-compiled loadable extensions on Github releases

Support

Is your company interested in sponsoring sqlite-vec development? Send me an email to get more info: https://alexgarcia.xyz

About

Work-in-progress vector search SQLite extension that runs anywhere.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 72.9%
  • Python 18.5%
  • Makefile 2.6%
  • TypeScript 2.6%
  • CSS 1.8%
  • Rust 0.7%
  • Other 0.9%