Home

Welcome to the omni-json-db Wiki!

omni-json-db is a high-performance, embedded database engine designed specifically for Python developers. It bridges the gap between the extreme speed of a Key-Value store and the powerful querying capabilities of a Document database.

Built for extreme throughput and thread-safety, it leverages modern serialization (json, msgpack, marshal, pickle, YAML) and advanced compression algorithms to provide a storage layer that outpaces traditional embedded databases like SQLite for JSON-heavy workloads.

Unlike traditional SQLite or NoSQL databases, omni-json-db allows you to use native Python syntax (slicing, Lambdas, Regex, Set operations) to query and manipulate data. It also features built-in "Time-Travel", state rollbacks (Undo/Redo), and extreme compression capabilities.

Core Philosophy

• Schema-LESS: Store complex, nested data without pre-defining tables.
• Server-LESS: Direct disk access without the overhead of a database server.
• SQL-LESS: Use native Python syntax, Regex, and Lambdas for data manipulation.

Installation

pip install omni-json-db

(Supported Python Versions: 3.7 - 3.14, PyPy3).

Quick Start

from omni_json_db import JDb

# Initialize the database from a file
jdb = JDb("example.jdb")

# Store data
jdb["user:1"] = {"name": "Ryan", "role": "Developer"}

# Retrieve data
user = jdb["user:1"]
print(user["name"]) # Output: Ryan

# Bulk Update
jdb += {
    "user:2": {"name": "Alice", "role": "Admin"},
    "user:3": {"name": "Bob", "role": "Developer"}
}

All standard Python dict methods work natively: keys(), values(), items(), get(), pop(), update().