Struct EmbedModel 

pub struct EmbedModel { /* private fields */ }

A local embedding model backed by fastembed (ONNX Runtime).

Constructed via FastEmbedModel::from_options. The underlying fastembed::TextEmbedding is synchronous, so all calls to FastEmbedModel::embed are dispatched onto Tokio’s blocking thread pool via tokio::task::spawn_blocking.

Implementations

impl FastEmbedModel

pub fn from_options( opts: FastEmbedOptions, ) -> Result<FastEmbedModel, FastEmbedError>

Construct a new FastEmbedModel from the given options.

This is a blocking operation that may download model weights from HuggingFace on first use. Call from a context where blocking is acceptable (e.g. application startup), or wrap in tokio::task::spawn_blocking.

Errors

Returns FastEmbedError if the fastembed model fails to initialise (e.g. unknown model name, network error during download).

pub fn model_id(&self) -> &str

The model identifier (e.g. "Xenova/bge-small-en-v1.5").

pub fn dimensions(&self) -> usize

Embedding vector dimensionality for this model.

pub async fn embed( &self, texts: &[String], ) -> Result<FastEmbedResponse, FastEmbedError>

Embed one or more texts, returning one vector per input text.

The fastembed crate’s embed method is synchronous – this function dispatches the work onto Tokio’s blocking thread pool via tokio::task::spawn_blocking to avoid starving the async runtime.

Errors

Returns FastEmbedError if the underlying fastembed call fails or the blocking task panics.