Struct EmbeddingsSection 

pub struct EmbeddingsSection {
    pub backend: Option<String>,
    pub url: Option<String>,
    pub base_url: Option<String>,
    pub model: Option<String>,
    pub api_key: Option<String>,
    pub api_key_env: Option<String>,
    pub api_key_file: Option<String>,
    pub dim: Option<u32>,
    pub backfill_batch: Option<u32>,
}

v0.7.x (#1146) — [embeddings] sectioned embedding-model configuration.

Wire format:

[embeddings]
backend        = "openrouter"                # ollama (default) or any
                                             # #1067 API alias /
                                             # openai-compatible (#1598)
base_url       = "https://openrouter.ai/api/v1"
model          = "google/gemini-embedding-2"
api_key_env    = "OPENROUTER_API_KEY"        # mutually exclusive with
# api_key_file = "/etc/ai-memory/keys/embed.key"   # mode 0400 enforced
dim            = 3072                        # only needed for models
                                             # outside the known-dims table
backfill_batch = 100                         # 1-10000 (env override:
                                             # AI_MEMORY_EMBED_BACKFILL_BATCH)

Fields

backend: Option<String>

Embedding backend. ollama (the default — local /api/embed wire shape) or, since #1598, any #1067 OpenAI-compatible alias (openrouter, openai, gemini, …) or the generic openai-compatible escape hatch for self-hosted endpoints (HF TEI, vLLM).

url: Option<String>

Embedding endpoint URL. Defaults to http://localhost:11434 when unset (ollama backend) or to the backend alias’s default base URL (API backends, #1598). Synonym of Self::base_url; base_url wins when both are set.

base_url: Option<String>

#1598 — embedding endpoint base URL. Synonym of Self::url (named to match [llm].base_url); when both are set, base_url wins.

model: Option<String>

Embedding model identifier. Legacy values nomic_embed_v15 (alias for nomic-embed-text-v1.5) and mini_lm_l6_v2 (alias for sentence-transformers/all-MiniLM-L6-v2) are honored at parse time.

api_key: Option<String>

#1598 — inline API-key literal. ALWAYS REJECTED at config load (mirrors [llm].api_key): config.toml is typically world-readable, so inline secrets are a credential leak. The field exists solely so the rejection is loud instead of a silent unknown-key skip. Use Self::api_key_env or Self::api_key_file.

api_key_env: Option<String>

#1598 — name of the process env var holding the embedding API key. Mutually exclusive with Self::api_key_file.

api_key_file: Option<String>

#1598 — path of a file holding the embedding API key (mode 0400 enforced, mirroring [llm].api_key_file). Mutually exclusive with Self::api_key_env.

dim: Option<u32>

#1598 — explicit vector-dim override for embedding models not in KNOWN_EMBEDDING_DIMS. Takes precedence over the table lookup; non-positive values are ignored.

backfill_batch: Option<u32>

Backfill batch size. Bounded 1..=10000; out-of-range values fall back to the compiled default (100) with a WARN. Env override: AI_MEMORY_EMBED_BACKFILL_BATCH (#38).

Trait Implementations

impl Clone for EmbeddingsSection

fn clone(&self) -> EmbeddingsSection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EmbeddingsSection

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

Formats the value using the given formatter.

impl Default for EmbeddingsSection

fn default() -> EmbeddingsSection

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for EmbeddingsSection

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for EmbeddingsSection

impl PartialEq for EmbeddingsSection

fn eq(&self, other: &EmbeddingsSection) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for EmbeddingsSection

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for EmbeddingsSection