llama-index-embeddings-forge

LlamaIndex embeddings for Forge — Voxell's hosted text-embedding API.

Why Forge

One API, three tiers — pick your point on the quality/cost curve:

Matryoshka (MRL) dimensions are real: truncated vectors are re-normalized, so a shorter dim is a unit-norm prefix of the full vector — smaller index, minimal quality loss. Forge logs request metadata only (model, tokens, latency) — never your text or vectors.

Install

pip install llama-index-embeddings-forge

Usage

from llama_index.embeddings.forge import ForgeEmbedding

# FORGE_API_KEY is read from the environment; or pass api_key=...
embed_model = ForgeEmbedding(model="turbo")

vector = embed_model.get_text_embedding("the quick brown fox")
query = embed_model.get_query_embedding("fast animal")
batch = embed_model.get_text_embedding_batch(["doc one", "doc two"])

As the global embed model

from llama_index.core import Settings, VectorStoreIndex, Document
from llama_index.embeddings.forge import ForgeEmbedding

Settings.embed_model = ForgeEmbedding(model="pro")
index = VectorStoreIndex.from_documents([Document(text="hello world")])

Async

vec = await embed_model.aget_text_embedding("doc")
q = await embed_model.aget_query_embedding("a search query")

Matryoshka (shorter vectors)

embed_model = ForgeEmbedding(model="turbo", dimensions=256)  # re-normalized 256-d vectors

Configuration

License

MIT © Voxell, Inc.