# VelesDB Core v3.12.0

> The explainable, local-first memory engine for AI agents.

VelesDB is an embedded Rust memory engine that combines vector search, a native knowledge graph, structured columns, full-text and sparse retrieval, and agent-oriented memory APIs in one binary of approximately 9 MB.

## Why VelesDB

- Explainable recall: `why()` returns the evidence trail behind a retrieved memory.
- Local-first: memory can remain on-device, on-premises, or inside an air-gapped network.
- No mandatory AI calls: the engine requires no cloud model call or API key per memory write.
- One engine: semantic, episodic, and procedural memory share one persistence layer and VelesQL query language.
- Measured performance: 450µs p50 end-to-end on the published 10K/384D workload with WAL enabled and recall at or above 96%.

## Published memory-quality results

- HotpotQA: +7.2 points in the VelesDB project benchmark.
- TimeQA: +9.7 points in the VelesDB project benchmark.
- Multi-engine evaluation: up to +29 points in the project benchmark suite.

Benchmark results depend on workload, model, hardware, and methodology. Reproduction instructions and raw results are maintained in the VelesDB repositories.

## Core capabilities

- Agent Memory SDK for semantic, episodic, and procedural memories.
- `remember()`, `recall()`, `relate()`, and `why()` workflows.
- Deterministic Context Token Compiler via Rust, Python, Node.js, and MCP; overflow remains recoverable through `ctx://source/` handles.
- Bundled `velesdb-context-optimizer` and `velesdb-memory` skills for safe context compilation and durable agent-memory workflows.
- VelesQL: SQL filters plus `NEAR` vector search and `MATCH` graph traversal.
- Hybrid dense, sparse, BM25, metadata, and graph retrieval.
- PQ, SQ8, Binary, and RaBitQ quantization.
- ColumnStore analytical filters, with up to 130x project-reported acceleration.
- Rust, Python, TypeScript, server, Tauri, iOS, Android, and WASM targets.

## VelesDB Premium v0.7.0

VelesDB Premium is the Enterprise Agent Memory Platform. It adds governed memory operations, forensic replay, audited forget and admin-purge workflows, high availability with Raft, enterprise support, and self-hosted or air-gapped deployment. Admin purge erases memory content while retaining an audit skeleton; this is not advertised as cryptographic erasure.

## Installation

```bash
cargo add velesdb-core
pip install velesdb
npm install @wiscale/velesdb-sdk
```

## Important pages

- Website: https://velesdb.com/
- Documentation hub: https://velesdb.com/docs/
- Use cases: https://velesdb.com/use-cases/
- Core and Premium comparison: https://velesdb.com/pricing/
- Premium documentation: https://velesdb.com/docs/premium/
- GitHub: https://github.com/cyberlife-coder/VelesDB
- Technical documentation: https://deepwiki.com/cyberlife-coder/VelesDB/

## Licensing

VelesDB Core is source-available under the VelesDB Core License 1.0. VelesDB Premium is commercially licensed; pricing is provided on request at contact@wiscale.fr.