DreamDB Python SDK

Python bindings for the DreamDB multimodal versioned data lake — image + audio + text + embeddings + scalar metadata on content-addressed object storage, with vector and metadata filters for ML training pipelines.

Quick start

import dreamdb as vd

# Schema
schema = vd.Schema()
schema.add_image("image", mime="jpeg")
schema.add_embedding("embedding", dim=128)
schema.add_scalar_categorical("label")

# Create against any backend (file://, http(s)://, memory://)
ds = vd.Dataset.create(
    "my-dataset",
    schema,
    backend="file:///tmp/my-ds",
)

# Append a batch of samples (each a dict)
ds.append_many([
    {"image": open("cat.jpg", "rb").read(),
     "embedding": [0.1, 0.2, ...],
     "label": "cat"},
    # ...
])

# Filter::Vector + Filter::Where (And)
batches = ds.iter_vector(
    field="embedding",
    query=[0.1, 0.2, ...],
    top_k=10,
    batch_size=4,
    where_eq={"label": "cat"},
)
for batch in batches:
    images = batch["image"]      # list[bytes]
    embeds = batch["embedding"]  # list[list[float]]
    labels = batch["label"]      # list[str]

Build from source

pip install maturin
cd dreamdb-dataset-python
maturin develop --release

This produces the dreamdb package installed into the current virtualenv. Importing it gives the Schema and Dataset classes shown above.

Metadata

Release files for dreamdb 0.0.8

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for dreamdb 0.0.8
File	Interpreter	ABI	Platform	Reset
dreamdb-0.0.8-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl 4.1 MB Aug 10, 2026	CPython 3.8	abi3	Linux glibc 2.17+ x86-64	Details
dreamdb-0.0.8-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl 3.8 MB Aug 10, 2026	CPython 3.8	abi3	Linux glibc 2.17+ ARM64	Details
dreamdb-0.0.8-cp38-abi3-macosx_11_0_arm64.whl 3.6 MB Aug 10, 2026	CPython 3.8	abi3	macOS 11.0+ ARM64	Details

Total release size: 11.5 MB

Release files / dreamdb-0.0.8-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Download URL	dreamdb-0.0.8-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size	4.1 MB
Tags	CPython 3.8 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum How to use checksums	`8001c4ee3c885a90ed8f910989778f7ef6ebc865cd27059880058797d0492747`
BLAKE2b-256 checksum How to use checksums	`b59bde817ee8e43d930f123a198f92a7094c11c78b45146d6d979af7b269aeb8`
Upload date	Aug 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/dreamlake-ai/dreamdb-core
Publishing commit: github.com/dreamlake-ai/dreamdb-core/tree/9a49ca00d19212abc76b3f4db6334ceb1c3b1b77

Workflow

Publishing configuration: github.com/dreamlake-ai/dreamdb-core/blob/9a49ca00d19212abc76b3f4db6334ceb1c3b1b77/.github/workflows/publish-python.yml
Publishing logs: github.com/dreamlake-ai/dreamdb-core/actions/runs/31360847515/attempts/1

Artifact

Subject: dreamdb-0.0.8-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
SHA-256 checksum: 8001c4ee3c885a90ed8f910989778f7ef6ebc865cd27059880058797d0492747 Verifying attestations

Release files / dreamdb-0.0.8-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

Download URL	dreamdb-0.0.8-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size	3.8 MB
Tags	CPython 3.8 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum How to use checksums	`3180ef48ec9c0484776884753e0150a03dc0352caf8c8cc384dac3fb21b22619`
BLAKE2b-256 checksum How to use checksums	`797e712a7755c7c661620a8e3c8b80dce8cf8c825906da117fcc4d65002d44bc`
Upload date	Aug 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/dreamlake-ai/dreamdb-core
Publishing commit: github.com/dreamlake-ai/dreamdb-core/tree/9a49ca00d19212abc76b3f4db6334ceb1c3b1b77

Workflow

Publishing configuration: github.com/dreamlake-ai/dreamdb-core/blob/9a49ca00d19212abc76b3f4db6334ceb1c3b1b77/.github/workflows/publish-python.yml
Publishing logs: github.com/dreamlake-ai/dreamdb-core/actions/runs/31360847515/attempts/1

Artifact

Subject: dreamdb-0.0.8-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
SHA-256 checksum: 3180ef48ec9c0484776884753e0150a03dc0352caf8c8cc384dac3fb21b22619 Verifying attestations

Release files / dreamdb-0.0.8-cp38-abi3-macosx_11_0_arm64.whl

Download URL	dreamdb-0.0.8-cp38-abi3-macosx_11_0_arm64.whl
Size	3.6 MB
Tags	CPython 3.8 abi3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`4354dc6edeb4ec50856d5ed68d547d7edc0d3c49ae22a9da713772b51c6a60a1`
BLAKE2b-256 checksum How to use checksums	`a4d4ea1a0e3a17af7567c4fa6ed9dc2018b1a003d5429aa0d1f6626f49f83ab7`
Upload date	Aug 10, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/dreamlake-ai/dreamdb-core
Publishing commit: github.com/dreamlake-ai/dreamdb-core/tree/9a49ca00d19212abc76b3f4db6334ceb1c3b1b77

Workflow

Publishing configuration: github.com/dreamlake-ai/dreamdb-core/blob/9a49ca00d19212abc76b3f4db6334ceb1c3b1b77/.github/workflows/publish-python.yml
Publishing logs: github.com/dreamlake-ai/dreamdb-core/actions/runs/31360847515/attempts/1

Artifact

Subject: dreamdb-0.0.8-cp38-abi3-macosx_11_0_arm64.whl
SHA-256 checksum: 4354dc6edeb4ec50856d5ed68d547d7edc0d3c49ae22a9da713772b51c6a60a1 Verifying attestations