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

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

Total release size: 11.5 MB

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

Download URL dreamdb-0.0.7-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
d8659a618d99f15bc0c557ee8944ca5f88f9cded48438830ede6ce68e2b0ed38
BLAKE2b-256 checksum
How to use checksums
0d02e4b6c0943e2ccf27004258581d1721d89445c2c2aedf7e113b321366ba8a
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 Aug 8, 2026.

Transparency log

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

Download URL dreamdb-0.0.7-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
b2c293df861d223458e0b40a2971f5068d429d43e64e07e72a90b214443a7794
BLAKE2b-256 checksum
How to use checksums
4c391e9466a72d8914b5eabbfd0196b666ae8ace4f517f6f8fcc9b1d4a2cb873
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 Aug 8, 2026.

Transparency log

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

Download URL dreamdb-0.0.7-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
64cfa525d7cf1c45bf6607b31a1363dd61a8216b07ceae4b78319fed97e8423e
BLAKE2b-256 checksum
How to use checksums
3ed3045bb468ef4da078ace81296b1332ee936abf9f0db3c710130b537f7ea2d
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 Aug 8, 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

0.0.9

3 release files

0.0.8

3 release files

This release

0.0.7 This release

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