veclite-db 1.1.1

SQLite for vectors — embedded AI memory engine
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

# VecLite

[![CI](https://github.com/rithulkamesh/veclite/actions/workflows/ci.yml/badge.svg)](https://github.com/rithulkamesh/veclite/actions/workflows/ci.yml)
[![Crates.io](https://img.shields.io/crates/v/veclite-db.svg)](https://crates.io/crates/veclite-db)
[![PyPI](https://img.shields.io/pypi/v/veclite-db.svg)](https://pypi.org/project/veclite-db/)
[![Go Reference](https://pkg.go.dev/badge/github.com/rithulkamesh/veclite/bindings/go.svg)](https://pkg.go.dev/github.com/rithulkamesh/veclite/bindings/go)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

VecLite is an embedded vector database. It runs in-process and stores data in a single file.

It provides exact and approximate nearest neighbor search, metadata filtering, and a vector-native SQL dialect. It is designed for applications that require vector search without operating a separate database server.

## Features

- Embedded architecture (no server required)
- Single-file storage
- SIMD-accelerated vector metrics (Cosine, L2, Dot Product, Manhattan)
- HNSW indexing
- SQL query layer
- Hybrid search (vector similarity combined with metadata filters)
- Cross-language support via C ABI

## Language Bindings

VecLite is written in Rust. It provides native bindings for multiple languages.

### Rust
The core database.
- Status: Stable
- Install: `cargo add veclite-db`

### Python
Native Python module using PyO3. Releases the Global Interpreter Lock (GIL) during search operations.
- Status: Stable
- Install: `pip install veclite-db`

### Go
CGO wrapper over the C ABI.
- Status: Stable
- Install: `go get github.com/rithulkamesh/veclite/bindings/go@v1.0.9`

### C / C++
Standard C header and C++ RAII wrapper.
- Status: Stable
- Install: Copy `bindings/c/veclite.h` or `bindings/cpp/veclite.hpp`.

### Zig
Zig wrapper over the C ABI.
- Status: Experimental
- Install: Import `bindings/zig/veclite.zig`.

## Example

```rust
use veclite_db::VecLite;

let mut db = VecLite::open("memory.vec").unwrap();
db.insert("doc_1", vec![0.1, 0.2, 0.3], None).unwrap();

let results = db.search(vec![0.1, 0.2, 0.3]).top_k(5).execute().unwrap();
```

## SQL Example

VecLite supports a custom SQL dialect for vector operations.

```sql
CREATE TABLE memory;
INSERT INTO memory VALUES ('doc_1', '[0.1, 0.2, 0.3]', '{"tag":"note"}');
SELECT * FROM memory WHERE metadata.tag = 'note' ORDER BY vector <-> '[0.1, 0.2, 0.3]' LIMIT 5;
```

## Installation

Use the package manager for your target language. For the CLI and HTTP server:
```bash
cargo add veclite-db
```

## Status

VecLite is under active development.

## Roadmap

- SQL execution engine completion
- Compaction and retention policies
- Node.js bindings

## License

MIT

## Star History
[![Star History Chart](https://api.star-history.com/svg?repos=rithulkamesh/veclite&type=Date)](https://star-history.com/#rithulkamesh/veclite&Date)