HVPDB – High Velocity Python Database

Embedded database, encrypted, optimized for automation & agent

HVPDB is an embedded NoSQL database for Python, designed with a local-first, memory-first philosophy but disk-safe.

The library allows you to store data directly within the Python application without needing to deploy a database server, while still ensuring security, integrity, and recovery in case of power loss/crash.

HVPDB is suitable for systems:

Automation / agent / bot

Desktop applications or CLI tools

Small to medium backends needing safe local data

AI tools running offline or on edge devices

Projects that do not want to depend on Redis / Mongo / PostgreSQL

---

✨ Key Features

🔐 Encryption by default

Data is encrypted using AES-256-GCM

Keys are generated from passwords via Argon2id (memory-hard)

No plaintext on disk

⚡ Memory-first, high performance

Data read prioritized from RAM

Writes occur through Write-Ahead Logging (WAL) → safe during crashes

Very fast read/write speeds for local workload

📦 Embedded – no server required

No daemon

No TCP port

No complex configuration

→ pip install hvpdb is ready to use

🧠 NoSQL document-based

Stores data in Python dict format

Flexible querying, similar to MongoDB

Supports indexing, transactions, rollback

🧵 Safe for multithreaded / multiprocess

File locking + concurrency control

Avoids data corruption with multiple process access

🛠️ User-friendly CLI & Ops

HVPShell: inspect, query, debug data

Can deploy REST API when needed (disabled by default)

---

📂 Storage methods

.hvp → single file database

.hvdb → directory-style database (better scalability, easier management)

Data is always safely written to disk, not fully reliant on RAM like Redis.

---

🔍 What HVPDB is not

❌ Not a big data / distributed database

❌ Not a replacement for Redis for large-scale real-time caching

❌ Not suitable for TB-scale workloads

---

🆚 Quick comparison

Compared to Redis:

→ Slower by one step, but more sustainable and safer (encrypted + ACID)

Compared to SQLite:

→ NoSQL, document-based, encryption by default, more flexible workflows

Compared to MongoDB:

→ No need for a server, no deployment required, suitable for local/edge

---

🎯 Best suited for

Discord / Telegram bots

AI agents storing state, memory, config

Internal tools, automation scripts

Applications needing to store sensitive data locally

Dev wanting a “database ready to use, no configuration”

---

🚀 Design philosophy

> Databases exist to solve problems, not to complicate systems.

HVPDB focuses on:

Simplicity

Safety

Controlled

Performing well in real-world scenarios