Valori Logo
Valori
VALORI KERNEL v0.1.0

Documentation

Valori is a deterministic vector database built for regulated industries. Unlike other solutions that merely claim crash recovery, Valori mathematically proves it with cryptographic hashes.

Crash Recovery: Proven, Not Claimed

Most databases verify recovery by checking if the process starts. We verify it by checking if every single bit of memory is identical to the pre-crash state.

Production Test (Koyeb)
# 1. Before crash
$ curl $VALORI_URL/v1/proof/state
# State Hash: aea3a9e17b6f220b3d7ae860005b756c759e58...
# 2. [Force kill process - simulate outage]
# SYSTEM HALTED
# 3. After recovery
$ curl $VALORI_URL/v1/proof/state
# State Hash: aea3a9e17b6f220b3d7ae860005b756c759e58...
# 4. Verify Integrity
$ diff before_crash.json after_crash.json
# (empty output) ← Bit-perfect recovery.

Valori vs. Competitors

FeatureValoriPineconeWeaviate
Crash Recovery✅ Proven (Hash)✓ Claimed✓ Claimed
Forensic Replay✅ Event Sourcing❌❌
Determinism✅ Cross-Arch (Q16.16)❌ (Float32)❌ (Float32)
Audit Compliance✅ Full TrailPartialPartial

Quick Start

1. Install

# Clone the repository
git clone https://github.com/varshith-Git/Valori-Kernel.git
cd Valori-Kernel/python
pip install .

2. Use in Python

from valori import Valori

client = Valori()
# Atomic Batch Insert
client.insert_batch([[0.1]*16, [0.2]*16])
# Search
results = client.search([0.1] * 16, k=5)

Performance

Valori uses Q16.16 Fixed-Point math. It is as fast as standard floats but strictly deterministic.

Ingestion Speed

1.24M vec/sec
⚡ Production Ready

Search Latency

0.47 ms
⚡ Real-time (SIFT1M)

Recall @ 10

99.00%
✅ State of the Art

Snapshot Load

33 ms
✅ Instant Recovery