Skip to content

Installation

Datum is not published to crates.io — the crate name is taken by an unrelated crate. Add it as a git dependency pointing at the v0.2.0 tag:

toml
[dependencies]
datum = { git = "https://github.com/Aethergrids/Datum", tag = "v0.2.0" }

Rust version

Datum uses Rust edition 2024. A recent stable toolchain (1.85 or later) is recommended.

Optional: cluster feature

The cluster feature enables Ractor's ractor_cluster backend for distributed actor topologies:

toml
[dependencies]
datum = { git = "https://github.com/Aethergrids/Datum", tag = "v0.2.0", features = ["cluster"] }

You do not need cluster for standard single-process stream processing.

Tokio runtime

Datum depends on Tokio. Simple synchronous streams (no map_async, no actor interop) run fully inline on the calling thread and do not require an active Tokio runtime. For async operators and actor interop, a Tokio runtime must be present.

Next steps

  • First Stream — write and run your first stream in five minutes.
  • Concepts — understand the Source / Flow / Sink model and how materialization works.