ruvector-postgres 0.2.3

High-performance PostgreSQL vector database extension - pgvector drop-in replacement with 53+ SQL functions, SIMD acceleration, hyperbolic embeddings, GNN layers, and self-learning capabilities
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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154

[package]
name = "ruvector-postgres"
version = "0.2.3"
edition = "2021"
license = "MIT"
description = "High-performance PostgreSQL vector database extension - pgvector drop-in replacement with 53+ SQL functions, SIMD acceleration, hyperbolic embeddings, GNN layers, and self-learning capabilities"
repository = "https://github.com/ruvnet/ruvector"
homepage = "https://github.com/ruvnet/ruvector"
documentation = "https://docs.rs/ruvector-postgres"
authors = ["ruv.io Team <info@ruv.io>"]
keywords = ["postgresql", "vector-database", "embeddings", "pgvector", "hnsw"]
categories = ["database", "science", "algorithms"]
readme = "README.md"
exclude = ["docker/", "tests/", "benches/", "examples/"]

[lib]
crate-type = ["cdylib", "lib"]

[features]
default = ["pg16"]
pg14 = ["pgrx/pg14", "pgrx-tests/pg14"]
pg15 = ["pgrx/pg15", "pgrx-tests/pg15"]
pg16 = ["pgrx/pg16", "pgrx-tests/pg16"]
pg17 = ["pgrx/pg17", "pgrx-tests/pg17"]
pg_test = []

# SIMD features for compile-time selection
simd-native = []  # Use native CPU features (detected at build time)
simd-avx2 = []
simd-avx512 = []
simd-neon = []
simd-auto = []  # Auto-detect at runtime (default behavior)

# Index features
index-hnsw = []
index-ivfflat = []
index-all = ["index-hnsw", "index-ivfflat"]

# Quantization features
quantization-scalar = []
quantization-product = []
quantization-binary = []
quantization-all = ["quantization-scalar", "quantization-product", "quantization-binary"]
quant-all = ["quantization-all"]  # Alias for convenience

# Optional features
# Note: hybrid-search and filtered-search are planned for future releases
neon-compat = []  # Neon-specific optimizations

# Advanced AI features (opt-in)
learning = []       # Self-learning / ReasoningBank
attention = []      # 39 attention mechanisms
gnn = []            # GNN layers (GCN, GraphSAGE, GAT, GIN)
hyperbolic = []     # Hyperbolic embeddings (Poincaré, Lorentz)
sparse = []         # Sparse vectors (BM25, SPLADE)
graph = []          # Graph operations & Cypher
routing = []        # Tiny Dancer AI routing

# Feature bundles
ai-complete = ["learning", "attention", "gnn", "routing"]
graph-complete = ["hyperbolic", "sparse", "graph"]
all-features = ["ai-complete", "graph-complete"]

[dependencies]
# PostgreSQL extension framework
pgrx = "0.12"

# Pin home to avoid edition2024 issues
home = "=0.5.9"

# SIMD acceleration (leverages existing ruvector-core capabilities)
simsimd = "5.9"

# Half-precision floating point
half = { version = "2.4", features = ["std", "serde"] }

# Concurrency and synchronization
parking_lot = "0.12"
dashmap = "6.0"
crossbeam = "0.8"

# Parallel processing
rayon = "1.10"

# Serialization
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
bincode = "1.3"  # Use 1.x for Rust 1.83 compatibility
rkyv = "0.8"

# Memory management
memmap2 = "0.9"

# Random number generation (for HNSW)
rand = "0.8"
rand_chacha = "0.3"

# Bit manipulation (for binary quantization)
bitvec = "1.0"

# Ordered floats for sorting
ordered-float = "4.2"

# Heap for top-k
priority-queue = "2.0"

# Error handling
thiserror = "1.0"

# Logging
tracing = "0.1"

# Lazy static initialization
lazy_static = "1.4"
once_cell = "1.19"

# Optional: Use ruvector-core for shared implementations
# Uncomment to link with existing ruvector-core crate
# ruvector-core = { path = "../ruvector-core", optional = true }

[dev-dependencies]
pgrx-tests = "0.12"
criterion = "0.5"
proptest = "1.4"
approx = "0.5"
rand = "0.8"
tempfile = "3.10"

[[bench]]
name = "distance_bench"
harness = false

[[bench]]
name = "quantized_distance_bench"
harness = false

[[bench]]
name = "index_bench"
harness = false

[[bench]]
name = "quantization_bench"
harness = false

[[bin]]
name = "pgrx_embed_ruvector-postgres"
path = "./src/bin/pgrx_embed.rs"

[package.metadata.pgrx]
# Extension metadata for pgrx
pg14 = "pg14"
pg15 = "pg15"
pg16 = "pg16"
pg17 = "pg17"