Skip to main content

agrag.embedding.build_embedder

build_embedder(value:str | Embedder, *, tracer:Tracer | None = None) -> Embedder

Build an embedder from a model name, or return an embedder unchanged.

Parameters:

  • value (str | Embedder) – A FastEmbed model name, such as "ibm-granite/granite-embedding-small-english-r2" (the default model), or an already-constructed Embedder for full control over batching or caching. To use a sentence-transformers model, pass a SentenceTransformerEmbedder, which needs the embed-local extra.
  • tracer (Tracer | None) – Passed to the newly-built embedder. Not valid together with an already-constructed value. That instance's tracer, if any, was already fixed at its own construction.

Returns:

Raises:

  • ValueError – tracer is given together with an already-constructed value.