---
id: rocksdict
version: "0.3.29"
license: unclear
license_treatment: permissive
maintenance: aging
---

# rocksdict — Rocksdb Python Binding

License: permissive · Maintenance: aging · Downloads: 673.6K/mo

## What it is and what it does

RocksDict is a Python wrapper around RocksDB and Speedb, two high-performance embedded key-value storage engines. It exposes RocksDB as a dictionary-like interface, allowing you to store and retrieve data persistently on disk. In default mode, it accepts Python objects (int, float, bool, str, bytes, and arbitrary objects via pickle); in raw mode, it restricts keys and values to bytes for lower overhead. The package also supports advanced RocksDB features like column families, batch writes, snapshots, and options configuration.

It is designed both as a standalone persistent storage solution for Python applications and as a bridge for inspecting or interacting with RocksDB databases created by other languages (C++, Java, etc.). The library handles automatic option loading and column family detection when reopening existing databases, making it practical for cross-language workflows.

Use it for:

- Building a persistent cache or session store for a Python application without external database dependencies.
- Inspecting or reading RocksDB databases created by C++ or Java applications from Python code.
- Storing large volumes of structured data (numpy arrays, pandas DataFrames) on disk with dictionary-like access patterns.
- Implementing a high-performance embedded key-value store for data-intensive Python services.
- Prototyping or migrating from in-memory dictionaries to persistent storage with minimal code changes.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

RocksDict provides a Python interface to RocksDB and Speedb, enabling persistent key-value storage on disk with support for multiple data types including Python objects via serialization.

Yes, if you need embedded persistent key-value storage and your platform matches the available wheels (macOS, Linux, or Windows on amd64/arm64). The permissive MIT license, zero runtime dependencies, and Production/Stable status make it low-risk. However, the aging maintenance status (256 days since last release) and lack of recent activity mean you should verify ongoing compatibility with your Python version and monitor the repository for security updates.

## Install

pip install rocksdict
uv add rocksdict
poetry add rocksdict

## Installing rocksdict

Before you install: Medium install friction due to compiled wheels; prebuilt binaries available for macOS (amd64/arm64), Linux (amd64/arm64), and Windows (amd64). Package is aging—last release was 256 days ago—but carries Production/Stable classification.

License in practice: Licensed under MIT (permissive), allowing use in commercial and proprietary projects without significant restrictions.

Quickstart:

pip install rocksdict
from rocksdict import Rdict

db = Rdict("./test_dict")
db["key"] = "value"
print(db["key"])
db.close()

Requires a platform with prebuilt wheels (macOS amd64/arm64, Linux amd64/arm64, or Windows amd64); no source distribution fallback mentioned.

Verify before relying:

- Whether the package actively maintains compatibility with Python 3.13 and 3.14 (listed in classifiers but no recent release history provided).
- Performance characteristics and scalability limits for typical workloads.
- Whether PyPy support (listed in classifiers) is actively tested or merely declared.

## Package facts

- License: not declared (permissive)
- Python support: unspecified
- Install friction: medium
- Maintenance: aging
- Downloads: 673.6K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

rocksdb python binding, persistent key-value store, on-disk dictionary storage, rocksdb wrapper, key-value database python, embedded-database, rocksdb-binding, key-value-store

[View on SkillFed](https://skillfed.io/packages/rocksdict) · [View on PyPI](https://pypi.org/project/rocksdict/)