Installation

Rust Feature Presets

Cargo features select compiled capabilities. They are additive — do not use them as mutually exclusive mode switches.

Feature	Purpose
minimal	Smallest facade; no optional deployment capabilities.
local	Default developer build: embedded + single-node.
embedded	In-process API use; no optional dependencies.
single-node	Local daemon/in-process cluster with Flight SQL, shuffle, RocksDB metadata.
distributed	Remote cluster support with Flight SQL, shuffle, etcd metadata.
k8s	Distributed + Kubernetes operator/CRD.
full	Distributed/k8s, Kafka, primary Iceberg. Excludes AI/vector and secondary lakehouse formats.

Optional Integration Features

Feature	Purpose
flight-sql	Arrow Flight SQL transport/server.
shuffle	Shuffle service/store.
etcd	etcd-backed scheduler metadata.
kafka	Kafka connector.
iceberg	Primary lakehouse platform.
delta	Optional experimental Delta compatibility.
ui	Operator UI integration.

Build Commands

just check                  # verify all four modes compile
just build-single-node      # debug binary for local dev
just build-bare-metal       # release binary for VMs
just build-k8s              # release binary + operator for Kubernetes

# GCC 15 workaround for RocksDB
CXXFLAGS="-include cstdint" just build-single-node

Python Features

Feature	Purpose
kafka	Kafka sources/connectors.
iceberg	Iceberg lakehouse bindings.
vector-sinks	Optional vector sink compatibility.
qdrant	Experimental Qdrant vector sink.
pgvector	Experimental pgvector sink.

maturin develop --manifest-path crates/krishiv-python/Cargo.toml
maturin develop --manifest-path crates/krishiv-python/Cargo.toml --features iceberg
maturin develop --manifest-path crates/krishiv-python/Cargo.toml --features kafka