Skip to main content

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.9

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.9
File Interpreter ABI Platform
dreamdb-0.0.9-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl CPython 3.8 abi3 Linux glibc 2.17+ x86-64 Details
dreamdb-0.0.9-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl CPython 3.8 abi3 Linux glibc 2.17+ ARM64 Details
dreamdb-0.0.9-cp38-abi3-macosx_11_0_arm64.whl CPython 3.8 abi3 macOS 11.0+ ARM64 Details

Total release size: 12.5 MB

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

Download URL dreamdb-0.0.9-cp38-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Size 4.4 MB
Tags CPython 3.8 Linux glibc 2.17+ x86-64 abi3
SHA-256 checksum
How to use checksums
580d270db6f333647b9cec5cfcaf003790c361bf219b0eb86175f58015b5976b
BLAKE2b-256 checksum
How to use checksums
fc603db377dcf917a2e33c4285d92115e45b53e99fe52dd5492c4e997fcd7c71
Upload date
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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 5, 2026.

Transparency log

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

Download URL dreamdb-0.0.9-cp38-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
Size 4.1 MB
Tags CPython 3.8 Linux glibc 2.17+ ARM64 abi3
SHA-256 checksum
How to use checksums
19cf307fa062b81a9fd8b6afa1cb7d3ceda9b1914eb7730497cf5c081f12d046
BLAKE2b-256 checksum
How to use checksums
ffe7eede3a94f4ec11219b2b9a799791683e10b2937dcd476c615f7d894d2dd9
Upload date
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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 5, 2026.

Transparency log

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

Download URL dreamdb-0.0.9-cp38-abi3-macosx_11_0_arm64.whl
Size 3.9 MB
Tags CPython 3.8 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
689dfc9e72cd65913b0493f1702e6e5d32f34d1ef9d589e66b00028283644bb1
BLAKE2b-256 checksum
How to use checksums
732015f765f87e45650272b575bacc487b2120ae93d5e18ee08867d23bb4bfc7
Upload date
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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 5, 2026.

Transparency log

Release history Release notifications | RSS feed

0.0.15

3 release files

0.0.14

3 release files

0.0.13

3 release files

0.0.12

3 release files

0.0.11

3 release files

This release

0.0.9 This release

3 release files

0.0.8

3 release files

0.0.7

3 release files

0.0.6

3 release files

0.0.5

3 release files

0.0.4

3 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page