Struct EmbeddingConfig 

pub struct EmbeddingConfig {
    pub model: Option<String>,
    pub dimensions: Option<usize>,
    pub auto_download: Option<bool>,
    pub deterministic: Option<bool>,
}

Semantic-embedding engine settings.

model selects which local ONNX embedding model lean-ctx downloads and uses for ctx_semantic_search. Accepts the same aliases as the LEAN_CTX_EMBEDDING_MODEL env var: minilm (all-MiniLM-L6-v2, 384d — the default), nomic (768d) — or any HuggingFace repo with an ONNX export via hf:org/repo[@revision] (GL #397), e.g. hf:jinaai/jina-embeddings-v2-base-code for code-specialized embeddings. When the env var is set it takes precedence; an unset/None value uses the default model. Switching models triggers a one-time re-index on the next semantic search (vector dimensions follow from the model).

dimensions is only consulted for hf: custom models as the declared fallback width; the real width is probed from the ONNX graph at load time. Built-ins ignore it.

Fields

model: Option<String>

dimensions: Option<usize>

auto_download: Option<bool>

Allow downloading the embedding model on first semantic need (#551). None (unset) means allowed — the soft default that activates the semantic features without manual setup. Set false for air-gapped machines. The LEAN_CTX_EMBEDDINGS_AUTO_DOWNLOAD env var, when set, overrides this in either direction.

deterministic: Option<bool>

Pin embedding inference to a single CPU thread (no GPU EP) so vectors are bit-identical across machines, not just run-to-run on one host (#895). None/false keeps the multi-threaded GPU-capable path. Extractive prose ranking is already deterministic via score quantization + stable tiebreak; this flag is the extra hardening for cross-machine reproducibility. The LEAN_CTX_EMBEDDING_DETERMINISTIC env var overrides this either way.

Trait Implementations

impl Clone for EmbeddingConfig

fn clone(&self) -> EmbeddingConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for EmbeddingConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for EmbeddingConfig

fn default() -> EmbeddingConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EmbeddingConfig

where EmbeddingConfig: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for EmbeddingConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.