High Velocity Python Database

HVPDB – High Velocity Python Database

Cơ sở dữ liệu nhúng, mã hóa, tối ưu cho automation & agent

HVPDB là một embedded NoSQL database cho Python, thiết kế theo triết lý local-first, memory-first nhưng disk-safe.

Thư viện cho phép bạn lưu trữ dữ liệu trực tiếp trong ứng dụng Python mà không cần deploy server database, đồng thời vẫn đảm bảo bảo mật, tính toàn vẹn và khả năng phục hồi khi mất điện/crash.

HVPDB phù hợp cho các hệ thống:

Automation / agent / bot

Ứng dụng desktop hoặc CLI tool

Backend nhỏ – vừa cần dữ liệu local an toàn

AI tools chạy offline hoặc edge devices

Dự án không muốn phụ thuộc Redis / Mongo / PostgreSQL

---

✨ Đặc điểm nổi bật

🔐 Mã hóa mặc định (Encryption by default)

Dữ liệu được mã hóa bằng AES-256-GCM

Key sinh từ password qua Argon2id (memory-hard)

Không có plaintext trên disk

⚡ Memory-first, hiệu năng cao

Đọc dữ liệu ưu tiên từ RAM

Ghi thông qua Write-Ahead Logging (WAL) → an toàn khi crash

Tốc độ đọc/ghi rất nhanh cho workload local

📦 Embedded – không cần server

Không daemon

Không TCP port

Không config phức tạp

→ pip install hvpdb là dùng được ngay

🧠 NoSQL document-based

Lưu dữ liệu dạng Python dict

Query linh hoạt, gần với MongoDB

Có index, transaction, rollback

🧵 An toàn khi đa luồng / đa process

File locking + concurrency control

Tránh corrupt dữ liệu khi nhiều process truy cập

🛠️ CLI & Ops thân thiện

HVPShell: inspect, query, debug dữ liệu

Có thể deploy REST API khi cần (mặc định tắt)

---

📂 Cách lưu trữ

.hvp → database đơn file

.hvdb → database dạng thư mục (scale tốt hơn, dễ quản lý)

Dữ liệu luôn được ghi an toàn xuống disk, không phụ thuộc hoàn toàn vào RAM như Redis.

---

🔍 HVPDB không phải là gì

❌ Không phải big data / distributed database

❌ Không thay thế Redis cho cache realtime quy mô lớn

❌ Không dành cho workload TB-scale

---

🆚 So sánh nhanh

So với Redis:

→ Chậm hơn một nhịp, nhưng bền vững và an toàn hơn (encrypted + ACID)

So với SQLite:

→ NoSQL, document-based, mã hóa mặc định, workflow linh hoạt hơn

So với MongoDB:

→ Không cần server, không cần deploy, phù hợp local/edge

---

🎯 Phù hợp nhất cho

Bot Discord / Telegram

AI agent lưu state, memory, config

Tool nội bộ, automation script

Ứng dụng cần lưu dữ liệu nhạy cảm local

Dev muốn “database dùng liền, không config”

---

🚀 Triết lý thiết kế

> Database sinh ra để giải quyết vấn đề, không phải để phức tạp hóa hệ thống.

HVPDB tập trung vào:

Đơn giản

An toàn

Kiểm soát được

Chạy tốt trong thực tế