Struct MemeBuilder 

pub struct MemeBuilder { /* private fields */ }

Fluent builder for constructing a Meme instance.

All settings have sensible defaults. Only api_key is required for the default API-based embedding provider.

Examples

let meme = meme::Meme::builder()
    .api_key("sk-...")
    .model("gpt-4.1-mini")
    .namespace("user-42")
    .build()
    .await?;

Load from a TOML file and override specific fields:

let meme = meme::Meme::builder()
    .config(config)
    .api_key("override-key")
    .build()
    .await?;

Implementations

impl MemeBuilder

pub fn new() -> Self

Create a new builder with default configuration.

pub fn config(self, config: Config) -> Self

Replace the entire configuration (e.g. loaded from a TOML file).

Subsequent setter calls override individual fields on top of this.

pub fn api_key(self, key: impl Into<String>) -> Self

Set the LLM API key.

pub fn model(self, model: impl Into<String>) -> Self

Set the LLM model name (e.g. "gpt-4.1-mini").

pub fn base_url(self, url: impl Into<String>) -> Self

Set the LLM base URL (OpenAI-compatible endpoint).

pub const fn embedding_provider(self, provider: EmbeddingProviderKind) -> Self

Set the embedding provider (Api or Onnx).

pub fn embedding_model(self, model: impl Into<String>) -> Self

Set the embedding model name.

pub const fn embedding_dimension(self, dim: usize) -> Self

Set the embedding vector dimension.

pub fn embedding_api_key(self, key: impl Into<String>) -> Self

Set the embedding API key (when using a different provider than LLM).

pub fn embedding_base_url(self, url: impl Into<String>) -> Self

Set the embedding API base URL (when using a different provider than LLM).

pub fn lancedb_path(self, path: impl Into<PathBuf>) -> Self

Set the LanceDB storage directory path.

pub fn history_db_path(self, path: impl Into<PathBuf>) -> Self

Set the SQLite history database file path.

pub const fn enable_planning(self, enable: bool) -> Self

Enable or disable LLM-driven query planning.

pub const fn enable_reflection(self, enable: bool) -> Self

Enable or disable reflection-based retrieval refinement.

pub const fn semantic_top_k(self, k: usize) -> Self

Set the number of results for semantic (ANN) search.

pub fn reranker(self, model: impl Into<String>) -> Self

Enable local ONNX reranker with the given model name.

Requires the onnx feature. Example model: "BAAI/bge-reranker-v2-m3".

pub const fn rerank_top_n(self, n: usize) -> Self

Set the number of top results to keep after reranking.

pub fn http_client(self, client: Client) -> Self

Provide a pre-configured reqwest::Client.

Use this to customize timeouts, proxies, TLS certificates, or connection pooling. When omitted, a default client is created.

pub const fn clear_db(self, clear: bool) -> Self

Clear the database on initialization.

pub fn namespace(self, ns: impl Into<String>) -> Self

Set the namespace for memory isolation.

The library treats this as an opaque string — callers decide the semantics (user ID, session ID, composite key, etc.).

pub async fn build(self) -> Result<Meme>

Build the Meme instance.

Errors

Returns an error if configuration is invalid or storage cannot be initialized.

Trait Implementations

impl Clone for MemeBuilder

fn clone(&self) -> MemeBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemeBuilder

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

Formats the value using the given formatter.

impl Default for MemeBuilder

fn default() -> MemeBuilder

Returns the “default value” for a type.