ruvector 0.1.3__tar.gz → 0.1.4__tar.gz

{ruvector-0.1.3 → ruvector-0.1.4}/Cargo.lock

@@ -7524,7 +7524,7 @@ dependencies = [
  "rkyv",
  "roaring",
  "ruvector-attention",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-gnn",
  "ruvector-graph",
  "ruvector-hyperbolic-hnsw",
@@ -8643,7 +8643,7 @@ dependencies = [
  "ndarray 0.16.1",
  "rand 0.8.6",
  "rand_distr 0.4.3",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "serde",
  "serde_json",
  "thiserror 2.0.18",
@@ -9187,7 +9187,7 @@ dependencies = [
  "rayon",
  "ruvector-cognitive-container",
  "ruvector-coherence",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-mincut 2.3.1",
  "serde",
  "serde_json",
@@ -9217,7 +9217,7 @@ dependencies = [
  "rand_distr 0.4.3",
  "rayon",
  "reqwest",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "rvf-crypto",
  "rvf-types",
  "rvf-wire",
@@ -9282,7 +9282,7 @@ dependencies = [
  "predicates",
  "prettytable-rs",
  "rand 0.8.6",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-gnn",
  "ruvector-graph",
  "serde",
@@ -9315,7 +9315,7 @@ dependencies = [
  "rand_distr 0.4.3",
  "rayon",
  "ruvector-attention",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-gnn",
  "ruvector-graph",
  "serde",
@@ -9340,7 +9340,7 @@ dependencies = [
  "futures",
  "parking_lot 0.12.5",
  "rand 0.8.6",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "serde",
  "serde_json",
  "thiserror 2.0.18",
@@ -9419,7 +9419,7 @@ dependencies = [
  "criterion 0.5.1",
  "dashmap 6.2.1",
  "parking_lot 0.12.5",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "serde",
  "serde_json",
  "thiserror 2.0.18",
@@ -9469,7 +9469,7 @@ dependencies = [
  "fs4",
  "libc",
  "rustix 1.1.4",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "serde",
  "serde_json",
  "sha2 0.10.9",
@@ -9503,73 +9503,73 @@ dependencies = [
 [[package]]
 name = "ruvector-core"
 version = "2.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "45a0b56b269252bb5e2b0ef2815c4a8fbb23a92aea3fd18b589ed78fc3614318"
 dependencies = [
  "anyhow",
  "bincode 2.0.1",
  "chrono",
- "criterion 0.5.1",
  "crossbeam",
  "dashmap 6.2.1",
- "hf-hub",
  "hnsw_rs",
- "lattice-embed",
  "memmap2",
- "mockall",
  "ndarray 0.16.1",
  "once_cell",
- "ort",
  "parking_lot 0.12.5",
- "proptest",
  "rand 0.8.6",
  "rand_distr 0.4.3",
  "rayon",
  "redb",
- "reqwest",
  "rkyv",
- "ruvector-core 2.3.1",
- "ruvector-turboquant 2.3.0",
+ "ruvector-turboquant 2.3.0 (registry+https://github.com/rust-lang/crates.io-index)",
  "serde",
  "serde_json",
  "sha2 0.10.9",
  "simsimd",
- "tempfile",
  "thiserror 2.0.18",
- "tokenizers",
- "tokio",
  "tracing",
- "tracing-subscriber",
  "unicode-normalization",
  "uuid",
 ]
 
 [[package]]
 name = "ruvector-core"
-version = "2.3.1"
-source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "45a0b56b269252bb5e2b0ef2815c4a8fbb23a92aea3fd18b589ed78fc3614318"
+version = "2.4.0"
 dependencies = [
  "anyhow",
  "bincode 2.0.1",
  "chrono",
+ "criterion 0.5.1",
  "crossbeam",
  "dashmap 6.2.1",
+ "hf-hub",
  "hnsw_rs",
+ "lattice-embed",
  "memmap2",
+ "mockall",
  "ndarray 0.16.1",
  "once_cell",
+ "ort",
  "parking_lot 0.12.5",
+ "proptest",
  "rand 0.8.6",
  "rand_distr 0.4.3",
  "rayon",
  "redb",
+ "reqwest",
  "rkyv",
- "ruvector-turboquant 2.3.0 (registry+https://github.com/rust-lang/crates.io-index)",
+ "ruvector-core 2.4.0",
+ "ruvector-turboquant 2.3.0",
  "serde",
  "serde_json",
  "sha2 0.10.9",
  "simsimd",
+ "tempfile",
  "thiserror 2.0.18",
+ "tokenizers",
+ "tokio",
  "tracing",
+ "tracing-subscriber",
  "unicode-normalization",
  "uuid",
 ]
@@ -9601,7 +9601,7 @@ dependencies = [
  "pqcrypto-kyber",
  "proptest",
  "rand 0.8.6",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "serde",
  "serde_json",
  "sha2 0.10.9",
@@ -10017,7 +10017,7 @@ dependencies = [
  "chrono",
  "dashmap 6.2.1",
  "ordered-float",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "serde",
  "serde_json",
  "thiserror 2.0.18",
@@ -10079,7 +10079,7 @@ dependencies = [
  "rand 0.8.6",
  "rand_distr 0.4.3",
  "rayon",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-diskann",
  "serde",
  "serde_json",
@@ -10177,7 +10177,7 @@ dependencies = [
  "rkyv",
  "roaring",
  "ruvector-cluster",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-raft",
  "ruvector-replication",
  "serde",
@@ -10230,7 +10230,7 @@ dependencies = [
  "napi",
  "napi-build",
  "napi-derive",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-graph",
  "serde",
  "serde_json",
@@ -10291,7 +10291,7 @@ dependencies = [
  "js-sys",
  "parking_lot 0.12.5",
  "regex",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-graph",
  "serde",
  "serde-wasm-bindgen",
@@ -10316,7 +10316,7 @@ dependencies = [
  "criterion 0.5.1",
  "hailort-sys",
  "proptest",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "serde_json",
  "sha2 0.10.9",
  "tempfile",
@@ -10337,7 +10337,7 @@ dependencies = [
  "prost 0.13.5",
  "protoc-bin-vendored",
  "rcgen",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-hailo",
  "ruvector-mmwave",
  "ruvllm 2.5.0",
@@ -10572,7 +10572,7 @@ dependencies = [
  "rand 0.8.6",
  "rayon",
  "roaring",
- "ruvector-core 2.3.1 (registry+https://github.com/rust-lang/crates.io-index)",
+ "ruvector-core 2.3.1",
  "serde",
  "serde_json",
  "thiserror 2.0.18",
@@ -10595,7 +10595,7 @@ dependencies = [
  "rand 0.8.6",
  "rayon",
  "roaring",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-graph",
  "serde",
  "serde_json",
@@ -10706,7 +10706,7 @@ dependencies = [
  "napi-build",
  "napi-derive",
  "ruvector-collections",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-filter",
  "ruvector-metrics",
  "serde",
@@ -10759,13 +10759,13 @@ dependencies = [
 
 [[package]]
 name = "ruvector-py"
-version = "0.1.3"
+version = "0.1.4"
 dependencies = [
  "numpy",
  "pyo3",
  "ruvector-attention",
  "ruvector-cluster-rag",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-gnn",
  "ruvector-graph",
  "ruvector-rabitq",
@@ -10820,7 +10820,7 @@ dependencies = [
  "futures",
  "parking_lot 0.12.5",
  "rand 0.8.6",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "serde",
  "serde_json",
  "thiserror 2.0.18",
@@ -10852,7 +10852,7 @@ dependencies = [
  "futures",
  "parking_lot 0.12.5",
  "rand 0.8.6",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "serde",
  "serde_json",
  "thiserror 2.0.18",
@@ -11062,7 +11062,7 @@ dependencies = [
  "axum 0.7.9",
  "dashmap 6.2.1",
  "parking_lot 0.12.5",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "serde",
  "serde_json",
  "thiserror 2.0.18",
@@ -11081,7 +11081,7 @@ dependencies = [
  "bincode 2.0.1",
  "chrono",
  "flate2",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "serde",
  "serde_json",
  "sha2 0.10.9",
@@ -11187,7 +11187,7 @@ dependencies = [
  "rand_distr 0.4.3",
  "rayon",
  "reqwest",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-diskann",
  "ruvector-hnsw-repair",
  "ruvector-hybrid",
@@ -11471,7 +11471,7 @@ dependencies = [
  "proptest",
  "ruvector-cognitive-container",
  "ruvector-coherence",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "serde",
  "serde_json",
  "thiserror 2.0.18",
@@ -11506,7 +11506,7 @@ dependencies = [
  "parking_lot 0.12.5",
  "rand 0.8.6",
  "ruvector-collections",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-filter",
  "serde",
  "serde-wasm-bindgen",
@@ -11723,7 +11723,7 @@ dependencies = [
  "parking_lot 0.12.5",
  "rand 0.8.6",
  "regex",
- "ruvector-core 2.3.1 (registry+https://github.com/rust-lang/crates.io-index)",
+ "ruvector-core 2.3.1",
  "ruvector-sona 0.2.0",
  "serde",
  "serde_json",
@@ -11770,7 +11770,7 @@ dependencies = [
  "rayon",
  "regex",
  "ruvector-attention",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-gnn",
  "ruvector-graph",
  "ruvector-sona 0.2.1",
@@ -12268,7 +12268,7 @@ dependencies = [
  "js-sys",
  "once_cell",
  "parking_lot 0.12.5",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "rvf-runtime",
  "rvf-types",
  "serde",
@@ -12748,7 +12748,7 @@ version = "0.1.0"
 dependencies = [
  "chrono",
  "criterion 0.5.1",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-graph",
  "serde",
  "serde_json",
@@ -14312,7 +14312,7 @@ name = "train-discoveries"
 version = "0.1.0"
 dependencies = [
  "rand 0.8.6",
- "ruvector-core 2.3.1",
+ "ruvector-core 2.4.0",
  "ruvector-solver",
  "serde",
  "serde_json",

{ruvector-0.1.3 → ruvector-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ruvector
-Version: 0.1.3
+Version: 0.1.4
 Classifier: Development Status :: 3 - Alpha
 Classifier: Programming Language :: Rust
 Classifier: Programming Language :: Python :: 3
@@ -218,3 +218,18 @@ external comparator.
 
 MIT, matching the rest of the ruvector workspace (see [`LICENSE`](LICENSE)).
 
+## Python capability packages
+
+![Python portfolio](https://raw.githubusercontent.com/ruvnet/RuVector/main/docs/python-portfolio/overview.svg)
+
+The [Python portfolio](../../python/portfolio/README.md) maps the ten most downloaded RuVector npm distributions to scoped Python APIs. Version 0.1.3 adds native `KVCache` (full precision cache attention, no text generation) and `RvfStore` (trusted local RVF vector storage). Existing vector, graph, GNN, attention and SONA APIs remain available.
+
+```python
+from ruvector import KVCache
+cache = KVCache(2, max_tokens=8)
+cache.append([1.0, 0.0], [0.25, 0.75])
+assert cache.attend([1.0, 0.0]) == [0.25, 0.75]
+```
+
+Native version changes merged into main automatically build, audit, test and publish all supported wheel platforms. A failed gate blocks upload.
+

{ruvector-0.1.3 → ruvector-0.1.4}/README.md

@@ -168,3 +168,18 @@ external comparator.
 ## License
 
 MIT, matching the rest of the ruvector workspace (see [`LICENSE`](LICENSE)).
+
+## Python capability packages
+
+![Python portfolio](https://raw.githubusercontent.com/ruvnet/RuVector/main/docs/python-portfolio/overview.svg)
+
+The [Python portfolio](../../python/portfolio/README.md) maps the ten most downloaded RuVector npm distributions to scoped Python APIs. Version 0.1.3 adds native `KVCache` (full precision cache attention, no text generation) and `RvfStore` (trusted local RVF vector storage). Existing vector, graph, GNN, attention and SONA APIs remain available.
+
+```python
+from ruvector import KVCache
+cache = KVCache(2, max_tokens=8)
+cache.append([1.0, 0.0], [0.25, 0.75])
+assert cache.attend([1.0, 0.0]) == [0.25, 0.75]
+```
+
+Native version changes merged into main automatically build, audit, test and publish all supported wheel platforms. A failed gate blocks upload.

{ruvector-0.1.3 → ruvector-0.1.4}/crates/ruvector-core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "ruvector-core"
-version = "2.3.1"
+version = "2.4.0"
 edition.workspace = true
 rust-version.workspace = true
 license.workspace = true

ruvector-0.1.4/crates/ruvector-core/examples/sift_bench.rs

@@ -0,0 +1,80 @@
+//! Native HNSW benchmark on a raw f32 dump (SIFT-style): build time, then recall@10 and single-thread QPS per ef.
+//!   sift_bench BASE.f32 QUERY.f32 GT.i32 DIM [M] [EF_CONSTRUCTION]
+//!
+//! The three inputs are raw little-endian dumps, e.g. from numpy: `X.astype('float32').tofile('base.f32')`,
+//! the same for the queries, and `GT.astype('int32').tofile('gt.i32')` where `GT` holds the exact top-10 base ids per query
+//! (for example from `faiss.IndexFlatL2`). Run pinned to one core for stable numbers: `taskset -c 3 ...`.
+use ruvector_core::index::hnsw::HnswIndex;
+use ruvector_core::index::VectorIndex;
+use ruvector_core::types::{DistanceMetric, HnswConfig};
+use std::time::Instant;
+
+fn read_f32(p: &str) -> Vec<f32> {
+    std::fs::read(p)
+        .unwrap()
+        .chunks_exact(4)
+        .map(|b| f32::from_le_bytes(b.try_into().unwrap()))
+        .collect()
+}
+fn read_i32(p: &str) -> Vec<i32> {
+    std::fs::read(p)
+        .unwrap()
+        .chunks_exact(4)
+        .map(|b| i32::from_le_bytes(b.try_into().unwrap()))
+        .collect()
+}
+
+fn main() {
+    let a: Vec<String> = std::env::args().collect();
+    let dim: usize = a[4].parse().unwrap();
+    let m: usize = a.get(5).map(|s| s.parse().unwrap()).unwrap_or(16);
+    let efc: usize = a.get(6).map(|s| s.parse().unwrap()).unwrap_or(200);
+    let base = read_f32(&a[1]);
+    let q = read_f32(&a[2]);
+    let gt = read_i32(&a[3]);
+    let n = base.len() / dim;
+    let nq = q.len() / dim;
+    let cfg = HnswConfig {
+        m,
+        ef_construction: efc,
+        ef_search: 50,
+        max_elements: n + 10,
+    };
+    let mut idx = HnswIndex::new(dim, DistanceMetric::Euclidean, cfg).unwrap();
+    let t = Instant::now();
+    for i in 0..n {
+        idx.add(i.to_string(), base[i * dim..(i + 1) * dim].to_vec())
+            .unwrap();
+    }
+    println!("build_s {:.2}", t.elapsed().as_secs_f64());
+    for ef in [10usize, 20, 40, 80, 160, 320] {
+        let mut best = f64::MAX;
+        let mut hits = 0usize;
+        for pass in 0..3 {
+            let t = Instant::now();
+            let mut cnt = 0usize;
+            for qi in 0..nq {
+                let r = idx
+                    .search_with_ef(&q[qi * dim..(qi + 1) * dim], 10, ef)
+                    .unwrap();
+                if pass == 0 {
+                    for h in &r {
+                        let id: i32 = h.id.parse().unwrap();
+                        if gt[qi * 10..qi * 10 + 10].contains(&id) {
+                            cnt += 1;
+                        }
+                    }
+                }
+            }
+            best = best.min(t.elapsed().as_secs_f64());
+            if pass == 0 {
+                hits = cnt;
+            }
+        }
+        println!(
+            "ef {ef:4} recall@10 {:.4} qps {:.0}",
+            hits as f64 / (nq * 10) as f64,
+            nq as f64 / best
+        );
+    }
+}