crash-safe
WAL · CRC32C
Cada mutación se escribe al Write-Ahead Log con checksums CRC32C antes del commit. Recovery real tras crash, corte de energía o kill del proceso.
Core Engine — VantaDB
El motor
Un query viaja por planner, rutas paralelas y fusión RRF — todo en proceso, sin saltos de red.
01
Input Query
db.search_memory(...)
db.search_memory("agent/main", query_vector=[...], top_k=5)02
Query Planner
route · plan · dispatch
Inspecciona el query. Si hay vector + texto, lanza ambas rutas en paralelo. Si solo texto, ruta BM25. Si solo vector, ruta HNSW.
03a
BM25
inverted index · phrase
Term-frequency scoring sobre UTF-8. Índice invertido derivado, reparable desde registros canónicos.
BM25TF·IDFphrase
03b
HNSW
cosine · M · ef_search
Hierarchical small-world graph. Cosine similarity, parámetros M / ef_construction / ef_search. SIMD donde aplica.
HNSWcosineSIMD
04
RRF Fusion
reciprocal rank
score = Σ 1/(k + rank)
Combina rankings léxicos y vectoriales sin necesidad de scores comparables.
05
Ranked Hits
top_k · HNSW p50 1.2ms · 99.8% Recall@10
[hit, hit, hit, ...]1.2ms p50storage backend
Fjall / RocksDB
Fjall por defecto, RocksDB como fallback. Storage backend configurable con VantaFile abstraction.
zero network
PyO3 · In-process
Stable src/sdk.rs boundary. Cero hops de red, ejecución in-process. Latencia determinista.
Engine · WAL Simulator
WAL · CRC32C · Crash RecoveryCrash it. Watch it recover.
Simulá un crash del proceso y mirá cómo el WAL con checksums CRC32C restaura el estado en milisegundos. No hay datos perdidos — solo recovery determinista.
STATUSREADY
[00:00:01]›System boot initialized
[00:00:02]›Storage engine opened at path ./agent_memory
[00:00:03]›Replaying WAL logs... 0 transactions found
[00:00:04]›Database state: READY
InfoOKRecoveryError
Probado con kill -9, power loss y SIGSEGV. CRC32C detecta corruption bit-level — recovery nunca confirma una entrada corrupta.