eloqstore — Python SDK

Python SDK for EloqStore, a high-performance hybrid-tier key-value storage engine. Combines object storage (S3) with local NVMe SSDs for exceptional write throughput and sub-millisecond read latency.

Installation

pip install eloqstore

Requires Linux kernel 6.8+ (uses io_uring).

Quick Start

from eloqstore import Client, Options

client = Client(Options(table_name="demo", partition_id=0, num_threads=1))
client.put("hello", b"world")
assert client.get("hello") == b"world"
assert client.exists("hello")
client.delete("hello")
client.close()

Disk Persistence

from eloqstore import Client, Options

client = Client(
    Options(
        store_paths=["/data/eloqstore"],
        table_name="mydb",
        partition_id=0,
        num_threads=4,
    )
)
client.put("key", b"value")
client.close()
# Data persists — reopen later with the same store_paths

INI Configuration

from eloqstore import Client, Options

client = Client(
    Options(
        store_paths=["/data/eloqstore"],
        options_path="/etc/eloqstore.ini",
        table_name="mydb",
        partition_id=0,
        branch="feature-x",
        term=7,
    )
)

API

Building from Source

cd python
python -m pip install build
python -m build --wheel
pip install dist/*.whl

If the shared library is not auto-discovered, set:

export ELOQSTORE_PY_LIB=/path/to/libeloqstore_capi.so

License

BSL 2.0 or AGPL 3.0 (dual-licensed). See LICENSE.md.