Struct Settings 

pub struct Settings {

    pub default_user_id: String,
    pub default_dataset_name: String,
    pub system_root_directory: String,
    pub data_root_directory: String,
    pub cache_root_directory: String,
    pub logs_root_directory: String,
    pub monitoring_tool: String,
    pub classification_model: String,
    pub summarization_model: String,
    pub graph_model: String,
    pub summarization_schema: Option<Value>,
    pub llm_provider: String,
    pub llm_model: String,
    pub llm_api_key: String,
    pub llm_endpoint: String,
    pub llm_api_version: String,
    pub llm_temperature: f64,
    pub llm_streaming: bool,
    pub llm_max_completion_tokens: u32,
    pub llm_max_retries: u32,
    pub llm_max_parallel_requests: u32,
    pub llm_mock: bool,
    pub llm_cassette: String,
    pub llm_record_path: String,
    pub graph_prompt_path: String,
    pub llm_fallback_model: String,
    pub llm_fallback_provider: String,
    pub llm_fallback_endpoint: String,
    pub llm_fallback_api_key: String,
    pub graph_database_provider: String,
    pub graph_database_url: String,
    pub graph_database_name: String,
    pub graph_database_username: String,
    pub graph_database_password: String,
    pub graph_database_port: u16,
    pub graph_database_host: String,
    pub graph_database_key: String,
    pub graph_file_path: String,
    pub graph_filename: String,
    pub vector_db_provider: String,
    pub vector_db_url: String,
    pub vector_db_port: u16,
    pub vector_db_name: String,
    pub vector_db_key: String,
    pub vector_db_username: String,
    pub vector_db_password: String,
    pub vector_db_host: String,
    pub chunk_strategy: String,
    pub chunk_engine: String,
    pub chunk_size: u32,
    pub chunk_overlap: u32,
    pub relational_db_url: String,
    pub migration_db_url: String,
    pub db_provider: String,
    pub db_host: String,
    pub db_port: u16,
    pub db_name: String,
    pub db_username: String,
    pub db_password: String,
    pub default_system_prompt_path: String,
    pub embedding_provider: String,
    pub embedding_model_path: String,
    pub embedding_tokenizer_path: String,
    pub embedding_model_name: String,
    pub embedding_dimensions: u32,
    pub embedding_max_sequence_length: u32,
    pub embedding_batch_size: u32,
    pub embedding_endpoint: String,
    pub embedding_api_key: String,
    pub embedding_api_version: String,
    pub transcription_model: String,
    pub ontology_file_path: String,
    pub ontology_resolver: String,
    pub ontology_matching_strategy: String,
    pub cache_backend: String,
    pub cache_host: String,
    pub cache_port: u16,
    pub cache_username: String,
    pub cache_password: String,
    pub session_ttl_seconds: u64,
    pub enable_caching: bool,
    pub auto_feedback: bool,
    pub default_user_email: String,
    pub default_user_password: String,
    pub enable_access_control: bool,
    pub log_level: String,
    pub llm_rate_limit_enabled: bool,
    pub llm_rate_limit_requests: u32,
    pub llm_rate_limit_interval: u32,
    pub embedding_rate_limit_enabled: bool,
    pub embedding_rate_limit_requests: u32,
    pub embedding_rate_limit_interval: u32,
    pub storage_backend: String,
    pub storage_bucket_name: String,
    pub cognee_tracing_enabled: bool,
    pub otel_service_name: String,
    pub otel_exporter_otlp_endpoint: String,
    pub otel_exporter_otlp_headers: String,
    pub otel_exporter_otlp_protocol: String,
    pub otel_span_processor: String,
    pub otel_traces_sampler: String,
    pub otel_traces_sampler_arg: String,
    pub enable_last_accessed: bool,
}

Fields

default_user_id: String

default_dataset_name: String

system_root_directory: String

data_root_directory: String

cache_root_directory: String

logs_root_directory: String

monitoring_tool: String

classification_model: String

summarization_model: String

graph_model: String

summarization_schema: Option<Value>

Custom JSON schema for summarization output (Python summarization_model parity). #[serde(skip)] keeps config snapshots stable.

llm_provider: String

llm_model: String

llm_api_key: String

llm_endpoint: String

llm_api_version: String

llm_temperature: f64

llm_streaming: bool

llm_max_completion_tokens: u32

llm_max_retries: u32

llm_max_parallel_requests: u32

llm_mock: bool

Select the record/replay mock LLM instead of the real provider (MOCK_LLM). Parallels MOCK_EMBEDDING. Requires the mock-llm feature.

llm_cassette: String

Cassette path for the replay mock when llm_mock is set (MOCK_LLM_CASSETTE). Empty = unset.

llm_record_path: String

When non-empty, wrap the real adapter in a recording mock that writes a cassette to this path (COGNEE_RECORD_LLM). Empty = unset.

graph_prompt_path: String

llm_fallback_model: String

Fallback LLM model name used when the primary model fails.

llm_fallback_provider: String

Fallback LLM provider (e.g. "openai", "ollama").

llm_fallback_endpoint: String

Base URL for the fallback LLM API endpoint.

llm_fallback_api_key: String

API key for the fallback LLM provider.

graph_database_provider: String

graph_database_url: String

graph_database_name: String

graph_database_username: String

graph_database_password: String

graph_database_port: u16

graph_database_host: String

graph_database_key: String

graph_file_path: String

graph_filename: String

vector_db_provider: String

vector_db_url: String

vector_db_port: u16

vector_db_name: String

vector_db_key: String

vector_db_username: String

vector_db_password: String

vector_db_host: String

chunk_strategy: String

chunk_engine: String

chunk_size: u32

chunk_overlap: u32

relational_db_url: String

migration_db_url: String

db_provider: String

Selects the relational DB backend: "sqlite" (default) or "postgres". When set to "postgres", the individual db_host/db_port/db_name/ db_username/db_password fields are used instead of relational_db_url. Mirrors the Python DB_PROVIDER environment variable.

db_host: String

db_port: u16

db_name: String

db_username: String

db_password: String

default_system_prompt_path: String

embedding_provider: String

embedding_model_path: String

embedding_tokenizer_path: String

embedding_model_name: String

embedding_dimensions: u32

embedding_max_sequence_length: u32

embedding_batch_size: u32

embedding_endpoint: String

Embedding API endpoint URL (e.g. https://api.openai.com/v1/embeddings). Maps to EMBEDDING_ENDPOINT env var.

embedding_api_key: String

Embedding API key. Maps to EMBEDDING_API_KEY env var (fallback: LLM_API_KEY).

embedding_api_version: String

Embedding API version string (e.g. for Azure OpenAI api-version).

transcription_model: String

Transcription model name (e.g. "whisper-1").

ontology_file_path: String

ontology_resolver: String

Ontology resolver backend. Currently always resolved to RdfLibOntologyResolver when ontology_file_path is set — this field is reserved for future multi-resolver support (e.g. SPARQL endpoint). Only "rdflib" is implemented.

ontology_matching_strategy: String

Fuzzy matching strategy for entity name resolution. Currently always resolved to FuzzyMatchingStrategy (Ratcliff/Obershelp gestalt) — this field is reserved for future strategy selection. Only "fuzzy" is implemented.

cache_backend: String

Session store backend: "fs", "redis", or "seaorm".

cache_host: String

cache_port: u16

cache_username: String

cache_password: String

session_ttl_seconds: u64

Session time-to-live in seconds (default: 604 800 = 7 days).

enable_caching: bool

auto_feedback: bool

default_user_email: String

default_user_password: String

enable_access_control: bool

log_level: String

llm_rate_limit_enabled: bool

llm_rate_limit_requests: u32

llm_rate_limit_interval: u32

embedding_rate_limit_enabled: bool

embedding_rate_limit_requests: u32

embedding_rate_limit_interval: u32

storage_backend: String

File storage backend: "local" or "s3".

storage_bucket_name: String

cognee_tracing_enabled: bool

otel_service_name: String

otel_exporter_otlp_endpoint: String

otel_exporter_otlp_headers: String

otel_exporter_otlp_protocol: String

OTLP transport: "grpc" (default) or "http/protobuf". Mirrors the OTEL spec env var OTEL_EXPORTER_OTLP_PROTOCOL.

otel_span_processor: String

Span processor mode: "batch" (default) or "simple". simple is synchronous-per-span and intended only for debugging or for collectors known to misbehave with batches.

otel_traces_sampler: String

Sampler name passed through to the OTEL SDK. Empty string means: do not override; let the SDK read OTEL_TRACES_SAMPLER itself (default parentbased_always_on). Recognised values follow the OTEL spec: always_on, always_off, traceidratio, parentbased_always_on, parentbased_always_off, parentbased_traceidratio.

otel_traces_sampler_arg: String

Argument for the sampler. Currently only meaningful for the traceidratio / parentbased_traceidratio samplers, which expect a 0.0–1.0 ratio. Empty string means: do not override.

enable_last_accessed: bool

Implementations

impl Settings

pub fn load_from_env() -> Self

Build Settings entirely from environment variables (and any .env file).

Equivalent to Python’s LLMConfig() / GraphConfig() instantiation: starts from defaults and overlays every env var that is set. The .env file in the current working directory (or any ancestor) is loaded automatically before env vars are read — callers do not need to call dotenv::dotenv() themselves.

pub fn overlay_from_env(&mut self)

Overlay environment variables on top of self.

Only fields whose corresponding env var is set are modified; everything else keeps its current value. The .env file is loaded first (idempotent — safe to call multiple times).

Env-var naming follows the Python SDK conventions (LLM_*, EMBEDDING_*, GRAPH_DATABASE_*, VECTOR_DB_*, DB_*, COGNEE_*). A handful of Rust-specific aliases (OPENAI_TOKEN, OPENAI_URL, OPENAI_MODEL) are accepted as fallbacks for backward compatibility with existing test setups.

pub fn resolved_relational_db_url(&self) -> String

Returns the effective relational DB connection URL.

When db_provider is "postgres", builds postgres://username:password@host:port/name from the individual db_* fields (matching Python’s DB_PROVIDER/DB_HOST/… env vars). Otherwise returns relational_db_url verbatim.

pub fn telemetry_snapshot(&self) -> Map<String, Value>

Returns the redacted property dict merged into Pipeline Run * analytics events.

Allowlist-only. Mirrors Python’s get_current_settings() shape but covers only provider/model identifiers and a few dimension/strategy fields — see docs/telemetry/03/03-settings-snapshot.md for the rationale on what is omitted (URLs, credentials, file paths).

Adding a field here is intentional — there is a snapshot test that will fail until it is acknowledged.

Trait Implementations

impl Clone for Settings

fn clone(&self) -> Settings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Settings

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

Formats the value using the given formatter.

impl Default for Settings

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Settings

where Settings: 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 Settings

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl SettingsView for Settings

Available on crate feature telemetry only.

fn tracing_enabled(&self) -> bool

Mirrors Settings.cognee_tracing_enabled.

fn service_name(&self) -> &str

Mirrors Settings.otel_service_name.

fn otlp_endpoint(&self) -> &str

Mirrors Settings.otel_exporter_otlp_endpoint.

fn otlp_headers(&self) -> &str

Mirrors Settings.otel_exporter_otlp_headers.

fn otlp_protocol(&self) -> &str

Mirrors Settings.otel_exporter_otlp_protocol.

fn span_processor(&self) -> &str

Mirrors Settings.otel_span_processor.

fn traces_sampler(&self) -> &str

Mirrors Settings.otel_traces_sampler.

fn traces_sampler_arg(&self) -> &str

Mirrors Settings.otel_traces_sampler_arg.